wp_list_categories

Описание:
Функция wp_list_categories позволяет вывести или получить список категорий в виде ссылок на страницы категорий.

Использование:

<?php wp_list_categories('arguments'); ?>

Пример:

<ul>
<?php wp_list_categories('orderby=name&include=3,5,9,16'); ?>
</ul>

Параметры:
show_option_all
(строка) Показывает взаимосвязи между категориями и подкатегориями.

orderby
(строка) Сортировка списка по алфавиту или возрастанию (в зависимости от памаметра ID, NAME или COUNT). По умолчанию сортировка происходит по параметру NAME. Доступные опции:

* ID
* name - по умолчанию
* slug
* count

order
(строка) Сортировка заголовков категорий по возрастанию или по убыванию по алфавиту. Доступные опции:

* ASC - по умолчанию
* DESC

show_last_updated
(булево) Параметр позволяет вывести список категорий (подкатегорий) в зависимости от времени обновления категории (обновленная последняя категория выводится в списке первой, последняя - последней). При значении show_last_updated, равным 0, данная опция является неактивной.
* 1 (true)
* 0 (false) - по умолчанию

style
(строка) Параметр позволяет показать подкатегории вложенным списком. Принимает значения ‘List’ (вложенный список) и ‘None’ (обычный список). Доступные опции:

* list - по умолчанию.
* none

show_count
(булево) Параметр выводит для каждого элемента списка категорий количество постов в данной категории. Принимает значения 1 (выводить количество постов) или 0(не выводить количество постов). Доступные опции:

* 1 (true)
* 0 (false) - по умолчанию

hide_empty
(булево) Параметр определяет, скрывать категории (подкатегории), которые не имею опубликованных материалов, или не скрывать. Принимает значения 1 (скрывать) или 0(не скрывать). Доступные опции:

* 1 (true) - по умолчанию
* 0 (false)

use_desc_for_title
(булево) Параметр указывает, сортировать список при выводе или нет. Принимает значения 1(сортировать) или 0(не сортировать). Основное отличие от предыдуших аналогичных параметов в том, что передаваемое значение параметра является булевая переменная, а не определенный параметр. Доступные опции:

* 1 (true) - по умолчанию
* 0 (false)

child_of
(целое) Параметр позволяет вывести только подкатегории определенной категории (основная категория определяется по ID). Данный параметр не имеет значения по умолчанию. При использовании данного параметра, параметр hide_empty будет автоматически установлен в значение false или 0.

feed
(строка) Параметр позволяет вывести заголовки категорий в виде ссылок на rrs-2. Позволяет прописать и сам текст ссылки. По умолчаний или при пустом тексте ссылки данный параметр автоматически становится неактивным.

exclude
(строка) Данный параметр позволяет исключить из выводимого списка категорий (подкатегорий) категории, ID значения которых заданны в данных параметра. ID категорий(подкатегорий) должны выводиться в возрастающем порядке. Символом разделителя является символ запятой.

include
(строка) Параметр с помощью которого выводятся только нужные категории. ID категорий(подкатегорий) должны выводиться в возрастающем порядке. Символом разделителя является символ запятой.

hierarchical
(булево) Параметр позволяет вывести список категорий иерархическим вложенным списком. Принимает значения 1(иерархический список) или 0(обычный список). Доступные опции:

* 1 (true) - по умолчанию
* 0 (false)

title_li
(строка) Парамерт позволяет включить заголовки категорий(подкатегорий) в теги. Если данный параметр присутсивует, но значение пустое, то заголовки категорий будут показываться вне заданного списка. Дополнительный параметр titleli принимает значение части имени класса списка.

number
(целое) Число, ограничивающее количественный вывод категорий в списке. Если параметр не задан, то будет выведен весь список.

echo
(булево) Параметр определяет, выводить результат функции или определить его в переменную. Доступные опции:

* 1 (true) - по умолчанию
* 0 (false)

depth
(целое) Данный параметр указывает уровень отображаемой вложенности категрий и подкатегорий.

* 0 - по умолчанию. Показывает обычным списком все категории и подкатегории, учитывая иерархию вложенности.
* -1 - список показывает все категории и подкатегории без учера вложенности.
* 1 - список показывает только основные категории без подкатегорий.
* n - число, обозначающее уровень вложенности отображаемого иерархичского списка.

« Вернуться к выбору тегов

Похожие теги:

the_category, the_category_rss, the_category_ID, single_cat_title, category_description, wp_dropdown_categories, wp_list_categories, in_category, get_category_parents, get_the_category, get_category_link,

Предыдущие записи из рубрики `Теги категорий - Category tags`