the_posts_navigation()WP 4.1.0

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

Эта функцию является оберткой для get_the_posts_navigation().

Чтобы вывести блок со ссылками пагинации, используйте функцию the_posts_pagination().

Работает на основе: get_the_posts_navigation()

Хуков нет.

Возвращает

null. Выводит на экран HTML код на предыдущий и следующий сеты постов.

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

the_posts_navigation( $args );
$args(массив)

Параметры с помощью которых можно изменить анкоры ссылок: «Старые записи» и «Новые записи». По умолчанию параметры выглядят так:

$args = array(
'prev_text'          => __( 'Older posts' ),
'next_text'          => __( 'Newer posts' ),
'screen_reader_text' => __( 'Posts navigation' ),
);

По умолчанию: array()

Примеры

1

#1 Выведем ссылки на предыдущий/следующий сет постов

the_posts_navigation( array(
	'prev_text'          => 'Предыдущие записи',
	'next_text'          => 'Следующие записи',
	'screen_reader_text' => 'Навигация',
) );

В результате на экран будет выведен следующий код навигации:

<nav class="navigation posts-navigation" role="navigation">
	<h2 class="screen-reader-text">Навигация</h2>
	<div class="nav-links">
		<div class="nav-previous">
			<a href="http://example.com/page/3/">Предыдущие записи</a>
		</div>
		<div class="nav-next">
			<a href="http://example.com/">Следующие записи</a>
		</div>
	</div>
</nav>

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

С версии 4.1.0 Введена.

Код the_posts_navigation() WP 6.5.2

function the_posts_navigation( $args = array() ) {
	echo get_the_posts_navigation( $args );
}