Press WordPress Блог

Завершающая обзор функций вывода категорий блога WordPress статья. Подробный обзор функций: in_category() и get_category_parents().
Оригинальный англоязычный источник данного материала.

Функция проверки вхождения в категорию. «If In Category».
Синтаксис.
if ( in_category('category_id') ):
// Специфический код PHP/HTML какой либо категории или категорий
endif;
Функция возращает значение true, если находящаяся побликация внутри оператора if относится к категории, ID которой прописан в in_category(‘category_id’). Соответсвенно возращает значение false, если публикация НЕ отночится к кактегории в условии проверки. Обычно данная функция используется в цикле вывода публикаций. Если функция используется ВНЕ цикла вывода публикаций, переменная $post должна быть определенна.
Функция принимает единственный параметр – ID категории. В данном случае значения по умолчанию нет. Значение ID обязательно должно быть типа integer и быть больше 0.

Функция вывода списка родительских категорий.
Синтаксис echo(get_category_parents(category, display link, separator, nice name));
Функция выводит список родительских категорий, сортируя их по ID.
Передаваемые параметры.
• category
Значение ID категории, список «родителей» которой нужно в результате получить. По умолчанию, если параметр не задан явно, принимает значение ID текущей категории.
Синтаксис echo(get_category_parents(3, display link, separator, nice name));
• display link
Создает ссылку к «привязанной» категории. Параметр может иметь значение TRUE(отображать заголовок ссылкой) и FALSE(отображать заголовок простым текстом).
Синтаксис echo(get_category_parents(category, TRUE, separator, nice name));
• Seperator
Определение разделителя.
Синтаксис echo(get_category_parents(category, display link, &;bull;, nice name));
• nice name
«Хорошее название» категории.
Если данный параметр имеет значение TRUE, то возращает при выводе списка еще и «нормальный» заголовок категории или категорий (если подкатегория относится к двум и более категориям). Если значение данного параметра заданно как FALSE, то в данном отношении функция дополнительно ничего не выводит.
Синтаксис echo(get_category_parents(category, display link, seperator, TRUE));
• Category Array
Вывод данных категории (текущей для выбранной публикации) через свойства объекта, который получаем с помощью метода get_the_category(). Вывод организовывается с помощью оператора foreach. Данный метод должен вызываться только внутри цикла вывода публикаций.
Синтаксис.
foreach((get_the_category()) as $category) {
echo $category->cat_name . ' ';
}

Элементы получаемого объекта.

• cat_ID - ID категории
• cat_name - Заголовок категории
• category_description - Описание категории
• category_parent - «Родитель» категории. Если принимает значение равное 0, то тогда категория сама является родителем.
• category_count - Количество пользователей, относящихся к данной категории.