Описание функции get_comments()
Функция get_comments() возвращает список комментариев для заданного поста или для всего сайта с возможностью фильтрации и сортировки. Она полезна для получения комментариев по различным критериям, таким как пост, статус, дата и другие параметры.
Результаты возвращаются в виде массива объектов WP_Comment, что обеспечивает удобный доступ к свойствам комментариев, таким как содержание, автор, дата и статус.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для получения комментариев
Возможные значения:
post_id: ID поста, для которого нужно получить комментарии
status: approve, pending, spam, trash
number: Количество комментариев для получения
orderby: comment_date, comment_author, comment_ID
order: ASC, DESC
meta_key: Ключ пользовательского поля для фильтрации
meta_value: Значение пользовательского поля для фильтрации
Возвращаемое значение
Тип: array
Описание: Массив объектов WP_Comment, представляющих комментарии
Возможные значения:
• Массив объектов WP_Comment при успешном выполнении
• Пустой массив если комментарии не найдены
• WP_Error в случае ошибки
Примеры использования
Базовый пример получения всех комментариев к посту с ID 1
$comments = get_comments(array('post_id' => 1));
foreach($comments as $comment) {
echo $comment->comment_content.'<br>';
}
Выводит содержимое каждого комментария
Получение только одобренных комментариев к посту с ID 1
$args = array(
'post_id' => 1,
'status' => 'approve'
);
$comments = get_comments($args);
Фильтрация по статусу комментария
Безопасность
Валидация входных данных: Все параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для содержания комментариев
— Связанные функции
Выводит список комментариев в виде HTML
Получает один комментарий по ID
— Хуки
Фильтрует аргументы перед запросом комментариев
Фильтрует результаты после получения комментариев
— Примечания
– Ограничения
Возвращает только публичные комментарии по умолчанию
– Частые проблемы
- Пустой результат при неправильных параметрах
- Проблемы с фильтрацией по статусу, если комментарии отсутствуют
