add_comment_meta() — это функция в WordPress, которая добавляет новое метаполе к указанному комментарию. Метаполя комментариев используются для хранения дополнительной информации о комментариях, такой как рейтинг, пользовательские данные и т.д.
add_comment_meta( $comment_id, $meta_key, $meta_value, $unique )- $comment_id (int): ID комментария, к которому добавляется метаполе.
- $meta_key (string): Уникальный ключ метаполя.
- $meta_value (mixed): Значение метаполя.
- $unique (bool, необязательный): Опциональный параметр, указывающий, следует ли предотвращать добавление дублирующихся значений. По умолчанию
false.
Зачем использовать add_comment_meta()?
- Дополнительная информация: Позволяет добавлять пользовательские данные к комментариям, такие как рейтинг, пользовательские поля и метаданные.
- Гибкость: Помогает улучшить функциональность тем и плагинов, добавляя кастомные возможности и функции для комментариев.
- Управление комментариями: Используется для управления комментариями и добавления дополнительной информации для модерации.
Примеры использования
Добавление рейтинга к комментарию
Добавим рейтинг к определенному комментарию с использованием add_comment_meta().
$comment_id = 123;
$rating = 5; // Рейтинг от 1 до 5
add_comment_meta( $comment_id, 'rating', $rating );В этом примере мы добавляем рейтинг 5 к комментарию с ID 123.
Предотвращение дублирования значений
Добавим метаполе с предотвращением дублирования значений.
$comment_id = 789;
$meta_key = 'flagged';
$meta_value = 'spam';
// Убедимся, что значение 'spam' не будет добавлено, если оно уже существует
add_comment_meta( $comment_id, $meta_key, $meta_value, true );Если метаполе ‘flagged’ уже имеет значение ‘spam’ у комментария с ID 789, оно не будет добавлено второй раз благодаря использованию параметра $unique со значением true.
Использование в темах и плагинах
Функция add_comment_meta() часто используется в разработке тем и плагинов для добавления и хранения дополнительной информации о комментариях, что делает её мощным инструментом для расширения функциональности WordPress.
Сохранение метаданных комментария из формы
Рассмотрим пример, когда данные добавляются из формы в плагине или теме:
function save_custom_comment_meta( $comment_id ) {
if ( isset( $_POST['custom_field'] ) ) {
$custom_field_value = sanitize_text_field( $_POST['custom_field'] );
add_comment_meta( $comment_id, 'custom_field_key', $custom_field_value );
}
}
add_action( 'comment_post', 'save_custom_comment_meta' );Этот код сохраняет данные, отправленные из формы комментария, в качестве кастомного поля у нового комментария.
Заключение
Функция add_comment_meta() предоставляет разработчикам WordPress мощный инструмент для добавления и хранения дополнительной информации о комментариях. Правильное использование add_comment_meta() помогает создавать более функциональные и гибкие темы и плагины, улучшая управление комментариями и пользовательский опыт на сайте.
