previous_posts_link() WP 1.5.0
Выводит ссылку на список постов (страница пагинации). Ссылка выводится на более новые посты по сравнению с текущими. Навигация внутри категории.
previous_posts_link() используется на странице категорий (таксономий) и на главной странице.
Чтобы вывести ссылку на следующие посты, используйте next_posts_link().
Так как записи обычно отсортированы в обратном хронологическом порядке (новые записи добавляются наверх), previous_posts_link() выводит ссылку на страницу новых записей (стремится к новым записям), а next_posts_link() выводит ссылку на предыдущие записи (т.е. стремится к началу блога).
Работает на основе: get_previous_posts_link()
Хуков нет.
Возвращает
null. Выводит на экран HTML код ссылки.
Использование
<?php previous_posts_link( $label , $max_pages ); ?>
- $label(строка)
- Текст ссылки
По умолчанию: '« Previous Page' - $max_pages(число)
- Ограничение, число страниц на которых ссылка будет показана.
Примеры
#1. Выведем ссылку на предыдущий блок постов на странице категорий:
<?php previous_posts_link(); ?>
#2. Изменим текст ссылки на свой, "« двигаемся назад":
<?php previous_posts_link('« двигаемся назад', 0) ?>Список изменений
| С версии 0.71 | Введена. |
Код previous_posts_link() previous posts link WP 5.7.2
function previous_posts_link( $label = null ) {
echo get_previous_posts_link( $label );
}