Функция GET_NEXT_POST() в WordPress 1.5.0: использование и примеры

# Функция GET_NEXT_POST() в WordPress 1.5.0

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

Для получения ссылки на предыдущий пост используйте get_previous_post().

### Используемость

Функция работает с get_adjacent_post(). Время выполнения: 0.00286 сек (очень медленно) при 1 вызове и 1.85 сек (быстро) при 50000 вызовах на PHP 7.1.5 и WordPress 4.8.1.

### Хуки

Функция не использует хуки.

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

Функция возвращает:
- Объект типа WP_Post, если всё прошло успешно.
- null, если глобальная переменная $post не установлена.
- Пустую строку, если соответствующий пост не существует.

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

Функция вызывается следующим образом:

```php
get_next_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: Отображение следующего поста

Следующий пост относительно предыдущего будет показан, если такой пост существует:

$next_post = get_next_post();

if( ! empty( $next_post ) ){
    ?>
    
        post_title; ?>
    
    

function get_next_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
    return get_adjacent_post( $in_same_term, $excluded_terms, false, $taxonomy );
}