previous_post_link()
Выводит ссылку на предыдущий по дате пост (запись) из указанной таксономии (по умолчанию category).
Используется на страницах типа is_single().
Работает со всеми типами записей (с типом записи текущего поста - global $post).
Используйте next_post_link(), чтобы вывести ссылку на следующий пост.
Хуков нет.
Возвращает
null.
Использование
<?php previous_post_link( $format, $link, $in_same_cat, $excluded_terms, $taxonomy ); ?>
- $format(строка)
- Формат ссылки. Контролирует что будет до и после ссылки. Тег
%linkв строке будет заменен на ссылку. Например,'Перейти к %link', выведетПерейти к Название статьи. Также в строке можно использовать параметр%date, тогда в текст ссылки будет добавлена еще и дата публикации поста.
По умолчанию: '%link »' - $link(строка)
- Текст ссылки (Анкор). Тег
%titleбудет заменен заголовком статьи.
По умолчанию: '%title' - $in_same_cat(логический)
- Если установить этот параметр в
trueили1, то будет выводиться ссылка на следующую статью из той же категории что и текущая.
По умолчанию: false - $excluded_terms (строка)
- ID категории посты из которых не нужно учитывать при подборе следующего поста. Можно указать несколько категорий, которые нужно исключить, для этого разделите ID словом
and:'1 and 5 and 15'. Если указан следующий параметр $taxonomy, то тут нужно указывать термины.
По умолчанию: '' - $taxonomy(строка)
- Название таксономии ссылка на запись из которой будет получаться.
По умолчанию: 'category'
Примеры
#1 Ссылка на предыдущую запись
Выведем предыдущую по дате публикации ссылку и выделим её жирным (HTML тегом strong):
<?php previous_post_link('<strong>%link</strong>'); ?> #2 Ссылка на предыдущую запись исключая рубрику
Выведем ссылку на предыдущую по дате публикации статью, но не из категории 15 (статьи из категории 15 не будут учитываться):
<?php previous_post_link('%link', '%title', false, '15'); ?> #3 Ссылка на предыдущий пост из таксономии
Ссылка на предыдущую запись из текущего термина указанной таксономии. Нужная нам таксономия называется battle_cat:
<?php previous_post_link( '%link', '< %title', true, '', 'battle_cat' ); ?>
#4 Ссылка на предыдущую запись из рубрики
Выведем ссылку на предыдущую статью из текущей категории с текстом - "Предыдущая статья из категории" вместо заголовка статьи:
<?php previous_post_link('%link', 'Предыдущая статья из категории', true); ?>
Заметки
- Смотрите: get_previous_post_link()
Список изменений
| С версии 1.5.0 | Введена. |
Код previous_post_link() previous post link WP 6.7.1
function previous_post_link( $format = '« %link', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
echo get_previous_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
}