get_the_posts_navigation

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

До версии 4.1 такие ссылки можно получить с помощью функций get_next_posts_link() и get_previous_posts_link().

Чтобы получить ссылки навигации для отдельной записи используйте the_post_navigation().

Хуков нет.

Возвращает

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

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

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

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

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

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

Примеры

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

<?php
function get_the_posts_navigation( $args = array() ) {
	$navigation = '';

	// Don't print empty markup if there's only one page.
	if ( $GLOBALS['wp_query']->max_num_pages > 1 ) {
		$args = wp_parse_args( $args, array(
			'prev_text'          => __( 'Older posts' ),
			'next_text'          => __( 'Newer posts' ),
			'screen_reader_text' => __( 'Posts navigation' ),
		) );

		$next_link = get_previous_posts_link( $args['next_text'] );
		$prev_link = get_next_posts_link( $args['prev_text'] );

		if ( $prev_link ) {
			$navigation .= '<div class="nav-previous">' . $prev_link . '</div>';
		}

		if ( $next_link ) {
			$navigation .= '<div class="nav-next">' . $next_link . '</div>';
		}

		$navigation = _navigation_markup( $navigation, 'posts-navigation', $args['screen_reader_text'] );
	}

	return $navigation;
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *