get_previous_post() WP 1.5
Получает предыдущий пост. Возвращается все данные предыдущего поста в виде объекта.
Чтобы получить объект следующего поста, используйте get_next_post().
Работает на основе: get_adjacent_post()
1 раз — 0.001871 сек (очень медленно) | 50000 раз — 2.00 сек (быстро) | PHP 7.1.5, WP 4.8.1
Хуков нет.
Возвращает
Объект/null/пустая строка.
- Объект поста, в случае успешного получения.
- null, если глобальная переменная $post не установлена.
- Пустую строку, если предыдущего поста не существует.
Использование
get_previous_post( $in_same_term, $excluded_trems, $taxonomy );
- $in_same_term(логический)
- Должен ли пост находится в одинаковой рубрике. Ставим true, если нужно получить пост из той же рубрики, что и текущий.
По умолчанию: false - $excluded_trems(строка)
- ID категорий, посты из которых получать не нужно.
По умолчанию: "" - $taxonomy(строка)
- Название таксономии, когда включен параметр $in_same_term.
По умолчанию: 'category'
Примеры
#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() get previous post WP 5.6
function get_previous_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
return get_adjacent_post( $in_same_term, $excluded_terms, true, $taxonomy );
}