Продолжение обзора функций вывода категорий вашего блога WordPress и текущей информации о них. Подробный обзор функции wp_dropdown_categories.
Оригинальный англоязычный источник данного материала.
Выпадающий список категорий(подкатегорий).
Синтаксис wp_dropdown_categories('arguments');
Функция, организовывающая выпадающий иерархический список в виде элемента select, содержащий категории и соответствующие подкатегории.
Передаваемые параметры.
• show_option_all
Позволяет выводить в выпадающем списке все категории. Возращает HTML код выпадающего списка.
Синтаксис wp_dropdown_categories('show_option_all=');
• show_option_none
Выводит HTML код списка всех категорий и подкатегорий, но не позволяет произвести выбор из представленного списка.
Синтаксис wp_dropdown_categories('show_option_none=');
• Orderby
Вывод с сортировкой по определенному критерию.
Синтаксис wp_dropdown_categories('orderby=name');
Может принимать значения ID или NAME.
• order
Вывод с сортировкой по возрастанию или по убыванию.
Синтаксис wp_dropdown_categories('order=DESC');
Может принимать значения ASC или DESC.
• show_last_update
Параметр позволяет сделать вывод списка категорий и подкатегорий с датой последнего обновления (дата последней публикации в определенной категории).
Синтаксис wp_dropdown_categories('show_last_update=1');
Может принимать значения 1 или 0.
• show_count
Параметр позволяет определить, выводить ли в списке количество постов, содержащихся в категории.
Синтаксис wp_dropdown_categories('show_count=1');
Может принимать значения 1 или 0.
• hide_empty
Параметр позволяет определить, выводить категории(подкатегории), которые содержат в себе публикации или не содержат.
Синтаксис wp_dropdown_categories('hide_empty=0');
Может принимать значение 1 или 0.
• child_of
Параметр определяет вывод подкатегорий опредеоенной основной категории, которая задается с помощью ее ID значения. По умолчанию не принимает никакого значения, потому требует в синтаксисе всегда указывать определенный ID категории.
Cинтаксис wp_dropdown_categories('child_of=5');
Принимает значение параметра в виде переменной типа integer.
• Exclude
Передаваемый параметр позволяет исключать посторяющиеся подкатегории в выбранных категориях. Символ ‘,’ (символ запятой) является разделителем при перечислении ID выбранных категорий. По умолчанию, если не задать ни одной категории, данный параметр не имеет силы.
Синтаксис wp_dropdown_categories('exclude=5');
Принимает значение integer – значение ID категории.
• Echo
Параметр определяет – показывать вложенные закладки или нет.
Синтаксис wp_dropdown_categories('echo=0');
Принимаемые значения 1(показывать) или 0(не показывать).
• Selected
Параметр определяет выбранную категорию при выводе списка. По умолчанию, если данный параметр не задан, категория выбрана не будет.
Синтаксис wp_dropdown_categories('selected=5');
Принимает значение ID категории – переменную типа integer.
• Heirarchial
Параметр определяет, выводить список просто списком, или в виде иерархического списка «родитель/подкатегория».
Синтаксис wp_dropdown_categories('heirarchial=1');
Принимает значения 1(иерархический список) или 0(простой список).
• Name
Параметр позволяет присвоить форме, содержащий выпадающий список, параметр name. По умолчанию будет присвоено значение ‘Cat’.
Синтаксис wp_dropdown_categories('name=cat-dropdown');
Параметр принимает значения в формате String.
• Class
Параметр позволяет присвоить форме, содержащий выпадающий список, параметр Class. По умолчанию будет присвоено значение ‘postform’.
Синтаксис wp_dropdown_categories('class=cat-dropdown');
Параметр принимает значения в формате String.
• Depth
Данный параметр функции позволяет задать количество уровней вложенности относительно основных категорий.
Синтаксис wp_dropdown_categories('depth=n');, где число n равно числу уровней вложенности.
Параметр может принимать следующие значения.
- ‘0’ – значение по умолчанию, выводит все основные категории и подкатегории.
- ‘-1’ – все категории выводятся в НЕ иерархическом списке.
- ‘1’ – вывод только категорий нулевого уровня (основные категории)
- ‘N’ – заданное число уровней вложенности иерархического списка.
