Описание функции wp_transition_comment_status()
Функция wp_transition_comment_status() используется для обработки изменений статуса комментария в WordPress. Она срабатывает, когда статус комментария изменяется, позволяя выполнять дополнительные действия или модификации при каждом изменении, например, уведомление пользователей или обновление данных. Это важная функция для расширений и плагинов, которые взаимодействуют с комментариями.
Функция предоставляет возможность добавления своей логики в процесс изменения статуса комментария
Параметры
$new_status
Тип: string
Обязательный: Да
Описание: Новый статус комментария
Возможные значения:
0: hold
1: approve
2: spam
3: trash
$old_status
Тип: string
Обязательный: Да
Описание: Старый статус комментария
Возможные значения:
0: hold
1: approve
2: spam
3: trash
$comment
Тип: WP_Comment
Обязательный: Да
Описание: Объект комментария, статус которого изменяется
Возможные значения:
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
• Нет возвращаемого значения
• В случае ошибок могут быть выброшены исключения
Примеры использования
Базовый пример обработки изменения статуса комментария
add_action('transition_comment_status', 'my_transition_comment_status', 10, 3);
function my_transition_comment_status($new_status, $old_status, $comment) {
if ($new_status === 'approve') {
// Код для обработки одобренного комментария
}
}
Добавляет действие при смене статуса на одобренный
Уведомляет пользователя при одобрении комментария
add_action('transition_comment_status', 'notify_user_on_comment_status_change', 10, 3);
function notify_user_on_comment_status_change($new_status, $old_status, $comment) {
if ($new_status === 'approve' && $old_status !== 'approve') {
// Код для уведомления пользователя
}
}
Проверяет, что комментарий стал одобренным
Безопасность
Валидация входных данных: Проверьте входные значения на соответствие разрешенным статусам
Санитизация: Данные очищаются при обработке, но рекомендовано дополнительно проверять
Рекомендации: Необходимо использовать соответствующие функции для работы с комментариями
— Связанные функции
Обновляет данные комментария, включая статус
Вставляет новый комментарий в базу данных
— Примечания
– Ограничения
Функция может не обрабатывать статусы, которые не предусмотрены в WordPress
– Частые проблемы
- Некорректное использование хуков может привести к ошибкам
- Отсутствие проверки статусов может вызвать нежелательные действия
