Описание функции wp_list_categories()
Функция wp_list_categories() выводит HTML-список категорий WordPress с возможностью настроек. Позволяет отображать категории в виде списка или выпадающего меню, поддерживает иерархическую структуру и различные параметры отображения.
Функция часто используется в сайдбаре или в других местах темы для навигации по категориям.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки вывода категорий
Возможные значения:
show_count: 1,
show_last_update: 1,
hide_empty: 1,
hierarchical: 1,
title_li: Заголовок списка
style: list, none
orderby: name, id, slug, count
order: ASC, DESC
exclude: ID категорий для исключения
include: ID категорий для включения
Возвращаемое значение
Тип: void
Описание: Выводит HTML-код списка категорий напрямую
Возможные значения:
• HTML-код списка категорий
• Ничего не возвращается
Примеры использования
Выводит стандартный список всех категорий
wp_list_categories();
Список категорий будет отображен в HTML
Выводит список категорий с указанием количества записей в каждой
$args = array(
'show_count' => true,
'hide_empty' => false
);
wp_list_categories($args);
hide_empty=false показывает все категории, включая пустые
Выводит список категорий с заголовком ‘Категории’
$args = array(
'title_li' => 'Категории',
'style' => 'list'
);
wp_list_categories($args);
Результат будет в виде списка
Безопасность
Валидация входных данных: Параметры проверяются внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для защиты от XSS
— Связанные функции
Получает массив категорий без их вывода
Выводит выпадающий список категорий
— Хуки
Фильтрует вывод списка категорий
Фильтрует аргументы перед выводом списка категорий
— Примечания
– Ограничения
Не поддерживает произвольные мета-поля для категорий
– Частые проблемы
- Пустой список при отсутствии категорий
- Ошибки при неправильных параметрах
