get_posts_nav_link() — описание функции WordPress на русском

Сигнатура

get_posts_nav_link( string|array $args = array() ): string

Описание

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

Параметры

$args string|array необязательный = array()

Аргументы для построения навигации по ссылкам на страницы записи. sep stringСимвол-разделитель. По умолчанию '—'. prelabel stringТекст ссылки для перехода на предыдущую страницу. По умолчанию ‘« Previous Page’. nxtlabel stringТекст ссылки для перехода на следующую страницу. По умолчанию ‘Next Page »’.

Возвращаемое значение

string

Исходный код

wp-includes/link-template.php:2726

function get_posts_nav_link( $args = array() ) {
	global $wp_query;

	$return = '';

	if ( ! is_singular() ) {
		$defaults = array(
			'sep'      => ' — ',
			'prelabel' => __( '« Previous Page' ),
			'nxtlabel' => __( 'Next Page »' ),
		);
		$args     = wp_parse_args( $args, $defaults );

		$max_num_pages = $wp_query->max_num_pages;
		$paged         = get_query_var( 'paged' );

		// Only have sep if there's both prev and next results.
		if ( $paged < 2 || $paged >= $max_num_pages ) {
			$args['sep'] = '';
		}

		if ( $max_num_pages > 1 ) {
			$return  = get_previous_posts_link( $args['prelabel'] );
			$return .= preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;1', $args['sep'] );
			$return .= get_next_posts_link( $args['nxtlabel'] );
		}
	}
	return $return;
}

История изменений

Версия	Описание
2.8.0	Introduced.