the_posts_pagination

Выводит на экран ссылки пагинации на след./пред. сет постов. Используется на страницах архивов (рубрики, метки, …).

Чтобы получить результат для обработки, используйте get_the_posts_pagination().

Хуков нет.

Возвращает

Ничего. Выводит на экран HTML код пагинации. Если страниц пагинации нет (меньше 1), то ничего не выведет.

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

the_posts_pagination( $args );
$args(массив)
Параметры по которым будет выводиться результат. По умолчанию:

// удаляет H2 из шаблона пагинации
add_filter('navigation_markup_template', 'my_navigation_template', 10, 2 );
function my_navigation_template( $template, $class ){
	/*
	Вид базового шаблона:
	<nav class="navigation %1$s" role="navigation">
		<h2 class="screen-reader-text">%2$s</h2>
		<div class="nav-links">%3$s</div>
	</nav>
	*/

	return '
	<nav class="navigation %1$s" role="navigation">
		<div class="nav-links">%3$s</div>
	</nav>    
	';
}

// выводим пагинацию
the_posts_pagination( array(
	'end_size' => 2,
) );

Код из


wp-includes/link-template.php

WP 4.7.2

<?php
function the_posts_pagination( $args = array() ) {
	echo get_the_posts_pagination( $args );
}