Функция the_comments_pagination() │ WP 4.4.0
Эта функция отображает навигацию для перелистывания комментариев на страницах вашего сайта. То есть, если у вас много комментариев, она поможет пользователям переходить между страницами комментариев.
Использование
the_comments_pagination( $args );
Параметры
$args(array) — массив параметров, которые можно передать в функцию. Подробнее можно узнать, посмотрев на функциюget_the_comments_pagination(). По умолчанию — пустой массив.
Пример использования
Допустим, у вас есть запись с 300 комментариями, и вы хотите отображать по 100 комментариев на странице. Для этого используйте следующий код:
the_comments_pagination();
Результат выполнения
После выполнения этого кода на странице комментариев будет выведен следующий HTML-код:
Версии
- С версии 4.4.0 — функция была введена в WordPress.
Общее описание функции
Функция the_comments_pagination() вызывает другую функцию get_the_comments_pagination(), которая генерирует навигацию.
function the_comments_pagination( $args = array() ) {
echo get_the_comments_pagination( $args );
}
Связанные функции
Вот несколько функций, связанных с навигацией по комментариям:
- get_comment_pages_count() — получает количество страниц с комментариями.
- get_comments_pagenum_link() — получает ссылку на конкретную страницу комментариев.
- get_next_comments_link() — получает ссылку на следующую страницу комментариев.
- get_previous_comments_link() — получает ссылку на предыдущую страницу комментариев.
- paginate_comments_links() — отображает ссылки на страницы комментариев.
Эти функции помогут вам более гибко управлять навигацией по комментариям на вашем сайте WordPress.