wp_set_comment_status() │ WP 1.0.0

Устанавливает статус комментария: hold, approve, spam.

После установки статуса, срабатывает хук wp_set_comment_status.

Статус устанавливается в поде comment_approved таблицы комментариев.

Возможные значения этого поля:

  • 0 - hold
  • 1 - approve
  • spam
  • trash
Основа для: wp_spam_comment()
Хуки из функции

Возвращает

true|false|WP_Error. true — удалось установить статус. false — статус установить не удалось.

Использование

wp_set_comment_status( $comment_id, $comment_status );
$comment_id(число) (обязательный)
ID комментария.
$comment_status(строка) (обязательный)

Статус комментария, который нужно установить. Может быть:

  • hold / 0
  • approve / 1
  • spam
  • trash

Примеры

0

#1 Разрешим комментарий с ID = 9, находящийся на проверке 

wp_set_comment_status( 9, '1' );

Вернем комментарий обратно на проверку:

wp_set_comment_status( 9, '0' );

Заметки

  • Global. wpdb. $wpdb WordPress database abstraction object.

Список изменений

С версии 1.0.0 Введена.

Код wp_set_comment_status() WP 6.5.2

wp-includes/comment.php 
function wp_set_comment_status( $comment_id, $comment_status, $wp_error = false ) {
	global $wpdb;

	switch ( $comment_status ) {
		case 'hold':
		case '0':
			$status = '0';
			break;
		case 'approve':
		case '1':
			$status = '1';
			add_action( 'wp_set_comment_status', 'wp_new_comment_notify_postauthor' );
			break;
		case 'spam':
			$status = 'spam';
			break;
		case 'trash':
			$status = 'trash';
			break;
		default:
			return false;
	}

	$comment_old = clone get_comment( $comment_id );

	if ( ! $wpdb->update( $wpdb->comments, array( 'comment_approved' => $status ), array( 'comment_ID' => $comment_old->comment_ID ) ) ) {
		if ( $wp_error ) {
			return new WP_Error( 'db_update_error', __( 'Could not update comment status.' ), $wpdb->last_error );
		} else {
			return false;
		}
	}

	clean_comment_cache( $comment_old->comment_ID );

	$comment = get_comment( $comment_old->comment_ID );

	/**
	 * Fires immediately after transitioning a comment's status from one to another in the database
	 * and removing the comment from the object cache, but prior to all status transition hooks.
	 *
	 * @since 1.5.0
	 *
	 * @param string $comment_id     Comment ID as a numeric string.
	 * @param string $comment_status Current comment status. Possible values include
	 *                               'hold', '0', 'approve', '1', 'spam', and 'trash'.
	 */
	do_action( 'wp_set_comment_status', $comment->comment_ID, $comment_status );

	wp_transition_comment_status( $comment_status, $comment_old->comment_approved, $comment );

	wp_update_comment_count( $comment->comment_post_ID );

	return true;
}

statuses (статус записи коммента юзера)

Комментарии