get_next_post_link() WP 3.7.0

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

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

Використовуйте get_previous_post_link() , щоб отримати посилання на попередній пост.

Працює на основі:
get_adjacent_post_link()
Основа для:
next_post_link()
1 раз – 0.005546 сек
(дуже повільно) | 50000 разів – 16.68 сек
(повільно) |
PHP 7.1.5, WP 4.8.1

Хуків немає.

Повертає

Строку.

  • HTML код посилання:

    <a rel="next" href="/ярлик_запису">Заголовок запису</a>
  • Порожній рядок, якщо відповідного запису немає.

Використання

get_next_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
$format
(рядок)
Формат, в якому буде показано посилання. %link замінить HTML код
<a> . Наприклад, %link → виведе
<a …> → .


Типово: ‘%link »’
$link
(рядок)
Анкор посилання. ‘%title’ заміниться на заголовок запису.


За замовчуванням: %title
$in_same_term
(логічний)
true – отримати наступний пост із поточної рубрики. Якщо запис знаходиться в довільній таксономії, потрібно вказати параметр taxonomy.


Типово: false
$excluded_terms
(масив/рядок)
Виключити рубрики (терміни). Можна вказати рядком або масивом: ‘1,5,15’ або array(1,5,15).


За замовчуванням: ”
$taxonomy
(рядок)
Назва таксономії для $in_same_term.


Типово: ‘category’

Приклади

0

#1 Посилання на наступний запис щодо поточного

# Посилання на наступний запис
echo get_next_post_link();

# виведе: <a href="http://example.com/some" rel="next">Щось</a> →        

# Посилання на наступний запис з поточної рубрики
echo get_next_post_link( '%link', '%title →', 1);

# виведе: <a href="http://example.com/some" rel="next">Щось →</a>

# Посилання на наступний запис з поточного елементу таксономії (my_tax)
echo get_next_post_link( '%link', '%title →', 1, '', 'my_tax' );
0

#2 Додамо свій клас до посилань

Коли до наступного/попереднього посилання потрібно додати довільний клас, можна скористатися таким хаком:

$next = get_next_post_link( '%link', 'next post', true);
echo str_replace( '<a ', '<a class="myclass" ', $next );

$prev = get_previous_post_link( '%link', 'prev post', true );
echo str_replace( '<a ', '<a class="myclass" ', $prev );

список змін

З версії 3.7.0Введено.

Код get_next_post_link() WP 6.0.2

function get_next_post_link( $format = '%link »', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
	return get_adjacent_post_link( $format, $link, $in_same_term, $excluded_terms, false, $taxonomy );
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *