Описание функции wp_dropdown_pages()
Функция wp_dropdown_pages() генерирует HTML-код для выпадающего списка всех страниц WordPress. Она полезна для создания интерфейсов выбора страниц в админ-панели или на фронтенде. Функция позволяет настраивать параметры отображения и фильтрации страниц, такие как сортировка, иерархия и т.д.
Список можно использовать в формах или в качестве элемента интерфейса для выбора страниц
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки выпадающего списка страниц
Возможные значения:
selected: ID выбранной страницы
name: Имя элемента
id: ID элемента
class: CSS классы для элемента
depth: Глубина иерархии для отображения
show_option_none: Текст для пустого выбора
sort_column: Столбец для сортировки (например, ‘menu_order’)
sort_order: ASC, DESC
exclude: ID страниц для исключения
include: ID страниц для включения
Возвращаемое значение
Тип: string
Описание: HTML-код выпадающего списка страниц
Возможные значения:
• HTML-код
• Пустая строка, если страниц нет
Примеры использования
Базовый пример создания выпадающего списка страниц
$args = array(
'name' => 'my_page_dropdown'
);
wp_dropdown_pages($args);
Выводит выпадающий список с именем ‘my_page_dropdown’
Выпадающий список с текстом по умолчанию и сортировкой
$args = array(
'show_option_none' => 'Выберите страницу',
'sort_column' => 'menu_order',
'sort_order' => 'ASC'
);
wp_dropdown_pages($args);
Список страниц будет отсортирован по порядку меню
Безопасность
Валидация входных данных: Параметры проверяются на валидность внутри функции
Санитизация: Входные параметры очищаются WordPress
Рекомендации: При выводе используйте функции для экранирования данных, если это необходимо
— Связанные функции
Получает массив страниц с возможностью фильтрации
Создает список страниц в виде HTML
— Хуки
Фильтрует аргументы перед генерацией выпадающего списка
— Примечания
– Ограничения
Возвращает только публичные страницы по умолчанию
– Частые проблемы
- Пустой список при отсутствии страниц
- Неверные ID могут привести к неправильному отображению
