Функция wp_count_comments()
позволяет получить данные о количестве комментариев на сайте или отдельно для указанного поста. Она возвращает объект с числом комментариев, отсортированным по статусам, таким как утвержденные, ожидающие модерации, спам, удаленные комментарии и т.д.
wp_count_comments( int $post_id = 0 )
Эта функция полезна для получения статистики комментариев, будь то для всего сайта или для определенной записи. Например, можно узнать, сколько комментариев одобрено, сколько находится на модерации, сколько отмечено как спам или перемещено в корзину.
Параметры
- $post_id (int) (необязательный) — ID записи, для которой нужно получить данные о комментариях. По умолчанию
0
, что означает подсчет комментариев для всего сайта.
Возвращаемое значение
- Возвращает объект типа
stdClass
с ключами:- approved — количество утвержденных комментариев.
- moderated — количество комментариев, ожидающих модерации.
- spam — количество спам-комментариев.
- trash — количество удаленных комментариев.
- post-trashed — количество комментариев к удаленным записям.
- total_comments — общее количество комментариев без учета спама и удаленных комментариев.
Пример использования
1. Получение количества комментариев для всего сайта:
$comments_count = wp_count_comments();
echo "Статистика комментариев сайта:<br>";
echo "На модерации: " . $comments_count->moderated . "<br>";
echo "Утвержденные: " . $comments_count->approved . "<br>";
echo "Спам: " . $comments_count->spam . "<br>";
echo "В корзине: " . $comments_count->trash . "<br>";
echo "Всего комментариев: " . $comments_count->total_comments . "<br>";
Результат:
Статистика комментариев сайта:
На модерации: 0
Утвержденные: 4973
Спам: 223
В корзине: 4
Всего комментариев: 4975
2. Получение статистики комментариев для конкретного поста:
$post_id = 140;
$comments_count = wp_count_comments( $post_id );
echo "Статистика комментариев для поста $post_id:<br>";
echo "На модерации: " . $comments_count->moderated . "<br>";
echo "Утвержденные: " . $comments_count->approved . "<br>";
echo "Спам: " . $comments_count->spam . "<br>";
echo "В корзине: " . $comments_count->trash . "<br>";
echo "Всего комментариев: " . $comments_count->total_comments . "<br>";
Результат:
Статистика комментариев для поста 140:
На модерации: 0
Утвержденные: 49
Спам: 0
В корзине: 0
Всего комментариев: 49
Заключение
Функция wp_count_comments()
— это инструмент для получения статистики комментариев на вашем сайте WordPress. Она может быть полезна для отображения статистики как в административной панели, так и на фронтенде, предоставляя информацию о состоянии комментариев с разбивкой по статусам.