Описание функции get_previous_posts_link()
Функция get_previous_posts_link() используется для отображения ссылки на предыдущую страницу с записями, когда используется постраничная навигация. Эта функция обычно применяется в циклах WordPress, чтобы позволить пользователям переходить к предыдущим записям.
Ссылка создается только в том случае, если существует предыдущая страница, иначе возвращается пустая строка.
Параметры
$label
Тип: string
Обязательный: Нет
По умолчанию: ‘« Предыдущие’
Описание: Текст ссылки для предыдущей страницы
Возможные значения:
Возвращаемое значение
Тип: string
Описание: HTML-код ссылки на предыдущую страницу записей
Возможные значения:
• HTML-код ссылки при наличии предыдущих записей
• Пустая строка, если предыдущих записей нет
Примеры использования
echo get_previous_posts_link();
// Выводит ссылку на предыдущую страницу, если она существует
echo get_previous_posts_link('Назад к записям');
// Выводит ссылку с текстом 'Назад к записям', если она существует
if (get_previous_posts_link()) {
echo '<div class="nav-previous">';
echo get_previous_posts_link();
echo '</div>';
}
// Проверяет наличие предыдущей ссылки и выводит её в блоке
Безопасность
Валидация входных данных: Параметр label не требует дополнительной валидации, так как это просто строка
Санитизация: Входные данные автоматически обрабатываются WordPress
Рекомендации: При выводе пользовательского текста используйте esc_html() для защиты от XSS
— Связанные функции
Получает ссылку на следующую страницу записей
Выводит ссылку на предыдущую страницу записей
— Хуки
Фильтрует HTML-код ссылки перед выводом
— Примечания
– Ограничения
Ссылка отображается только при наличии предыдущих записей
– Частые проблемы
- Пустая строка, если предыдущих записей нет
- Неверный вывод, если не используется в цикле
