get_category_link

Описание:
Выводит правильный url для заданного ID категории.

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

<a href="<?php echo get_category_link($cat);?>">имя категории</a>

Параметры:
$category_id
(integer) (обязательный) ID категории на которую возвратится ссылка. Значения по умолчанию нет.

get_the_category

Описание:
Возвращает массив объектов, один объект, для каждой категории назначеной сообщению. Должно использоваться внутри цикла.

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

<?php
foreach((get_the_category()) as $category) {
echo $category->cat_name . ' ';
}
?>

Пример:
Выводит имя только первой категориию.

<?php
$category = get_the_category();
echo $category[0]->cat_name;
?>

Параметры:
cat_ID
id категории(так же сохраняется как 'term_id')
cat_name
имя категории(так же сохраняется как 'name')
category_nicename
строка генерируемая из имени категории(так же сохраняется как 'slug')
category_description
описание категории(также сохраняется как 'description')
category_parent
id категории родителя текущей категории. '0' = без родителей.(так же сохраняется как 'parent')
category_count
число использований этой категории(так же сохраняется как 'count')

get_category_parents

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

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

<?php echo(get_category_parents(category, display link, separator, nice name)); ?>

Пример:

<?php echo(get_category_parents($cat, TRUE, ' &raquo; ')); ?>

Результат: Интернет » Блогинг » WordPress »

Параметры:
category
(целое) Значение ID категории, список «родителей» которой нужно в результате получить. По умолчанию, если параметр не задан явно, принимает значение ID текущей категории.

display link
(булево) Создает ссылку к «привязанной» категории. Параметр может иметь значение TRUE(отображать заголовок ссылкой) и FALSE(отображать заголовок простым текстом).

separator
(строка) Определение разделителя.

nice name
(булево) «Хорошее название» категории. Если данный параметр имеет значение TRUE, то возращает при выводе списка еще и «нормальный» заголовок категории или категорий (если подкатегория относится к двум и более категориям). Если значение данного параметра заданно как FALSE, то в данном отношении функция дополнительно ничего не выводит.

in_category

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

Пример:

<?php if (in_category('1')) : ?>
// Если ID категории равен 1, то выводим любой HTML или PHP код.
<?php endif; ?>
// Если нет то пропускаем.

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 - число, обозначающее уровень вложенности отображаемого иерархичского списка.

wp_dropdown_categories

Описание:
Функция, организовывающая выпадающий иерархический список в виде элемента select, содержащий категории и соответствующие подкатегории.

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

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

Пример:

<li id="categories">
<h2>Категории:</h2>
<form action="<?php bloginfo('url'); ?>" method="get">
<?php wp_dropdown_categories('show_count=1&hierarchical=1'); ?>
<input type="submit" name="submit" value="view" />
</form>
</li>

Параметры:
show_option_all
(строка) Позволяет выводить в выпадающем списке все категории. Возращает HTML код выпадающего списка

show_option_none
(строка) Выводит HTML код списка всех категорий и подкатегорий, но не позволяет произвести выбор из представленного списка.

orderby
(строка) Вывод с сортировкой по определенному критерию. Доступные опции:

* 'ID' (По умолчанию)
* 'name'

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

* 'ASC' (По умолчанию)
* 'DESC'

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

* 1 (True)
* 0 (False - По умолчанию)

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

* 1 (True)
* 0 (False - По умолчанию)

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

* 1 (True - По умолчанию)
* 0 (False)

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

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

echo
(булево) Параметр определяет – показывать вложенные закладки или нет.

* 1 (True - По умолчанию)
* 0 (False)

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

hierarchical
(булево) Параметр определяет, выводить список просто списком, или в виде иерархического списка «родитель/подкатегория».

* 1 (True)
* 0 (False - По умолчанию)

name
(строка) Параметр позволяет присвоить форме, содержащий выпадающий список, параметр name. По умолчанию будет присвоено значение ‘Cat’.

class
(строка) Параметр позволяет присвоить форме, содержащий выпадающий список, параметр Class. По умолчанию будет присвоено значение ‘postform’.

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

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

category_description

Описание:
Отображает описание категории.

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

<?php echo category_description($category); ?>

Пример:
Выводит описание для третьей категории.

<p><?php echo category_description(3); ?></p>

Параметры:
category
(целое) Числовой ID категории, к которой относится описание. По умолчанию - текущая категория, если установлено ее значение.

single_cat_title

Описание:
Отображает или возвращает название категории для текущей страницы.

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

<?php single_cat_title('prefix', 'display'); ?>

Пример:

<p><?php single_cat_title('Вы просматриваете категорию: '); ?>.</p>

Параметры:
prefix
(строка) Текст для вывода перед названием категории. По умолчанию - '' (пусто).
display
(булево) Отображает ID категории (TRUE) или возвращает значение для использования в PHP (FALSE). По умолчанию - TRUE.

the_category_ID

Описание:
Отображает или возвращается числовой ID категории, к которой принадлежит сообщение. Должен использоваться внутри цикла.

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

<?php the_category_ID(echo); ?>

Пример:
Выводит картинку категории.

<img src="/<?php the_category_ID(); ?>.gif" />

Параметры:
echo
(булево) Отображает ID категории (TRUE) или возвращает значение для использования в PHP (FALSE). По умолчанию - TRUE.

the_category_rss

Описание:
Отображает название категории или категорий, к которой принадлежит запись, в формате RSS. Должен использоваться внутри цикла.

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

<?php the_category_rss('type') ?>

Пример:
Фрагмен страницы с rss.

<?php the_category_rss() ?>
<guid><?php the_permalink($id); ?></guid>

Параметры:
type
(строка) Тип ленты для отображения. Возможные значения:
* 'rss' (по умолчанию)
* 'rdf'