get_previous_post()
Отримує попередній пост (у вигляді об’єкта) із зазначеної таксономії (за замовчуванням).
Щоб отримати об’єкт наступного поста, використовуйте get_next_post() .
Працює на основі:
get_adjacent_post()
get_adjacent_post()
1 раз – 0.001871 сек
(дуже повільно) | 50000 разів – 2.00 сек
(швидко) |
PHP 7.1.5, WP 4.8.1
(дуже повільно) | 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.0.2
function get_previous_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
return get_adjacent_post( $in_same_term, $excluded_terms, true, $taxonomy );
}