get_previous_post_link() │ WP 3.7.0

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

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

Функция должна использоваться на отдельных страницах типа is_single().

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

Работает на основе: get_adjacent_post_link()
Основа для: previous_post_link()
1 раз — 0.005912 сек (очень медленно) | 50000 раз — 16.36 сек (медленно) | PHP 7.1.5, WP 4.8.1

Хуков нет.

Возвращает

Строку.

  • HTML код ссылки:

    <a rel="prev" href="/ярлык_записи">Заголовок записи</a>
  • Пустую строку, если подходящей записи нет.

Использование

get_previous_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
$format(строка)
Формат в котором будет показана ссылка. %link заменится HTML код <a>. Например, '%link →' выведет <a ...> →.
По умолчанию: '« %link'
$link(строка)
Анкор ссылки. '%title' заменится на заголовок записи.
По умолчанию: '%title'
$in_same_term(логический)
true - искать предыдущую запись в том же элементе таксономии (рубрике). false - будет искать предыдущую запись во всех элементов таксономии.
По умолчанию: false
$excluded_terms(строка)
ID элементов таксономии, записи из которых не нужно учитывать. Можно указать строкой: '1,5,15', или массивом: array(1,5,15).
По умолчанию: ''
$taxonomy(строка)
Название таксономии для параметра $in_same_term.
По умолчанию: 'category'

Примеры

0

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

Тут приведу примеры как выводить ссылку на предыдущую запись:

# ссылка на предыдущую запись блога
echo get_previous_post_link();

# выведет: ← <a href="http://test.ru/zagolovok" rel="prev">Заголовок записи</a>

# ссылка на предыдущую запись из текущей рубрики
echo get_previous_post_link( '%link', '← %title', 1 );

# выведет: <a href="http://test.ru/markup" rel="prev">← Маркировка</a>

# ссылка на предыдущую запись из текущего элемента таксономии (my_tax), для произвольных таксономий
echo get_previous_post_link( '%link', '%title →', 1, '', 'my_tax' );

# ссылка на предыдущую запись не учитывая записи из рубрик 5 и 10
echo get_previous_post_link( '%link', '%title →', 0, '5,10' );

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

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

Код get_previous_post_link() WP 6.5.2

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

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

Навигация