get_previous_posts_page_link() │ WP 2.0.10

Получает URL на список постов опубликованных позднее текущих (ссылка пагинации).

Так как посты обычно сортируются в обратном порядке (поздние посты показываются раньше), эта функция обычно направляет к ранним постам.

Работает на всех страницах кроме is_single(). Т.е. условие is_single() не должно срабатывать.

Работает на основе глобальной переменной global $paged;.

  • Используйте get_next_posts_page_link(), когда нужно получить ссылку к поздним (начальным) постам.
  • Используйте get_previous_posts_link(), когда нужно получить готовый HTML на список постов опубликованных позднее.
Работает на основе: get_pagenum_link()
Основа для: get_previous_posts_link()
1 раз — 0.0017691 сек (очень медленно) | 50000 раз — 5.09 сек (быстро)

Хуков нет.

Возвращает

Строку|null. URL архива постов опубликованных ранее текущих.

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

get_previous_posts_page_link();

Примеры

0

#1 Выведем ссылку в своей кнопке

К примеру, у нас есть тип записи "Фигуранты" (figurants) и мы в этом архиве хотим вывести кнопку на следующую страницу пагинации.

Допустим сейчас мы находимся на странице пагинации 3:

<?php if ( $next_url = get_previous_posts_page_link() ) { ?>
	<button class="btn" type="button" data-url="<?= $next_url ?>">
		Показать предыдущие
	</button>
<?php } ?>

Получим:

<button class="btn" type="button" data-url="https://site.example/figurants/page/2/">
	Показать предыдущие
</button>

Заметки

  • Global. int. $paged

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

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

Код get_previous_posts_page_link() WP 7.0

wp-includes/link-template.php 
function get_previous_posts_page_link() {
	global $paged;

	if ( ! is_single() ) {
		$previous_page = (int) $paged - 1;

		if ( $previous_page < 1 ) {
			$previous_page = 1;
		}

		return get_pagenum_link( $previous_page );
	}
}

navigation pagination (навигация пагинация)

URL (УРЛ Ссылка)

Архивы