Функция PREVIOUS_POST_LINK() в WordPress

Функция previous_post_link() позволяет создать ссылку на предыдущую запись в блоге на основе даты публикации. Важно отметить, что по умолчанию ссылка будет показывать запись из выбранной таксономии (обычно это категория).

Использование функции

Эта функция должна применяться на отдельных страницах, например, в шаблоне записи (is_single()). Не путайте её с похожей функцией previous_posts_link(), которая отображает ссылку на страницу с перечнем предыдущих записей, а не на отдельную запись.

Важная информация о параметре $in_same_cat

Если запись принадлежит сразу нескольким категориям, то выбор следующей записи будет осуществляться из всех этих категорий. Например, если текущая запись находится в категориях 1, 2 и 3, следующая запись может оказаться из категорий 4 и 5. Это значит, что при переходе по таким ссылкам вы можете оказаться в другой категории.

Чтобы отобразить ссылку на следующую запись, используйте функцию next_post_link().

Как работает функция

Функция возвращает null, т.е. ничего не выводит, если ничего не найдено.

Синтаксис

Параметры функции:

• $format (string): Формат ссылки. %link будет заменен на HTML-тег <a>. Пример: '← %link' выведет ← <a ...>.

  • По умолчанию: '« %link'

• $link (string): Формат текста ссылки. %title будет заменен на заголовок записи.

  • По умолчанию: '%title'

• $in_same_term (true/false): Указывает, должна ли ссылка быть в той же категории. Если true, то следующая запись будет из текущей категории. Если запись в пользовательской таксономии, необходимо указать параметр $taxonomy.

  • По умолчанию: false

• $excluded_terms (array/string): Массив или строка с ID категорий, которые нужно исключить. Можно указать строку или массив: '1,5,15' или array(1,5,15).

  • По умолчанию: ''

• $taxonomy (string): Имя таксономии для параметра $in_same_term.

  • По умолчанию: 'category'

Примеры использования

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

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

%link'); ?>

Пример 2: Ссылка на предыдущую запись из категории

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

Пример 3: Ссылка на предыдущую запись с исключением категории

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

Пример 4: Ссылка на предыдущую запись из определенной таксономии

Вывод ссылки на предыдущую запись из текущей категории определенной таксономии (например, battle_cat):

Заключение

Функция previous_post_link() — это полезный инструмент для навигации по записям на вашем сайте WordPress. Она позволяет легко создавать ссылки на предыдущие записи, улучшая пользовательский опыт. Используйте её в своих темах и шаблонах для наладки удобной навигации.

Примечания

• Обратите внимание: для получения ссылки на предыдущую запись можно использовать функцию get_previous_post_link(), которая возвращает ссылку, не выводя её напрямую.

Обновления функции

Функция была введена в версии 1.5.0 WordPress.