Описание функции parent_dropdown()
Функция parent_dropdown() генерирует HTML-код для выпадающего списка, позволяя выбрать родительскую страницу для текущей страницы или записи. Она используется в админ-панели для установки иерархии страниц. Эта функция полезна при редактировании страниц и записи, где требуется указать родительскую страницу.
Функция поддерживает фильтрацию по типам записей и предоставляет возможность выбора из иерархии страниц
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки выпадающего списка
Возможные значения:
name: Имя поля для формы
selected: ID выбранной родительской страницы
show_option_none: Текст для пустого значения
option_none_value: Значение для пустого выбора
post_type: Тип поста для фильтрации
orderby: Поле для сортировки (title, ID)
order: Порядок сортировки (ASC, DESC)
Возвращаемое значение
Тип: string
Описание: HTML-код выпадающего списка для выбора родительской страницы
Возможные значения:
• HTML-код выпадающего списка при успешном выполнении
• Пустая строка если не найдено ни одной страницы
Примеры использования
Создание базового выпадающего списка для выбора родительской страницы
$dropdown = parent_dropdown();
echo $dropdown;
// Выводит HTML-код выпадающего списка для родительских страниц
Выводит все доступные родительские страницы
Создание выпадающего списка с заданным ID выбранной страницы
$args = array(
'name' => 'parent_id',
'selected' => 10,
'show_option_none' => 'Нет родителя'
);
$dropdown = parent_dropdown($args);
echo $dropdown;
Параметр selected задает ID страницы, которая будет выбрана по умолчанию
Проверка наличия доступных родительских страниц перед выводом
$dropdown = parent_dropdown();
if (empty($dropdown)) {
echo 'Нет доступных родительских страниц';
} else {
echo $dropdown;
}
Обработка случая, когда нет страниц для выбора
Безопасность
Валидация входных данных: Аргументы проходят базовую валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для текста, чтобы избежать XSS-уязвимостей
— Связанные функции
Создает выпадающий список страниц с дополнительными параметрами
Получает массив страниц с возможностью фильтрации
— Примечания
– Ограничения
Возвращает только страницы, а не другие типы записей
– Частые проблемы
- Пустой результат при отсутствии страниц в иерархии
- Ошибка при неверной настройке параметров
