Функция the_comments_pagination() в WordPress с примерами

Главная - WordPress Codex - Функция the_comments_pagination() в WordPress с примерами
Доступна с версии: 4.4
Раздел: Комментарии
Написал: Александр Сокирка

Функция the_comments_pagination() отвечает за вывод HTML-кода для навигации по комментариям, если их количество превышает лимит, установленный в настройках WordPress. Она выводит пагинацию комментариев с использованием различных параметров для настройки отображения. Эта функция является оберткой для get_the_comments_pagination(), и напрямую ничего не возвращает, выводя HTML-код на экран.

the_comments_pagination( array $args = array() );

Параметры

Функция принимает массив $args, который может содержать следующие параметры:

  • screen_reader_text
    Текст для скринридеров. По умолчанию: 'Comments navigation'.
  • base
    Базовый URL для каждой страницы. По умолчанию: результат функции add_query_arg( 'cpage', '%#%' ).
  • format
    Строка формата для номеров страниц. По умолчанию: пустая строка.
  • total
    Общее количество страниц с комментариями. Определяется автоматически.
  • current
    Текущая страница комментариев. Определяется автоматически.
  • echo
    Указывает, выводить результат (true) или вернуть в переменную (false). По умолчанию: true.
  • add_fragment
    Фрагмент, добавляемый к ссылкам пагинации. По умолчанию: '#comments'.

Эти параметры могут быть дополнительно расширены параметрами функции paginate_links(), которая используется для генерации ссылок пагинации.

Пример 1: пагинация комментариев

if ( get_comment_pages_count() > 1 && get_option( 'page_comments' ) ) {
    the_comments_pagination();
}

    Этот код автоматически выведет ссылки пагинации, если количество комментариев достаточно для их разделения на страницы. Пример вывода:

    <nav class="navigation comments-pagination" role="navigation">
    <h2 class="screen-reader-text">Навигация по комментариям</h2>
    <div class="nav-links">
        <a class="prev page-numbers" href="http://example.com/postname/comment-page-1/#comments">← Ранее</a>
        <a class="page-numbers" href="http://example.com/postname/comment-page-1/#comments">1</a>
        <span class="page-numbers current">2</span>
        <a class="page-numbers" href="http://example.com/postname/comment-page-3/#comments">3</a>
        <a class="next page-numbers" href="http://example.com/postname/comment-page-3/#comments">Далее →</a>
    </div>
</nav>

    Пример 2: Настроенная пагинация

    Если вы хотите изменить текст ссылок или стили пагинации, можно передать массив параметров:

    if ( get_comment_pages_count() > 1 && get_option( 'page_comments' ) ) {
    the_comments_pagination( array(
        'prev_text'          => '← Назад',
        'next_text'          => 'Вперед →',
        'before_page_number' => '<span class="meta-nav screen-reader-text">Страница </span>',
    ) );
}

    Этот код изменяет текст для ссылок «Назад» и «Вперед», добавляя дополнительный текст перед номерами страниц.

    Заключение

    Функция the_comments_pagination() — это инструмент для добавления навигации по комментариям на сайт. Она гибко настраивается, и с ее помощью можно улучшить взаимодействие пользователей с разделом комментариев на страницах с большим количеством комментариев.

    Убедитесь, что настройка вывода комментариев в панели управления WordPress позволяет делить комментарии на страницы.

    Стартовая премиум тема для WordPress
    Демо импорт тестового контента в 1 клик.
    SEO оптимизированный и валидный код.
    Множество готовых стартовых сайтов.
    Лучшая документация и поддержка.
    Опции персонализации контента.
    Креативный и современный дизайн.
    Тема для WordPress

    Дополнительно по: Комментарии