get_the_comments_pagination()
Получает ссылки пагинации комментариев: список ссылок на следующие, предыдущие страницы комментариев записи.
Ничего не получит, если у записи недостаточно комментариев для разделения на страницы.
Это обертка для функции paginate_comments_links(), которая добавляет HTML маркировку к пагинации.
Хуков нет.
Возвращает
Строку
. HTML код ссылок.
Использование
get_the_comments_pagination( $args );
- $args(массив)
Параметры формирующие вывод. Параметры передаваемые по умолчанию:
$defaults = [ 'screen_reader_text' => __( 'Comments navigation' ), 'aria_label' => __( 'Comments' ), // WP 5.3 'class' => 'comments-pagination', // WP 5.5 // из функции paginate_comments_links(): 'base' => add_query_arg( 'cpage', '%#%' ), 'format' => '', 'total' => $max_page, 'current' => $page, 'echo' => true, 'add_fragment' => '#comments' ];
Также, может принимать все которые передаются функции paginate_links()
По умолчанию: array()
Примеры
#1 Вывод пагинации комментариев (демонстрация)
Допустим, мы находимся на странице postname. У которой 30 комментариев и в настройках установлено разделять комментарии по 10 на страницу. Тогда смотрим что получит функцию:
<?php echo get_the_comments_pagination(); ?>
Или можно использовать функцию-обертку для быстрого вывода на экран:
<?php the_comments_pagination(); ?>
Получим такой HTML код:
<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>
А так это будет выглядеть в браузере (без css оформления):

Заметки
- Смотрите: paginate_comments_links()
Список изменений
С версии 4.4.0 | Введена. |
С версии 5.3.0 | Added the aria_label parameter. |
С версии 5.5.0 | Added the class parameter. |