wp_dropdown_pages()

18 февраля, 2025

Создание выпадающего списка страниц WordPress с помощью функции wp_dropdown_pages(): параметры, примеры, безопасность

Описание функции wp_dropdown_pages()

Функция wp_dropdown_pages() генерирует HTML-код для выпадающего списка всех страниц WordPress. Она полезна для создания интерфейсов выбора страниц в админ-панели или на фронтенде. Функция позволяет настраивать параметры отображения и фильтрации страниц, такие как сортировка, иерархия и т.д.

Список можно использовать в формах или в качестве элемента интерфейса для выбора страниц

Параметры

$args

Тип: array

Обязательный: Нет

По умолчанию: array()

Описание: Массив аргументов для настройки выпадающего списка страниц

Возможные значения:

selected: ID выбранной страницы

name: Имя элемента

class: CSS классы для элемента с опциями

• Пустая строка, если страниц нет

Примеры использования

Базовый пример создания выпадающего списка страниц

				
					$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

Рекомендации: При выводе используйте функции для экранирования данных, если это необходимо

— Связанные функции

get_pages()

Получает массив страниц с возможностью фильтрации

wp_list_pages()

Создает список страниц в виде HTML

— Хуки

wp_dropdown_pages_args

Фильтрует аргументы перед генерацией выпадающего списка

— Примечания

– Ограничения

Возвращает только публичные страницы по умолчанию

– Частые проблемы

Пустой список при отсутствии страниц
Неверные ID могут привести к неправильному отображению

Оставить комментарий Отменить

Нужна помощь с WordPress WooCommerce плагинами темой оптимизацией ?

Упрощаем сложное, создаем впечатляющее!

100% без риска

Нет обязательств по найму

Бесплатная оценка

5900 ₽

Услуги и врачи

Шаблон медицинского сайта включает онлайн-запись к врачу, каталог мед услуг, список врачей с опытом и рейтингом. Раздел вопрос/ответ обеспечивает оперативное взаимодействие с клиентами.