WordPress как на ладони
rgbcode is looking for WordPress developers. Очень Удобный и Быстрый Хостинг для сайтов на WordPress. Пользуюсь сам и вам рекомендую!

get_the_comments_pagination()WP 4.4.0

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

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

Это обертка для функции paginate_comments_links(), которая добавляет HTML маркировку к пагинации.

Работает на основе: _navigation_markup(), paginate_comments_links()
Основа для: the_comments_pagination()

Хуков нет.

Возвращает

Строку. 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()

Примеры

0

#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 оформления):

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

Заметки

Список изменений

С версии 4.4.0 Введена.
С версии 5.3.0 Added the aria_label parameter.
С версии 5.5.0 Added the class parameter.

Код get_the_comments_pagination() WP 6.4.3

function get_the_comments_pagination( $args = array() ) {
	$navigation = '';

	// Make sure the nav element has an aria-label attribute: fallback to the screen reader text.
	if ( ! empty( $args['screen_reader_text'] ) && empty( $args['aria_label'] ) ) {
		$args['aria_label'] = $args['screen_reader_text'];
	}

	$args         = wp_parse_args(
		$args,
		array(
			'screen_reader_text' => __( 'Comments navigation' ),
			'aria_label'         => __( 'Comments' ),
			'class'              => 'comments-pagination',
		)
	);
	$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, $args['class'], $args['screen_reader_text'], $args['aria_label'] );
	}

	return $navigation;
}
2 комментария
    Войти