comments_number()
Выводит на экран количество комментариев записи (поста). Уведомления и пинги включаются в подсчет. Для использования внутри Цикла WordPress.
Используйте get_comments_number(), когда нужно получить само число, а не готовую надпись.
Работает на основе: get_comments_number_text()
Основа для: comments_popup_link()
1 раз — 0.000071 сек (очень быстро) | 50000 раз — 1.61 сек (быстро)
Хуков нет.
Возвращает
null. Выводит текст на экран.
Использование
<?php comments_number( $zero, $one, $more, $post_id ); ?>
- $zero(строка)
- Текст, который будет показан, если комментариев нет.
По умолчанию: 'Комментариев нет' - $one(строка)
- Текст, который будет показан, если всего 1 комментарий.
По умолчанию: '1 комментарий' - $more(строка)
- Текст, который будет показан, если комментариев больше чем 1.
По умолчанию: '% комментариев' - $post_id(число/WP_Post)
- ID или объект поста, кол-во комментов которого нужно получить.
По умолчанию: 0 (global $post)
Примеры
#1 Количество комментариев статьи
Выведем количество комментариев статьи и укажем какой текст писать, при определенном количестве комментариев.
<p> У этого поста <?php comments_number( 'пока нет комментариев', '1 комментарий', '% комментариев'); ?>. </p>
#2 ссылка на комментарии
Выведем для каждого анонса поста на странице категорий ссылку на комментарии, где анкором ссылки будет количество комментариев поста:
<a href="<?php the_permalink() ?>#comments">
<?php comments_number('нет комментариев', '1 комментарий', '% комментариев'); ?>
</a>
Список изменений
| С версии 0.71 | Введена. |
| С версии 5.4.0 | The $deprecated parameter was changed to $post. |
Код comments_number() comments number WP 6.8
function comments_number( $zero = false, $one = false, $more = false, $post = 0 ) {
echo get_comments_number_text( $zero, $one, $more, $post );
}