Описание функции get_boundary_post()
Функция get_boundary_post() позволяет получить пост, который находится рядом с текущим постом по заданным критериям сортировки. Это полезно для навигации по записям, особенно в контексте постов в блоге или списках. Функция возвращает либо объект WP_Post, либо false, если пост не найден.
Функция используется в шаблонах тем и плагинов для реализации навигации между постами.
Параметры
$current
Тип: int
Обязательный: Да
Описание: ID текущего поста, для которого нужно найти соседний пост
Возможные значения:
$in_same_term
Тип: mixed
Обязательный: Нет
Описание: Таксономия или массив таксономий, которые должны быть использованы для поиска соседних постов
Возможные значения:
$excluded_terms
Тип: mixed
Обязательный: Нет
Описание: Таксономия или массив таксономий, которые должны быть исключены из поиска
Возможные значения:
$previous
Тип: bool
Обязательный: Нет
Описание: Флаг, указывающий, нужно ли искать предыдущий пост (true) или следующий (false)
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: mixed
Описание: Возвращает объект WP_Post, представляющий соседний пост, или false, если пост не найден.
Возможные значения:
• WP_Post объект при успешном выполнении
• false если пост не найден
Примеры использования
Получение следующего поста относительно текущего поста
$next_post = get_boundary_post(get_the_ID(), null, null, false);
if ($next_post) {
echo $next_post->post_title;
}
Выводит заголовок следующего поста, если он существует
Получение предыдущего поста, исключая определенные категории
$prev_post = get_boundary_post(get_the_ID(), 'category', array(1, 2), true);
if ($prev_post) {
echo $prev_post->post_title;
}
Выводит заголовок предыдущего поста, если он существует
Безопасность
Валидация входных данных: ID поста должен быть положительным целым числом
Санитизация: Функция автоматически очищает параметры в зависимости от контекста
Рекомендации: Всегда проверяйте результат на false перед использованием данных поста
— Связанные функции
Получает следующий пост в порядке сортировки
Получает предыдущий пост в порядке сортировки
— Хуки
Фильтрует аргументы перед выполнением запроса для получения соседнего поста
Фильтрует результаты после получения соседнего поста
— Примечания
– Ограничения
Не поддерживает сложные запросы с пользовательскими полями
– Частые проблемы
- Возвращает false при отсутствии постов в выбранной категории
- Проблемы с ID при использовании в циклах
