previous_posts_link() WP 1.5.0
Выводит ссылку на список постов (страница пагинации). Ссылка выводится на более новые посты по сравнению с текущими. Навигация внутри категории.
previous_posts_link() используется на странице категорий (таксономий) и на главной странице.
Чтобы вывести ссылку на следующие посты, используйте next_posts_link().
Так как записи обычно отсортированы в обратном хронологическом порядке (новые записи добавляются наверх), previous_posts_link() выводит ссылку на страницу новых записей (стремится к новым записям), а next_posts_link() выводит ссылку на предыдущие записи (т.е. стремится к началу блога).
Возвращает
Выводит на экран HTML код ссылки.
Работает на основе: get_previous_posts_link()
Хуков нет.
Использование
<?php previous_posts_link( $label , $max_pages ); ?>
- $label(строка)
- Текст ссылки
По умолчанию: '« Previous Page' - $max_pages(число)
- Ограничение, число страниц на которых ссылка будет показана.
Примеры
- Выведем ссылку на предыдущий блок постов на странице категорий:
<?php previous_posts_link(); ?>
- Изменим текст ссылки на свой, "« двигаемся назад":
<?php previous_posts_link('« двигаемся назад', 0) ?>
Список изменений
С версии 0.71 | Введена. |
Код previous_posts_link() previous posts link WP 5.6
function previous_posts_link( $label = null ) {
echo get_previous_posts_link( $label );
}Cвязанные функции
Из раздела: Архивы
Еще из тегов шаблона: Записи: посты, страницы, ...
- body_class()
- get_post_format()
- get_post_time()
- get_the_date()
- have_posts()
- in_the_loop()
- next_image_link()
- next_post_link()
- post_class()
- post_password_required()
- previous_image_link()