Описание функции get_posts_nav_link()
Функция get_posts_nav_link() используется для генерации навигационных ссылок между постами. Она обычно используется на страницах с записями (например, в блогах) для удобства навигации между старшими и младшими записями. Функция может быть полезна в шаблонах тем и плагинов для создания пользовательской навигации между записями.
Функция появилась в версии 2.8.0
Параметры
$previous
Тип: WP_Post|null
Обязательный: Да
По умолчанию: null
Описание: Объект предыдущего поста для навигации
Возможные значения:
$next
Тип: WP_Post|null
Обязательный: Да
По умолчанию: null
Описание: Объект следующего поста для навигации
Возможные значения:
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив дополнительных аргументов для настройки навигации
Возможные значения:
class: CSS класс для ссылки
label_previous: Текст для предыдущей ссылки
label_next: Текст для следующей ссылки
Возвращаемое значение
Тип: string|null
Описание: HTML код навигационной ссылки или null, если нет постов
Возможные значения:
• HTML код ссылки на предыдущий пост и ссылку на следующий пост
• null если нет предыдущего или следующего поста
Примеры использования
Получение навигационной ссылки между постами
$previous_post = get_previous_post();
$next_post = get_next_post();
$link = get_posts_nav_link($previous_post, $next_post);
echo $link;
Ссылка будет пустой, если нет предыдущего или следующего поста
Получение навигационной ссылки с настройкой классов и текста
$args = array(
'class' => 'nav-link',
'label_previous' => 'Назад',
'label_next' => 'Вперед'
);
$link = get_posts_nav_link($previous_post, $next_post, $args);
echo $link;
Ссылки будут иметь класс ‘nav-link’
Безопасность
Валидация входных данных: Функция проверяет, что переданные параметры являются объектами WP_Post или null
Санитизация: HTML автоматически очищается для предотвращения XSS
Рекомендации: При выводе используйте esc_url() для URL и esc_html() для текста
— Связанные функции
Получает предыдущий пост относительно текущего
Получает следующий пост относительно текущего
— Примечания
– Ограничения
Если нет предыдущего или следующего поста, функция вернет null
– Частые проблемы
- Проблемы с отображением, если переданы некорректные объекты
- Неправильное отображение, если посты не связаны должным образом
