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.0Added aria_label parameter.
З версії 5.5.0Added the class parameter.

Код get_the_comments_pagination() WP 6.0.2

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

	// Make sure the nav element has 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;
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *