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

Функция delete_metadata() в WordPress используется для удаления метаданных из различных типов объектов, таких как посты, пользователи, комментарии и термины. Это универсальная функция, которая позволяет работать с метаданными разных сущностей, что делает её особенно полезной в ситуациях, когда необходимо управлять метаданными нескольких типов объектов.

delete_metadata( string $meta_type, int $object_id, string $meta_key, mixed $meta_value = '', bool $delete_all = false )

• $meta_type (string): Тип объекта, к которому относятся метаданные. Может быть одним из следующих: ‘post’, ‘comment’, ‘user’, ‘term’.
• $object_id (int): ID объекта, у которого нужно удалить метаданные.
• $meta_key (string): Ключ метаданных, которые нужно удалить.
• $meta_value (mixed, необязательный): Значение метаданных, которые нужно удалить. Если указано, будет удалено только это значение. По умолчанию пустая строка, что означает удаление всех значений с указанным ключом.
• $delete_all (bool, необязательный): Если true, удаляет метаданные для всех объектов с указанным ключом. Используется только для метаданных пользователей. По умолчанию false.

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

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

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

Пример 1: Удаление метаданных поста

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

$meta_type = 'post';
$object_id = 10;
$meta_key = 'custom_meta_key';

$result = delete_metadata( $meta_type, $object_id, $meta_key );

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

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

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

$meta_type = 'user';
$object_id = 5;
$meta_key = 'user_favorite_color';
$meta_value = 'blue';

$result = delete_metadata( $meta_type, $object_id, $meta_key, $meta_value );

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

Пример 3: Удаление метаданных комментария

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

$meta_type = 'comment';
$object_id = 15;
$meta_key = 'comment_approved';

$result = delete_metadata( $meta_type, $object_id, $meta_key );

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

Пример 4: Удаление метаданных термина

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

$meta_type = 'term';
$object_id = 20;
$meta_key = 'term_meta_key';

$result = delete_metadata( $meta_type, $object_id, $meta_key );

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

Важно

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

Заключение

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