get_previous_post() │ WP 1.5.0

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

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

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

Хуков нет.

Возвращает

WP_Post|null|Строку.

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

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

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

Примеры

0

#1 Получим предыдущий пост и выведем ссылку на него (демонстрация работы). 

$prev_post = get_previous_post();
echo '<a href="' . get_permalink( $prev_post ) . '">'. esc_html($prev_post->post_title) .'</a>';

Для получения такой ссылки удобнее использовать функцию: previous_post_link().

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

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

Код get_previous_post() WP 6.1.1

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

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

Навигация