Функция wp_spam_comment() изменяет статус комментария на «спам» в базе данных. Комментарии, помеченные как спам, не будут отображаться на сайте и будут перемещены в папку спама в административной панели.
wp_spam_comment( int $comment_id );Параметры
$comment_id(int|WP_Comment): ID или объект комментария, который нужно поместить в спам. Этот параметр является обязательным.
Возвращаемое значение
Функция возвращает true, если комментарий был успешно перемещен в спам, и false в случае неудачи.
Пример использования
Рассмотрим пример, в котором мы будем помечать комментарий как спам, основываясь на его ID:
// Предположим, что у вас есть ID комментария, который вы хотите пометить как спам.
$comment_id = 123;
// Помечаем комментарий как спам
wp_spam_comment( $comment_id );
// Выводим сообщение о том, что комментарий был успешно помечен как спам
echo 'Комментарий с ID ' . $comment_id . ' был помечен как спам.';
Хуки
spam_comment: Действие выполняется до изменения статуса комментария на спам.spammed_comment: Действие выполняется после изменения статуса комментария на спам.
Примечания
- Чтобы использовать эту функцию, пользователь должен иметь соответствующие права. Обычно, доступ к этой функции имеют только администраторы или редакторы.
- Функция не выполняет никаких проверок на существование комментария, поэтому важно убедиться, что предоставленный ID является допустимым и существует в базе данных.
- Помеченные как спам комментарии могут быть восстановлены или удалены через административную панель WordPress.
- Функция
wp_spam_comment()работает на основе функцииwp_set_comment_status().