previous_post_link() │ WP 1.5.0

Выводит ссылку на предыдущий по дате пост (запись) из указанной таксономии (по умолчанию category).

Используется на страницах типа is_single().

Работает со всеми типами записей (с типом записи текущего поста - global $post).

Используйте next_post_link(), чтобы вывести ссылку на следующий пост.

Работает на основе: get_previous_post_link()
1 раз — 0.006207 сек (очень медленно) | 50000 раз — 21.35 сек (медленно) | PHP 7.1.5, WP 4.8.1

Хуков нет.

Возвращает

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'

Примеры

0

#1 Ссылка на предыдущую запись

Выведем предыдущую по дате публикации ссылку и выделим её жирным (HTML тегом strong):

<?php previous_post_link('<strong>%link</strong>'); ?>
0

#2 Ссылка на предыдущую запись исключая рубрику

Выведем ссылку на предыдущую по дате публикации статью, но не из категории 15 (статьи из категории 15 не будут учитываться):

<?php previous_post_link('%link', '%title', false, '15'); ?>
0

#3 Ссылка на предыдущий пост из таксономии

Ссылка на предыдущую запись из текущего термина указанной таксономии. Нужная нам таксономия называется battle_cat:

<?php previous_post_link( '%link', '< %title', true, '', 'battle_cat' ); ?>
-1

#4 Ссылка на предыдущую запись из рубрики

Выведем ссылку на предыдущую статью из текущей категории с текстом - "Предыдущая статья из категории" вместо заголовка статьи:

<?php previous_post_link('%link', 'Предыдущая статья из категории', true); ?>

Заметки

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

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

Код previous_post_link() WP 6.5.2

wp-includes/link-template.php 
function previous_post_link( $format = '&laquo; %link', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
	echo get_previous_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
}

adjacent link (связанные ссылки)

Навигация

Записи: посты, страницы, ...