Press WordPress Блог

Третья часть обзора функций вывода категорий вашего блога WordPress. Подробный обзор функций php wp_list_categories().
Оригинальный англоязычный источник данного материала.

Функции вывода данных о категории.

Вывод списка категорий.
Синтаксис php wp_list_categories('arguments');
Функция Category Link List позволяет вывести или получить список категорий в виде ссылок на страницы категорий.
Передаваемые параметры в функцию.
• show_option_all
Показывает взаимосвязи между категориями и подкатегориями.
Синтаксис php wp_list_categories('show_option_all=');
• Orderby
Сортировка списка по алфавиту или возрастанию (в зависимости от памаметра ID, NAME или COUNT). По умолчанию сортировка происходит по параметру NAME.
Синтаксис wp_list_categories('orderby=count');
• order
Сортировка заголовков категорий по возрастанию или по убыванию по алфавиту.
Синтаксис wp_list_categories('order=DESC');
• show_last_updated
Параметр позволяет вывести список категорий (подкатегорий) в зависимости от времени обновления категории (обновленная последняя категория выводится в списке первой, последняя - последней). При значении show_last_updated, равным 0, данная опция является неактивной.
Синтаксис wp_list_categories('show_last_updated=1');
• Style
Параметр позволяет показать подкатегории вложенным списком. Принимает значения ‘List’ (вложенный список) и ‘None’ (обычный список).
Синтаксис wp_list_categories('style=none');
• show_count
Параметр выводит для каждого элемента списка категорий количество постов в данной категории. Принимает значения 1 (выводить количество постов) или 0(не выводить количество постов).
Синтаксис wp_list_categories('show_count=1');
• hide_empty
Параметр определяет, скрывать категории (подкатегории), которые не имею опубликованных материалов, или не скрывать. Принимает значения 1 (скрывать) или 0(не скрывать).
Синтаксис wp_list_categories('hide_empty=0');
• use_desc_for_title
Параметр указывает, сортировать список при выводе или нет. Принимает значения 1(сортировать) или 0(не сортировать). Основное отличие от предыдуших аналогичных параметов в том, что передаваемое значение параметра является булевая переменная, а не определенный параметр.
Синтаксис wp_list_categories('use_desc_for_title=0');
• child_of
Параметр позволяет вывести только подкатегории определенной категории (основная категория определяется по ID). Данный параметр не имеет значения по умолчанию. При использовании данного параметра, параметр hide_empty будет автоматически установлен в значение false или 0.
Синтаксис wp_list_categories('child_of=5');
• Feed
Параметр позволяет вывести заголовки категорий в виде ссылок на rrs-2. Позволяет прописать и сам текст ссылки. По умолчаний или при пустом тексте ссылки данный параметр автоматически становится неактивным.
Синтаксис wp_list_categories('feed=RSS');
• exclude
Данный параметр позволяет исключить из выводимого списка категорий (подкатегорий) категории, ID значения которых заданны в данных параметра. ID категорий(подкатегорий) должны выводиться в возрастающем порядке. Символом разделителя является символ запятой.
Синтаксис wp_list_categories('exclude=5');
• Heirarchial
Параметр позволяет вывести список категорий иерархическим вложенным списком. Принимает значения 1(иерархический список) или 0(обычный список).
Синтаксис wp_list_categories('heirarchial=0');
• title_li
Парамерт позволяет включить заголовки категорий(подкатегорий) в теги.

. Если данный параметр присутсивует, но значение пустое, то заголовки категорий будут показываться вне заданного списка. Дополнительный параметр titleli принимает значение части имени класса списка.
Синтаксис wp_list_categories('titleli=_cats');
• Number
Число, ограничивающее количественный вывод категорий в списке. Если параметр не задан, то будет выведен весь список.
Синтаксис wp_list_categories('number=7');
• echo
Параметр определяет, выводить результат функции или определить его в переменную.
Синтаксис wp_list_categories('echo=0');
• depth
Данный параметр указывает уровень отображаемой вложенности категрий и подкатегорий.
Принимает следующие параметры:

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

Синтаксис wp_dropdown_categories('depth=n');