WordPress как на ладони
wordpress jino

get_the_comments_pagination() WP 4.4.0

Получает список ссылок на следующие, предыдущие страницы комментариев записи. Получает ссылки пагинации.

Ничего не получит, если у записи не достаточно комментариев для разделения на страницы.

Для получения подобного списка пагинации есть также функция: paginate_comments_links()

Используется в: the_comments_pagination().
Работает на основе: _navigation_markup(), paginate_comments_links()

Хуков нет.

Возвращает

Строку. HTML код ссылок.

Использование

get_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 Вывод пагинации комментариев (демонстрация)

Допустим, мы находимся на странице 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://wptest.ru/postname/comment-page-1/#comments">← Ранее</a>
		<a class="page-numbers" href="http://wptest.ru/postname/comment-page-1/#comments">1</a>
		<span class="page-numbers current">2</span>
		<a class="page-numbers" href="http://wptest.ru/postname/comment-page-3/#comments">3</a>
		<a class="next page-numbers" href="http://wptest.ru/postname/comment-page-3/#comments">Далее →</a>
	</div>
</nav>

А так это будет выглядеть в браузере (без css оформления):

Ссылки пагинации комментариев в wordpress

Код get the comments pagination: wp-includes/link-template.php WP 4.9

<?php
function get_the_comments_pagination( $args = array() ) {
	$navigation = '';
	$args       = wp_parse_args( $args, array(
		'screen_reader_text' => __( 'Comments navigation' ),
	) );
	$args['echo'] = false;

	// Make sure we get a string back. Plain is the next best thing.
	if ( isset( $args['type'] ) && 'array' == $args['type'] ) {
		$args['type'] = 'plain';
	}

	$links = paginate_comments_links( $args );

	if ( $links ) {
		$navigation = _navigation_markup( $links, 'comments-pagination', $args['screen_reader_text'] );
	}

	return $navigation;
}

Cвязанные функции

Из метки: navigation pagination (навигация пагинация)

Еще из метки: comment (комментарии)

Еще из раздела: Комментарии

get_the_comments_pagination Комментариев нет

Здравствуйте, !

Ваш комментарий