get_previous_post_link() │ WP 3.7.0

Отримує посилання (тег A) на попередній за датою пост (запис) із зазначеної таксономії (за замовчуванням category).

Працює з усіма типами записів (з типом запису поточного поста – Global $post ).

Функція повинна використовуватись на окремих сторінках типу is_single() .

Хуків немає.

Повертає

Строку.

• 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’

Приклади

# Посилання на попередній запис блогу
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');

Додати свій приклад