get_previous_post()
Получает предыдущий пост (в виде объекта) из указанной таксономии (по умолчанию 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'
Примеры
#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 6.7.1
function get_previous_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) { return get_adjacent_post( $in_same_term, $excluded_terms, true, $taxonomy ); }