get_next_post_link()
Отримує посилання (тег A) на наступний за датою пост щодо поточного із зазначеної таксономії (за замовчуванням category).
Працює з усіма типами записів (з типом запису поточного поста – Global $post ).
Використовуйте get_previous_post_link() , щоб отримати посилання на попередній пост.
Працює на основі:
get_adjacent_post_link()
get_adjacent_post_link()
Основа для:
next_post_link()
next_post_link()
1 раз – 0.005546 сек
(дуже повільно) | 50000 разів – 16.68 сек
(повільно) |
PHP 7.1.5, WP 4.8.1
(дуже повільно) | 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’
Приклади
#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' );
#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() 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 ); }