Словари таксономии — это один из объектов, поддерживаемых API WP. Они могут по разному называться — рубриками, категориями, терминами, но хранятся в одних и тех же таблицах базы данных. К ним применяется одни и те же функции API и методика работы.
Программный вывод списка рубрик
В API WP есть как минимум две функции вывода списка терминов — wp_list_categories() и wp_dropdown_categories().
Функция wp_list_categories.
Эта функция выводит термины в виде Unordered List (UL) списка. Чтобы не дублировать «кодекс», описание входных параметров здесь приводить не буду.
Пример использования:
1 2 3 4 5 |
$args = array( 'taxonomy' => 'portfolio-category', 'hierarchical' => 1, ); wp_list_categories( $args ); |
Функция wp_dropdown_categories.
Эта функция выводит термины в виде элемента Select, т.е. может быть использована для создания шаблона формы. Детальные описания параметров смотрите в справочнике WP.
Пример использования:
1 2 3 4 5 6 7 8 |
$args = array( 'taxonomy' => 'category', 'name' => '_categ', 'hierarchical' => 1, 'show_option_none' => '-- не показывать --', 'selected' => false, ); wp_dropdown_categories( $args ); |
Вывод списка дочерних категорий (рубрик, терминов)
Если словарь сконфигурирован с поддержкой иерархии, то есть возможность вывода дочерних терминов, что удобно для навигации в связанных таксономией публикациях.
Обе функции используют get_terms() для получения данных, потому они поддерживают параметр child_of, который позволяет указать корневой элемент для вывода терминов.
1 2 3 4 |
$args = array( 'child_of' => $term->ID, ); wp_list_categories( $args ); |