get_next_post() │ WP 1.5.0

Получает следующий пост (в виде объекта) из указанной таксономии (по умолчанию category).

Чтобы получить объект предыдущей записи, используйте get_previous_post().

Работает на основе: get_adjacent_post()
1 раз — 0.00286 сек (очень медленно) | 50000 раз — 1.85 сек (быстро) | PHP 7.1.5, WP 4.8.1

Хуков нет.

Возвращает

WP_Post|null|Строку.

  • Объект поста, в случае успешного получения.
  • null, если глобальная переменная $post не установлена.
  • Пустую строку, если предыдущего поста не существует.

Использование

get_next_post( $in_same_term, $excluded_terms, $taxonomy );
$in_same_term(логический)
Должен ли следующий пост находится в той же рубрике. true - из той же рубрики.
По умолчанию: false
$excluded_terms(строка)
ID категорий через запятую, посты из которых не должны быть включены в вывод.
По умолчанию: ''
$taxonomy(строка)
Название таксономии, когда включен параметр $in_same_term.
По умолчанию: 'category'

Примеры

0

#1 Выведем следующий пост по отношению к текущему, если такой пост существует: 

<?php
$next_post = get_next_post();

if( ! empty( $next_post ) ){
	?>
	<a href="<?php echo get_permalink( $next_post ); ?>"><?php echo esc_html( $next_post->post_title ); ?></a>
	<?php
}
?>

Список изменений

С версии 1.5.0 Введена.

Код get_next_post() WP 6.7.1

wp-includes/link-template.php 
function get_next_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
	return get_adjacent_post( $in_same_term, $excluded_terms, false, $taxonomy );
}

Связи (постов терминов)

Навигация