update_comment_meta() │ WP 2.9.0

Обновляет или добавляет метаданные для указанного комментария.

Функция может быть использована вместо add_comment_meta() - добавляет метаданные комментария.

Функция сначала проверяет существует ли указанный ключ дополнительного поля, если не существует то поле создается новое, если существует, то поле обновляется.

Метаданные комментария хранятся в таблице wp_commentmeta.

Работает на основе: update_metadata()

Хуков нет.

Возвращает

int|true|false. Зависит от результата операции.

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

update_comment_meta( $comment_id, $meta_key, $meta_value, $prev_value );

$comment_id(число) (обязательный): ID комментария, дополнительные данные которого нужно изменить.
$meta_key(строка) (обязательный): Ключ поля, которое нужно изменить.
$meta_value(строка) (обязательный): Новое значение ключа.
$prev_value(строка): Старое значение ключа (под одним ключом может быть несколько значений, поэтому в некоторых случаях нужно указать какое именно значение нужно обновить).
По умолчанию: ''

Примеры

#1 Обновим метаданные комментария 3416:

update_comment_meta( 3416, 'my_key', 'Brad' );

Теперь чтобы получить метаданные комментария используйте функцию get_comment_meta():

$my_key = get_comment_meta( 3416, 'my_key', true );

echo my_key;

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

С версии 2.9.0

Введена.

Код `update_comment_meta() update comment meta` ^{WP 6.5.2}

wp-includes/comment.php

function update_comment_meta( $comment_id, $meta_key, $meta_value, $prev_value = '' ) {
	return update_metadata( 'comment', $comment_id, $meta_key, $meta_value, $prev_value );
}