Функция update_comment_meta() в WordPress: Руководство с примерами

В WordPress функция update_comment_meta() используется для обновления метаданных комментариев. Метаданные комментариев позволяют сохранять дополнительную информацию о комментариях, которая не включена в стандартные поля. Это может быть полезно, например, для хранения оценок, тегов или любых других пользовательских данных.

update_comment_meta( int $comment_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' )

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

Примеры использования update_comment_meta()

Пример 1: Обновление оценки комментария

$comment_id = 123; // ID комментария
$rating = 4.5; // Новая оценка для комментария
$update_result = update_comment_meta( $comment_id, 'rating', $rating );
if ( $update_result ) {
    echo 'Оценка комментария успешно обновлена.';
} else {
    echo 'Не удалось обновить оценку комментария.';
}

В этом примере функция update_comment_meta() используется для сохранения оценки (4.5) для комментария с ID 123. Если обновление прошло успешно, будет выведено «Оценка комментария успешно обновлена.» в противном случае «Не удалось обновить оценку комментария.».

Пример 2: Добавление тегов к комментарию

$comment_id = 456; // ID комментария
$tags = array( 'WordPress', 'Plugin', 'Development' ); // Новые теги для комментария
foreach ( $tags as $tag ) {
    add_comment_meta( $comment_id, 'tags', $tag, false );
}

Этот пример показывает, как можно добавлять несколько тегов к комментарию с помощью функции add_comment_meta(). Каждый тег добавляется в метаданные комментария под ключом ‘tags’.

Замечания

• Функция update_comment_meta() возвращает true, если метаданные были успешно обновлены, и false, если не было обновлений или произошла ошибка.
• При использовании update_comment_meta() без $prev_value, метаданные будут просто добавлены или обновлены.
• Для удаления метаданных комментария следует использовать функцию delete_comment_meta().

Заключение

Функция update_comment_meta() — мощный инструмент для управления пользовательскими данными в комментариях WordPress. Правильное использование этой функции позволяет расширить функциональность комментариев, сохраняя при этом структуру данных WordPress.