Описание функции wp_link_pages()
Функция wp_link_pages() используется для добавления навигации по страницам в многостраничные записи. Она позволяет пользователям перемещаться между различными частями записи, которые разделены с помощью тега
Эта функция обычно применяется в шаблонах для отображения постов, где необходимо разбить длинный контент на несколько страниц.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки навигации по страницам
Возможные значения:
before: HTML перед навигацией
after: HTML после навигации
link_before: HTML перед каждой ссылкой
link_after: HTML после каждой ссылки
next_or_number: number, next
pagelink: Шаблон меток страниц
echo: 1,
Возвращаемое значение
Тип: void
Описание: Функция выводит HTML-код навигации, ничего не возвращает
Возможные значения:
• HTML-код навигации при echo=true
• ничего не выводит при echo=false
Примеры использования
Выводит навигацию по страницам без дополнительных параметров
wp_link_pages();
Навигация будет отображаться в стандартном формате
Настройка навигации с использованием параметров
$args = array(
'before' => '<div class="page-links">',
'after' => '</div>',
'link_before' => '<span>',
'link_after' => '</span>',
'next_or_number' => 'number'
);
wp_link_pages($args);
Навигация будет обернута в
Безопасность
Валидация входных данных: Функция не требует дополнительных проверок, параметры обрабатываются корректно
Санитизация: HTML, передаваемый в параметры, должен быть безопасным
Рекомендации: Используйте esc_html() при выводе пользовательских данных в навигации
— Связанные функции
Отображает содержимое поста с поддержкой многостраничности
Получает содержимое поста без его отображения
— Примечания
– Ограничения
Не работает без наличия тега в контенте
– Частые проблемы
- Навигация не отображается при отсутствии разбиения на страницы
- Некорректный вывод при использовании неподходящих параметров
