Описание функции get_previous_posts_page_link()
Функция get_previous_posts_page_link() возвращает ссылку на предыдущую страницу записей в рамках постраничной навигации. Она полезна для создания элементов навигации между страницами в цикле записей. Функция автоматически генерирует URL для предыдущей страницы, если таковая существует.
Параметры
$label
Тип: string
Обязательный: Нет
По умолчанию: ‘« Предыдущая’
Описание: Текст ссылки для предыдущей страницы
Возможные значения:
Возвращаемое значение
Тип: string|false
Описание: HTML-код ссылки на предыдущую страницу записей или false, если такой страницы нет
Возможные значения:
• Строка с HTML-кодом ссылки, если предыдущая страница существует
• false, если предыдущей страницы нет
Примеры использования
Получение и вывод ссылки на предыдущую страницу записей
$prev_link = get_previous_posts_page_link();
if ($prev_link) {
echo $prev_link;
}
Ссылка будет отображаться только если предыдущая страница существует
Получение ссылки с пользовательским текстом
$prev_link = get_previous_posts_page_link('Назад к записям');
if ($prev_link) {
echo $prev_link;
}
Ссылка будет отображаться с текстом ‘Назад к записям’
Безопасность
Валидация входных данных: Параметр label не требует отдельной валидации
Санитизация: WordPress автоматически обрабатывает вывод HTML-кода
Рекомендации: При выводе ссылки используйте esc_html() для безопасного отображения текста
— Связанные функции
Получает ссылку на следующую страницу записей
Создает ссылки для постраничной навигации
— Примечания
– Ограничения
Функция работает только в контексте циклов записей с постраничной навигацией
– Частые проблемы
- Возвращает false, если текущая страница первая
- Неправильные ссылки могут возникнуть при неверной настройке WP_Query
