функция
since 2.9.0
update_comment_meta()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
update_comment_meta( int $comment_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' ): int|boolОписание
Используйте параметр $prev_value, чтобы различать поля метаданных с одинаковым ключом и идентификатором комментария.
Если поле метаданных для комментария не существует, оно будет добавлено.
По историческим причинам ожидается, что при вводе как ключ метаданных, так и значение метаданных будут «экранированы обратными слэшами».
Оригинал (английский)
Use the $prev_value parameter to differentiate between meta fields with the same key and comment ID.
If the meta field for the comment does not exist, it will be added.
For historical reasons both the meta key and the meta value are expected to be “slashed” (slashes escaped) on input.
Параметры
$comment_id
int
обязательный
Идентификатор комментария.
$meta_key
string
обязательный
Ключ метаданных.
$meta_value
mixed
обязательный
Значение метаданных. Должно быть сериализуемым, если не является скалярным значением.
$prev_value
mixed
необязательный
= ''
Предыдущее значение для проверки перед обновлением.
Если указано, обновляются только существующие записи метаданных с этим значением. В противном случае обновляются все записи.
Возвращаемое значение
int|bool
Исходный код
wp-includes/comment.php:566
function update_comment_meta( $comment_id, $meta_key, $meta_value, $prev_value = '' ) {
return update_metadata( 'comment', $comment_id, $meta_key, $meta_value, $prev_value );
}История изменений
| Версия | Описание |
|---|---|
| 2.9.0 | Introduced. |
