Функция delete_user_meta() в WordPress

Функция delete_user_meta() используется для удаления метаданных пользователя в WordPress. Она позволяет удалить определенные метаданные, связанные с пользователем, по указанному ключу.

delete_user_meta( int $user_id, string $meta_key, mixed $meta_value = '' )

Параметры

• $user_id (int): ID пользователя, для которого нужно удалить метаданные.
• $meta_key (string): Ключ метаданных, которые нужно удалить.
• $meta_value (mixed, optional): (Необязательный) Значение метаданных, которые нужно удалить. Если не указано, будут удалены все метаданные с данным ключом для указанного пользователя. Если указано, будет удалена только пара ключ/значение.

Возвращаемое значение

Функция возвращает true в случае успешного удаления метаданных, и false в случае неудачи.

Примеры использования

Пример 1: Удаление всех метаданных с определенным ключом для пользователя

Допустим, у вас есть метаданные с ключом favorite_color, которые вы хотите удалить для пользователя с ID 1.

$user_id = 1;
$meta_key = 'favorite_color';

$result = delete_user_meta( $user_id, $meta_key );

if ( $result ) {
    echo 'Метаданные успешно удалены.';
} else {
    echo 'Произошла ошибка при удалении метаданных.';
}

Пример 2: Удаление метаданных с конкретным значением

Допустим, у вас есть метаданные с ключом favorite_color и значением blue, которые вы хотите удалить для пользователя с ID 1.

$user_id = 1;
$meta_key = 'favorite_color';
$meta_value = 'blue';

$result = delete_user_meta( $user_id, $meta_key, $meta_value );

if ( $result ) {
    echo 'Метаданные успешно удалены.';
} else {
    echo 'Произошла ошибка при удалении метаданных.';
}

Пример 3: Удаление метаданных в цикле для нескольких пользователей

Если нужно удалить метаданные с ключом subscription_status для нескольких пользователей, можно использовать цикл.

$user_ids = array(1, 2, 3); // Массив ID пользователей
$meta_key = 'subscription_status';

foreach ( $user_ids as $user_id ) {
    $result = delete_user_meta( $user_id, $meta_key );
    
    if ( $result ) {
        echo "Метаданные для пользователя с ID $user_id успешно удалены.<br>";
    } else {
        echo "Произошла ошибка при удалении метаданных для пользователя с ID $user_id.<br>";
    }
}

Важные замечания

• Использование с осторожностью: Функция удаляет метаданные без возможности восстановления. Перед использованием убедитесь, что вы точно хотите удалить указанные метаданные.
• Бэкап данных: Рекомендуется сделать резервную копию базы данных перед выполнением этой операции, чтобы избежать потери данных.

Заключение

Функция delete_user_meta() является мощным инструментом для удаления пользовательских метаданных в WordPress. Правильное использование этой функции может значительно упростить управление пользовательскими данными на вашем сайте.