Викликає спеціальні хуки, коли статус коментаря змінюється з одного на інший: наприклад, з unapproved на approved .
Ця функція не змінює статус коментаря, а лише викликає 3 хуки. Функція викликається з інших функцій, після того, як статус коментаря було змінено, щоб повідомити плагіни, теми та функції ядра про зміну статусу коментаря.
Для реальної зміни статусу коментаря, використовуйте функції wp_update_comment() з неї, зокрема, і викликається ця функція.
Функція викличе 2 наступні хуки, якщо статус оновлюваного коментаря відрізняється від його минулого статусу:
// Спрацьовує щоразу коли змінюється статус
do_action( 'transition_comment_status', $new_status, $old_status, $comment);
// спрацьовує коли вказаний статус змінюється на вказаний
do_action( "comment_{$old_status}_to_{$new_status}", $comment );
І третій хук спрацьовує завжди, коли функція викликається:
add_action( 'comment_unapproved_to_approved', 'approve_comment_callback' );
function approve_comment_callback( $comment ){
// комент змінив статус з несхваленого на схвалений
// робимо тут що-небудь
// Наприклад, відправляємо лист кудись
// wp_mail ($ comment-> comment_author_email, $ subject, $ notification);
}
function wp_transition_comment_status( $new_status, $old_status, $comment ) { /* * Translate raw statuses до human-readable formats for the hooks. * Це не є повним листом коментарів статуї, це тільки ones * that need to be renamed. */ $comment_statuses = array( 0 => 'unapproved', 'hold' => 'unapproved', // wp_set_comment_status() uses "hold". 1 => 'approved', 'approve' => 'approved', // wp_set_comment_status() uses "approve". ); if ( isset ( $ comment_statuses [ $ new_status ] ) ) { $new_status = $comment_statuses[$new_status]; } if ( isset ( $ comment_statuses [ $ old_status ] ) ) ) { $old_status = $comment_statuses[$old_status]; } // Call the hooks. if ( $new_status != $old_status ) { /** * Fires when the comment status is in transition. * * @ Since 2.7.0 * * @param int|string $new_status Новий коментар status. * @param int|string $old_status old comment status. * @param WP_Comment $comment Comment object. */ do_action( 'transition_comment_status', $new_status, $old_status, $comment); /** * Fires when the comment status is in transition from one specific status to another. * * The dynamic portions of hook name, `$old_status`, and `$new_status`, * refer to the old and new comment statuses, respectively. * * Possible hook names include: * * - `comment_unapproved_to_approved` * - `comment_spam_to_approved` * - `comment_approved_to_unapproved` * - `comment_spam_to_unapproved` * - `comment_unapproved_to_spam` * - `comment_approved_to_spam` * * @ Since 2.7.0 * * @param WP_Comment $comment Comment object. */ do_action( "comment_{$old_status}_to_{$new_status}", $comment ); } /** * Fires when the status of a specific comment typ is in transition. * * The dynamic portions of hook name, `$new_status`, and `$comment->comment_type`, * refer to the new comment status, і the typ comment, respectively. * * Typical comment types include 'comment', 'pingback', або 'trackback'. * * Possible hook names include: * * - `comment_approved_comment` * - `comment_approved_pingback` * - `comment_approved_trackback` * - `comment_unapproved_comment` * - `comment_unapproved_pingback` * - `comment_unapproved_trackback` * - `comment_spam_comment` * - `comment_spam_pingback` * - `comment_spam_trackback` * * @ Since 2.7.0 * * @param string $comment_ID Коментарі ID як numeric string. * @param WP_Comment $comment Comment object. */ do_action( "comment_{$new_status}_{$comment->comment_type}", $comment->comment_ID, $comment ); }
