# get_posts_nav_link()

URL: https://chugunov.pro/api-wordpress/functions/get_posts_nav_link/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.8.0.

## Сигнатура

```php
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`

```php
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.

## Связанные

Использует: [`is_singular`](https://chugunov.pro/api-wordpress/functions/is_singular/), [`get_query_var`](https://chugunov.pro/api-wordpress/functions/get_query_var/), `WP_Query`, [`get_previous_posts_link`](https://chugunov.pro/api-wordpress/functions/get_previous_posts_link/), [`get_next_posts_link`](https://chugunov.pro/api-wordpress/functions/get_next_posts_link/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/).
Используется в: [`posts_nav_link`](https://chugunov.pro/api-wordpress/functions/posts_nav_link/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_posts_nav_link/