Описание функции wp_count_comments()
Функция wp_count_comments() возвращает количество комментариев для заданной записи. Она полезна для отображения общего числа комментариев, а также статистики по одобренным, ожидающим и отклоненным комментариям. Функция может использоваться в шаблонах и плагинах для отображения информации о комментариях к записям.
Результат представляет собой объект, содержащий количество комментариев в различных состояниях.
Параметры
$post_id
Тип: int
Обязательный: Да
Описание: ID записи, для которой необходимо подсчитать комментарии
Возможные значения:
Возвращаемое значение
Тип: object
Описание: Объект с количеством комментариев в различных состояниях
Возможные значения:
• Объект с количеством всех комментариев, одобренных, ожидающих и отклоненных
• null если запись не найдена
Примеры использования
Базовый пример подсчета комментариев для записи с ID 1
$comments_count = wp_count_comments(1);
echo 'Всего комментариев: ' . $comments_count->total_comments;
Всего комментариев: 10
Подсчет комментариев для записи с ID 42 и обработка случая, когда запись не найдена
$comments_count = wp_count_comments(42);
if ($comments_count) {
echo 'Одобренные: ' . $comments_count->approved;
} else {
echo 'Запись не найдена';
}
Одобренные: 5
Безопасность
Валидация входных данных: ID записи проходит валидацию в функции
Санитизация: Параметры очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для предотвращения XSS
— Связанные функции
Получает массив комментариев для записи
Вставляет новый комментарий
— Примечания
– Ограничения
Функция возвращает данные только для существующих записей
– Частые проблемы
- Возвращает null, если запись не найдена
- Некорректный ID может привести к ошибкам
