GET_PREVIOUS_POST() │ WP 1.5.0

Функция get_previous_post() используется для получения предыдущего поста из указанной таксономии (по умолчанию — это категория). Эта функция возвращает объект поста, если он найден.

Назначение функции

Для получения следующего поста вы можете использовать функцию get_next_post().

Производительность

Время выполнения функции:

• 1 раз — 0.001871 сек (очень медленно)
• 50000 раз — 2.00 сек (быстро)

Для работы функции не требуются хуки.

Возвращаемое значение

• WP_Post|null|String: Возвращает объект поста, если успешная операция. Вернет null, если глобальная переменная $post не установлена. Вернет пустую строку, если соответствующий пост не существует.

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

Функция вызывается с тремя параметрами:

get_previous_post( $in_same_term, $excluded_terms, $taxonomy );

• $in_same_term (true|false): Указывает, должен ли пост находиться в той же категории. По умолчанию — false.
• $excluded_terms (int[]|string): Массив или список ID терминов, которые нужно исключить. По умолчанию — ''.
• $taxonomy (string): Таксономия, если $in_same_term — true. По умолчанию — 'category'.

Примеры

Пример 1: Получение предыдущего поста и создание ссылки на него

$prev_post = get_previous_post();
echo '' . esc_html($prev_post->post_title) . '';

Этот код получает предыдущий пост и создает ссылку на него.

Удобная альтернативная функция

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

Изменения

• С версии 1.5.0: Функция была введена.

Код функции

Вот как выглядит код функции get_previous_post в 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 );
}

Связанные функции

Вот некоторые функции, которые могут быть полезны при работе с постами и их терминами:

• cat_is_ancestor_of()
• get_adjacent_post()
• get_ancestors()
• get_category_parents()
• get_next_post()
• get_post_ancestors()
• get_term_children()

Навигация

Дополнительные функции для навигации между постами:

• get_adjacent_post_link()
• get_boundary_post()
• get_next_post_link()
• get_previous_post_link()
• get_the_post_navigation()
• next_post_link()
• previous_post_link()
• the_post_navigation()

Эти функции помогут вам более эффективно управлять навигацией по постам на вашем сайте WordPress.