Функция COMMENTS_NUMBER() | WP 0.71

Эта функция отображает текст с количеством комментариев для текущей записи.

Использует

Функция get_comments_number_text()

Применяется в

Функция comments_popup_link()

Производительность

• 1 раз — 0.000071 сек (очень быстро)
• 50000 раз — 1.61 сек (быстро)

Хуки

Нет хуков.

Возвращаемое значение

Функция возвращает null, то есть ничего не выводит (пустое значение).

Использование

comments_number( $zero, $one, $more, $post );

• $zero (string|false) — текст для случая, когда комментариев нет. По умолчанию: false
• $one (string|false) — текст для одного комментария. По умолчанию: false
• $more (string|false) — текст для случая, когда комментариев больше одного. По умолчанию: false
• $post (int|WP_Post) — ID записи или объект WP_Post. По умолчанию: глобальная переменная $post

Примеры

Пример 1: Количество комментариев к посту

Мы можем вывести количество комментариев к статье и указать, какой текст показывать в зависимости от количества комментариев.

Если комментариев нет — будет написано «нет комментариев»; если один — «один комментарий»; если больше одного (например, 42) — покажет «42 комментария».

    Эта статья имеет .

Пример 2: Ссылка на комментарии

Можно вывести ссылку на комментарии для каждой записи на странице категории. Текст ссылки будет показывать количество комментариев.

Пример 3: Заголовок для секции комментариев

Вы можете добавить заголовок над секцией комментариев, который будет включать количество комментариев. Вот как это сделать и перевести текст.

Пример 4: Использование фильтра COMMENTS_NUMBER

add_filter( 'comments_number', 'wporg_com_num', 10, 2 );

function wporg_com_num ( $out, $num ) { 
    if ( 0 === $num ) { 
        $out = '0 комментариев';
    } elseif ( 1 === $num ) {
        $out = '1 комментарий'; 
    } else {
        $out = "{$num} комментариев";
    }

    return $out;
}

Функцию _n() можно использовать для упрощения определения выше до одной строки:

return _n( '1 комментарий', "{$num} комментариев", $num );

Изменения в функции

С момента появления в версии 0.71:

• С версии 5.4.0 параметр $deprecated был изменён на $post.

Код функции COMMENTS_NUMBER

function comments_number( $zero = false, $one = false, $more = false, $post = 0 ) {
    echo get_comments_number_text( $zero, $one, $more, $post );
}

Связанные функции

• comment_author()
• comment_author_email()
• comment_author_link()
• comment_author_url()
• comment_author_url_link()
• comment_class()
• comment_date()
• comment_excerpt()
• comment_ID()
• comment_link()
• comment_reply_link()
• comment_time()
• edit_comment_link()
• get_comment_author()
• get_comment_author_link()
• get_comment_author_url()
• get_comment_class()
• get_comment_date()
• get_comment_excerpt()
• get_comment_ID()
• get_comment_time()
• have_comments()

Функции, связанные с комментариями, такие как allowed_tags(), comment_form() и другие, также могут быть полезны для работы с комментариями в WordPress.