Функция add_comment_meta() в WordPress: Обзор и Примеры

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()?

1. Дополнительная информация: Позволяет добавлять пользовательские данные к комментариям, такие как рейтинг, пользовательские поля и метаданные.
2. Гибкость: Помогает улучшить функциональность тем и плагинов, добавляя кастомные возможности и функции для комментариев.
3. Управление комментариями: Используется для управления комментариями и добавления дополнительной информации для модерации.

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

Добавление рейтинга к комментарию

Добавим рейтинг к определенному комментарию с использованием 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() помогает создавать более функциональные и гибкие темы и плагины, улучшая управление комментариями и пользовательский опыт на сайте.