Описание функции wp_list_pages()
Функция wp_list_pages() генерирует HTML-список страниц в виде вложенного списка. Она позволяет выводить страницы с учетом их иерархии, а также настраивать параметры отображения, такие как порядок, уровень вложенности и отображение/скрытие определенных страниц.
Функция используется в темах и плагинах для представления структуры страниц сайта.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки вывода списка страниц
Возможные значения:
sort_column: Столбец для сортировки (например, ‘menu_order’, ‘post_title’)
sort_order: ASC, DESC
exclude: ID страниц для исключения из списка
include: ID страниц для включения в список
depth: Максимальный уровень вложенности
title_li: Заголовок списка (по умолчанию пустой)
link_after: Текст, добавляемый после ссылки на страницу
Возвращаемое значение
Тип: string
Описание: HTML-код списка страниц
Возможные значения:
• HTML-список страниц если страницы найдены
• Пустая строка если страницы не найдены
Примеры использования
Выводит список всех страниц сайта
wp_list_pages();
Список будет выведен в виде ненумерованного списка
Выводит страницы, отсортированные по порядку меню в прямом порядке с уровнем вложенности 1
$args = array(
'sort_column' => 'menu_order',
'sort_order' => 'ASC',
'depth' => 1
);
wp_list_pages($args);
Отобразит только верхний уровень страниц
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Используйте esc_html() для вывода заголовков страниц
— Связанные функции
Получает массив объектов страниц
Выводит меню страниц в виде списка
— Хуки
Фильтрует аргументы перед выводом списка страниц
Фильтрует результаты перед выводом HTML-кода списка страниц
— Примечания
– Ограничения
Не поддерживает пользовательские типы записей по умолчанию
– Частые проблемы
- Пустой результат если нет страниц
- Ошибки с порядком отображения при неверных параметрах
