previous_post_link()
Виводить посилання на попередній за датою пост (запис) із зазначеної таксономії (за умовчанням category).
Використовується на сторінках типу is_single() .
Працює з усіма типами записів (з типом запису поточного поста – Global $post ).
Використовуйте next_post_link() , щоб вивести посилання на наступний пост.
get_previous_post_link()
(дуже повільно) | 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’
Приклади
#1 Посилання на попередній запис
Виведемо попереднє за датою публікації посилання та виділимо її жирним (HTML тегом strong):
<?php previous_post_link('<strong>%link</strong>'); ?>#2 Посилання на попередній запис із рубрики
Виведемо посилання на попередню статтю з поточної категорії з текстом – “Попередня стаття з категорії” замість заголовка статті:
<?php previous_post_link('%link', 'Попередня стаття з категорії', true); ?>#3 Посилання на попередній запис за винятком рубрики
Виведемо посилання на попередню за датою публікації статтю, але не з категорії 15 (статті з категорії 15 не враховуватимуться):
<?php previous_post_link('%link', '%title', false, '15'); ?>#4 Посилання на попередній пост з таксономії
Посилання на попередній запис із поточного терміну зазначеної таксономії. Потрібна нам таксономія називається battle_cat :
<?php previous_post_link( '%link', '<%title', true, '', 'battle_cat' ); ?>
нотатки
- Дивіться: get_previous_post_link()
список змін
| З версії 1.5.0 | Введено. |
Код previous_post_link() previous post link WP 6.0.2
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 );
}