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

Функция WP_DELETE_COMMENT() позволяет удалить или переместить комментарий в корзину. Комментарий будет перемеще�� в корзину, если корзина активна, или удален полностью, если это указано в параметрах.

Параметры

• $comment_id (int|WP_Comment) (обязательный): ID комментария или объект WP_Comment.
• $force_delete (true|false): Опция, указывающая на то, нужно ли удалить комментарий без перемещения в корзину.
  По умолчанию: false

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

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

Применение

Чтобы использовать функцию, введите следующее:

wp_delete_comment( $comment_id, $force_delete );

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

Пример 1: Удаление комментария

Этот код удалит комментарий с ID 457 и выведет сообщение "Комментарий 457 удален!", если удаление прошло успешно:

$id = 457;
$done = wp_delete_comment( $id, true ); // пропустить корзину

if ( $done ) {
echo "Комментарий {$id} удален!";
}

Пример 2: Перемещение комментария в корзину

Этот код переместит комментарий с ID 457 в корзину (при условии, что корзина активна):

$id = 457;
$done = wp_delete_comment( $id );

if ( $done ) {
echo "Комментарий {$id} перемещен в корзину!";
}

Что происходит при удалении?

1. Проверка существования комментария: Функция проверяет, существует ли комментарий с указанным ID.
2. Перемещение в корзину: Если комментарий не требуется удалять полностью и корзина активна, он будет перемещен в корзину.
3. Удаление метаданных: Все данные, связанные с комментарием, также будут удалены.
4. Обновление счетчика: Если комментарий был одобрен, то будет обновлен счетчик комментариев для соответствующего поста.

Важные действия

Во время выполнения функции срабатывают несколько хуков, которые могут использоваться для выполнения дополнительных действий:

• delete_comment — вызывается перед удалением комментария.
• deleted_comment — вызывается после удаления комментария.
• wp_set_comment_status — используется для изменения статуса комментария.

Замечания

• Используйте глобальный объект $wpdb для работы с базой данных.
• Важно следить за тем, чтобы ID комментария был корректным, иначе функция не сработает.

Функция была представлена в WordPress с версии 2.0.0 и используется по сей день.

Теперь, благодаря этой функции, вы можете удобно управлять комментариями на вашем сайте WordPress, удаляя или перемещая их в корзину в зависимости от ваших нужд.