get_next_post()
Отримує наступний пост (як об’єкт) із зазначеної таксономії (за замовчуванням category).
Щоб отримати об’єкт попереднього запису, використовуйте get_previous_post() .
Працює на основі:
get_adjacent_post()
get_adjacent_post()
1 раз – 0.00286 сек
(дуже повільно) | 50000 разів – 1.85 сек
(швидко) |
PHP 7.1.5, WP 4.8.1
(дуже повільно) | 50000 разів – 1.85 сек
(швидко) |
PHP 7.1.5, WP 4.8.1
Хуків немає.
Повертає
WP_Post|null|Строку
.
Объект поста
, у разі успішного одержання.null
якщо глобальна змінна $post не встановлена.Пустую строку
, якщо попереднього посту немає.
Використання
get_next_post($in_same_term, $excluded_terms, $taxonomy);
-
$in_same_term
(логічний) -
Чи повинен наступний пост перебувати у тій самій рубриці. true – з тієї ж рубрики.
Типово: false -
$excluded_terms
(рядок) -
ID категорій через кому, пости з яких не повинні бути включені до висновку.
За замовчуванням: ” -
$taxonomy
(рядок) -
Назва таксономії, коли увімкнено параметр
$in_same_term .
Типово: ‘category’
Приклади
#1 Виведемо наступний пост стосовно поточного, якщо такий пост існує:
<?php $next_post = get_next_post(); if( ! empty( $next_post ) ){ ?> <a href="<?php echo get_permalink( $next_post ); ?>"><?php echo esc_html( $next_post->post_title ); ?></a> <?php } ?>
список змін
З версії 1.5.0 | Введено. |
Код get_next_post() get next post WP 6.0.2
function get_next_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) { return get_adjacent_post( $in_same_term, $excluded_terms, false, $taxonomy ); }