Функция get_comment_meta() в WordPress

Функция get_comment_meta() позволяет получать информацию о метаданных комментариев в WordPress. Метаданные — это дополнительные данные, хранящиеся в базе данных, которые можно использовать для улучшения функционала вашего сайта.

Что такое метаданные комментариев?

Метаданные комментариев похожи на пользовательские поля для записей. Они хранятся в таблице базы данных wp_commentmeta. Метаданные могут содержать любую информацию, связанную с комментарием, например, голосование или рейтинг.

Как использовать функцию get_comment_meta()

Синтаксис функции

get_comment_meta( $comment_id, $key = '', $single = false );

• $comment_id (int) — ID комментария, для которого вы хотите получить метаданные (обязательный параметр).
• $key (string) — ключ метаданных, которые вы хотите получить. По умолчанию возвращаются данные для всех ключей.
• $single (true|false) — если установлено в true, функция вернет одно значение (строку). Если false, вернется массив значений (это нужно, когда есть несколько метаполей с одинаковым именем).

Важно: Если в метаданной хранится число, оно будет возвращено как строка, например, '54'.

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

Пример 1: Получение значения пользовательского поля текущего комментария

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

$vote = get_comment_meta( $comment->comment_ID, 'vote', true );
echo "Голос: $vote"; // Выведет: Голос: 654

Пример 2: Получение метаданных комментария как массива

Если вы хотите получить все значения метаданных для конкретного ключа, не указывайте true в третьем аргументе:

$vote = get_comment_meta( $comment->comment_ID, 'vote' );

// Результат будет:
Array
(
    [0] => 12
)

Что касается сериализованных данных

Если оригинальные данные сериализованы, и вы передали параметр 'true', то получите массив вместо строки. Если оставите 'false', получите массив сериализованных строк.

Возвращаемые значения

Функция может вернуть различные значения:

• Если параметр $comment_id передан неверно, будет возвращено false.
• Если $single = true:
  • Вернет строку или массив, в зависимости от наличия метаполя.
• Если $single = false:
  • Вернет массив всех значений метаполя, если оно существует, или пустой массив, если метаполя нет.

Список связанных функций

Некоторые функции, которые могут быть вам полезны:

• add_comment_meta() — добавляет метаданные к комментариям.
• delete_comment_meta() — удаляет метаданные у комментариев.
• update_comment_meta() — обновляет метаданные у комментариев.

Заключение

Функция get_comment_meta() — это мощный инструмент для работы с метаданными комментариев, и её можно использовать для получения и обработки различных дополнительных данных, что позволяет сделать ваш сайт более интерактивным и удобным для пользователей.

Если у вас есть вопросы или вам нужна помощь, не стесняйтесь спрашивать!