Описание функции get_adjacent_post_link()
Функция get_adjacent_post_link() возвращает HTML-ссылку на соседнюю запись (предыдущую или следующую) в зависимости от заданного направления. Используется для навигации между записями в блоге или на сайте.
Данная функция часто применяется в темах WordPress для улучшения удобства навигации для пользователей
Параметры
$in_same_term
Тип: bool
Обязательный: Нет
По умолчанию: false
Описание: Указывает, что соседние записи должны быть в том же таксономическом термине
Возможные значения:
0: 1
1:
$excluded_terms
Тип: string|array
Обязательный: Нет
По умолчанию: »
Описание: Список термов, которые следует исключить из выборки
Возможные значения:
0: ID термов или массив ID термов
$taxonomy
Тип: string
Обязательный: Нет
По умолчанию: ‘category’
Описание: Имя таксономии, по которой будет происходить фильтрация
Возможные значения:
0: имя таксономии
Возвращаемое значение
Тип: string|null
Описание: HTML-код ссылки на соседнюю запись или null, если соседняя запись не найдена
Возможные значения:
• HTML-ссылка на соседнюю запись при успешном выполнении
• null если соседняя запись не найдена
Примеры использования
Базовый пример получения ссылки на следующую запись
get_adjacent_post_link('%link', 'Следующая запись');
Выводит ссылку на следующую запись, если она существует
Получение ссылки на предыдущую запись в той же категории
get_adjacent_post_link('%link', 'Предыдущая запись', true, '', 'category');
Фильтрация по таксономии ‘category’
Безопасность
Валидация входных данных: Все параметры проверяются на корректность
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе результатов используйте esc_url() для ссылок
— Связанные функции
Получает объект предыдущей записи
Получает объект следующей записи
— Хуки
Фильтрует запрос при получении предыдущей записи
Фильтрует запрос при получении следующей записи
— Примечания
– Ограничения
Если записи не найдены, функция возвращает null
– Частые проблемы
- Ошибки при фильтрации по термам, если они указаны неверно
- Проблемы с навигацией при отсутствии соседних записей
