Функция previous_post_link() используется для вывода ссылки на предыдущую запись (пост), которая предшествует текущей записи в хронологическом порядке. Эта функция часто применяется на страницах с одиночными записями (is_single()). С ее помощью можно создавать навигационные элементы, связывающие записи по времени публикации или по определенным терминам таксономий, таких как рубрики или метки.
previous_post_link( string $format = '« %link', string $link = '%title', bool $in_same_term = false, int[]|string $excluded_terms = '', string $taxonomy = 'category' )
Аргументы:
$format(строка, по умолчанию ‘« %link’): формат вывода ссылки. Вы можете добавить собственный текст или HTML-разметку до и после ссылки. В строке%linkбудет заменен на саму ссылку.$link(строка, по умолчанию ‘%title’): текст ссылки (анкор), который будет отображаться пользователю. В строке%titleзаменяется на заголовок предыдущего поста.$in_same_term(логическое значение, по умолчаниюfalse): если заданоtrue, будет выводиться ссылка только на пост из той же таксономии, что и текущий.$excluded_terms(массив или строка): список исключаемых терминов (например, ID рубрик), посты из которых не будут учитываться при поиске предыдущей записи.$taxonomy(строка, по умолчанию ‘category’): таксономия, по которой нужно фильтровать записи. Обычно это ‘category’, но может быть изменено на любую другую.
Пример 1: Простая ссылка на предыдущую запись
Этот код выводит ссылку на предыдущую запись, используя формат по умолчанию (слева от заголовка поста отображается знак ««»):
<?php previous_post_link(); ?>
Пример 2: Ссылка на предыдущую запись с жирным текстом
В этом примере используется тег <strong> для выделения ссылки жирным шрифтом.
<?php previous_post_link('<strong>%link</strong>'); ?>
Пример 3: Ссылка на предыдущую запись в пределах одной категории
Используя параметр $in_same_term, можно выводить ссылки только на записи из той же категории, что и текущая запись.
<?php previous_post_link('%link', 'Предыдущая в категории', true); ?>
Пример 4: Исключение определенной категории
Чтобы исключить посты из определенной категории (например, с ID 15), можно использовать параметр $excluded_terms.
<?php previous_post_link('%link', '%title', false, '15'); ?>
Пример 5: Ссылка на предыдущий пост из кастомной таксономии
Этот пример показывает, как выводить ссылку на предыдущую запись из кастомной таксономии, например, «neighborhood» для кастомного типа записей «здания».
<?php previous_post_link('%link', 'Назад в районе', true, '', 'neighborhood'); ?>
Заключение
Функция previous_post_link() — это мощный инструмент для создания навигации между постами в WordPress. Она позволяет легко настраивать внешний вид ссылки и контролировать, из какой таксономии или категории выводить записи.