WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

get_next_post_link() WP 3.7.0

Получает ссылку (тег A) на следующий по дате пост относительно текущего.

Ищем WP-разработчика! Фулл-тайм, удаленка, хорошая зарплата, соц. пакет. Подробности.
Компания Boosta.

Работает со всеми типами записей (с типом записи текущего поста - 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'

Примеры

#1 Ссылка на следующую запись относительно текущей

# ссылка на следующую запись
echo get_next_post_link();

# выведет: <a href="http://wptest.ru/some" rel="next">Что-то</a> →      

# ссылка на следующую запись из текущей рубрики
echo get_next_post_link( '%link', '%title →', 1 );

# выведет: <a href="http://wptest.ru/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() WP 5.8.2

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

adjacent link (связанные ссылки)

Навигация

6 комментов
    Войти