# Функция wp_list_categories()
## Введение
Функция wp_list_categories() в WordPress позволяет отображать список категорий в виде HTML-ссылок. Когда вы щелкаете по ссылке, открывается страница со всеми записями, относящимися к этой кат��гории.
### Используемые функции
- get_categories() — для получения списка категорий.
- walk_category_tree() — для отображения иерархии категорий.
## Хуки функции
- wp_list_categories — фильтр, позволяющий изменять вывод функции.
## Возврат
Функция возвращает null, строку или false:
- Если echo=1, выводится HTML-код.
- Если echo=0, HTML-код возвращается в переменную для дальнейшей обработки.
## Шаблон использования
Пример массива параметров для вызова wp_list_categories():
$args = [
'show_option_all' => '',
'show_option_none' => __('Нет категорий'),
'orderby' => 'name',
'order' => 'ASC',
'style' => 'list',
'show_count' => 0,
'hide_empty' => 1,
'use_desc_for_title' => 1,
'child_of' => 0,
'feed' => '',
'feed_type' => '',
'feed_image' => '',
'exclude' => '',
'exclude_tree' => '',
'include' => '',
'hierarchical' => true,
'title_li' => __('Категории'),
'number' => NULL,
'echo' => 1,
'depth' => 0,
'current_category' => 0,
'pad_counts' => 0,
'taxonomy' => 'category',
'walker' => 'Walker_Category',
'hide_title_if_empty' => false,
'separator' => '
',
];
echo '';
wp_list_categories($args);
echo '
';
## Пример использования
Чтобы отобразить список категорий, используется следующий код:
## Передаваемые параметры
$args — это массив параметров, которые могут принимать все аргументы из функции get_terms():
- **child_of (int)** — показать дочерние категории указанной категории (по ID).
- **current_category (int/array)** — ID категории или массив ID категорий, к которым нужно добавить класс "текущая категория" (current-cat).
- **depth (int)** — уровень вложенности, который нужно отображать. По умолчанию 0 — показываются все уровни.
- **echo (true/false/int)** — выводить или возвращать для обработки.
- **exclude (array/string)** — исключить категории из списка по ID, разделяя их запятыми или пробелами.
- **exclude_tree (array/string)** — исключить дерево категорий, также указывая ID.
- **include (строка)** — показать только указанные категории по ID.
- **hide_empty (true/false/int)** — скрывать пустые категории.
- **hide_title_if_empty (true/false)** — скрывать заголовок списка, если категорий нет.
- **hierarchical (true/false)** — отображать категории в виде дерева.
- **order (string)** — направление сортировки категорий (ASC или DESC).
- **orderby (string)** — критерий сортировки (например, по количеству записей или имени).
- **separator (string)** — разделитель между ссылками.
- **show_count (true/false/int)** — показывать количество записей в категории.
- **show_option_all (string)** — текст для ссылки "Показать все категории".
- **show_option_none (string)** — текст, который показывается, если нет категорий.
- **style (string)** — стиль отображения списка (например, в виде неупорядоченного списка или просто ссылок).
- **taxonomy (string)** — имя таксономии (по умолчанию 'category').
- **title_li (string)** — текст для заголовка списка.
## Примеры использования
1. **Удаление заголовка списка категорий**
Для того чтобы убрать заголовок списка, установите параметр title_li в null или '':
2. **Сортировка по алфавиту**
Чтобы отсортировать категории в алфавитном порядке, используйте следующий код:
3. **Показ категорий с количеством записей**
Для отображения количества записей в каждой категории:
4. **Вывод определённых категорий**
Для отображения только категорий с определёнными ID и изменения заголовка на "Поэзия":
' . __('Поэзия') . ''); ?>
## Заключение
Функция wp_list_categories() является мощным инструментом для отображения категорий в WordPress. С её помощью вы можете легко кастомизировать вывод категорий, используя простые параметры для настройки. Приведенные примеры помогут вам начать использовать эту функцию и адаптировать её под ваши нужды.
