get_previous_posts_page_link()
Получает 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();
Примеры
#1 Выведем ссылку в своей кнопке
К примеру, у нас есть тип записи "Фигуранты" (figurants) и мы в этом архиве хотим вывести кнопку на следующую страницу пагинации.
Допустим сейчас мы находимся на странице пагинации 3:
<?php if ( $next_url = get_previous_posts_page_link() ): ?> <button class="btn" type="button" data-url="<?= $next_url ?>">Показать предыдущие </button> <?php endif; ?>
Получим:
<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() get previous posts page link WP 6.2.2
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 ); } }