Описание функции wp_dropdown_categories()
Функция wp_dropdown_categories() создает HTML-код для выпадающего списка категорий. Она часто используется в формах, где необходимо выбрать категорию, например, при добавлении или редактировании записей.
Функция поддерживает различные параметры для фильтрации и настройки отображения списка категорий.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив параметров для настройки выпадающего списка категорий
Возможные значения:
name: Имя элемента формы (по умолчанию ‘cat’)
selected: ID выбранной категории
id: ID элемента формы
class: CSS класс элемента формы
show_count: 1,
hide_empty: 1,
hierarchical: 1,
taxonomy: Тип таксономии (по умолчанию ‘category’)
Возвращаемое значение
Тип: string
Описание: HTML-код выпадающего списка категорий
Возможные значения:
• Строка HTML с выпадающим списком категорий
• Пустая строка при отсутствии категорий
Примеры использования
Создает простой выпадающий список всех категорий
wp_dropdown_categories();
// Выводит стандартный выпадающий список категорий
Выводится HTML-код списка
Создает выпадающий список категорий с отображением количества записей
$args = array(
'show_count' => true,
'hide_empty' => false,
'name' => 'my_category'
);
wp_dropdown_categories($args);
Список будет содержать все категории, включая пустые
Проверка доступности функции перед вызовом
if ( ! function_exists('wp_dropdown_categories') ) {
echo 'Функция wp_dropdown_categories не доступна';
}
wp_dropdown_categories();
Предотвращает ошибки в случае отсутствия функции
Использование выпадающего списка в форме для отправки категории
<form action='your_action' method='post'>
<?php wp_dropdown_categories(array('name' => 'category_select')); ?>
<input type='submit' value='Отправить'>
</form>
Форма отправляет выбранную категорию
Безопасность
Валидация входных данных: Параметры проверяются на уровне WordPress
Санитизация: Функция автоматически очищает данные перед выводом
Рекомендации: Используйте esc_html() для вывода значений, извлеченных из базы данных
— Связанные функции
Получает массив категорий
Создает список категорий в виде HTML
— Хуки
Фильтрует аргументы перед созданием выпадающего списка
— Примечания
– Ограничения
Не поддерживает кастомные таксономии по умолчанию
– Частые проблемы
- Пустой список при отсутствии категорий
- Некорректное отображение при неправильной настройке параметров
