the_comments_pagination()
Виводить на екран блок пагінації посилань на сторінки коментарів запису.
Нічого не виведе, якщо запис не має коментарів для поділу на сторінки.
Це обгортка для функції get_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.0.2
function the_comments_pagination( $args = array() ) {
echo get_the_comments_pagination( $args );
}