Функция get_categories
29 декабря 2011| Рубрика: Wordpress
Описание функции
Функция возвращает массив объектов с информацией о категориях, которые подходят под переданные в функцию параметры.
Синтаксис функции
Функция позволяет принимать параметры как массивом, так и строчкой
'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 родительской рубрики
}