comments_number()
Виводить на екран кількість коментарів запису (пост). Повідомлення та пінги включаються до підрахунку. Для використання всередині циклу WordPress.
Використовуйте get_comments_number() , коли потрібно одержати саме число, а не готовий напис.
Працює на основі:
get_comments_number_text()
get_comments_number_text()
Хуків немає.
Повертає
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 | $deprecated parameter changed to $post_id . |
Код comments_number() comments number WP 6.0.2
function comments_number( $zero = false, $one = false, $more = false, $post_id = 0 ) {
echo get_comments_number_text( $zero, $one, $more, $post_id );
}