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