Описание функции

Функция возвращает массив объектов с информацией о категориях, которые подходят под переданные в функцию параметры.

Синтаксис функции

Функция позволяет принимать параметры как массивом, так и строчкой

 'post',
'child_of' => 0,
'parent' => '',
'orderby' => 'name',
'order' => 'ASC',
'hide_empty' => 1,
'hierarchical' => 1,
'exclude' => '',
'include' => '',
'number' => 0,
'taxonomy' => 'category',
'pad_counts' => false
);
?>

Параметры

type — определяет тип выводимых категорий

  • post (значение по умолчанию) — возвращает массив категорий для записей
  • link — возвращает массив категорий для ссылок

child_of — при указании данного параметра возвращает список всех дочерних категорий к указанной, включая все подкатегории

(значение по умолчанию 0)

parent — возвращает все родительские категории, в отличие от child_of возвращает родителей первого уровня вложенности

order_by — позволяет сортировать возвращаемый массив

  • ID — сортирует по ID
  • name (значение по умолчанию) — сортирует в алфавитном порядке
  • slug — сортирует по альт. имени
  • count — по числу записей в категории
  • group — по группе

order — направление сортировки массива

  • ASC (значение по умолчанию) — по порядку
  • DESC — в обратном порядке

hide_empty — определяет выводить ли пустые рубрики, или нет

  • 0 или true (значение по умолчанию) — получать пустые
  • 1 или false — не получать

hierarchical — определяет выводить ли пустые категории, если в дочерних категориях которых есть записи

  • true (значение по умолчанию) — выводить
  • false — не выводить

exclude — позволяет указывать какие категории исключить из возвращаемого массива. Если указан child_of он выключается. Категории указываются через запятую

(значение по умолчанию » » )

include — противоположный параметр, но указываются только те категории, которые  нужно вывести в массив

(значение по умолчанию » » )

number — указывает число максимальных категорий в возвращаемом массиве

(значение по умолчанию «0» )

taxonomy — название таксономии, которую нужно фильтровать

(значение по умолчанию «category» )

pad_counts — если указан данный параметр (передано true), то в качестве количества записей в категории, будет отображаться сумма всех записей дочерних категорий

(значение по умолчанию «false»)

Значения возвращаемых объектов

После того как была вызвана функция, и (например) в переменную был возвращён массив из объектов (категорий) из них можно узнать необходимые нам парамеры, а именно

foreach($categories as $category){
$category->term_id; //ID терма
$category->name; //имя терма
$category->slug; //имя терма, пригодное для использовании в URL
$category->term_group; //группа терма
$category->term_taxonomy_id; //уникальный идентификатор таксономии терма
$category->taxonomy; //тип таксономии (существует три типа: рубрики записей, метки записей и рубрики категорий)
$category->description; //Описание терма
$category->parent; //родительский !терм
$category->count; //количество объектов в таксономии
$category->cat_ID; //наконец то что-то понятное, скажете вы - ID рубрики
$category->category_count; //число записей в рубрике
$category->category_description; //описание  рубрики
$category->cat_name; //название рубрики
$category->category_nicename; //ярлык рубрики
$category->category_parent; //ID родительской рубрики
}