Теги шаблонов WordPress - Теги категорий(начало).

Почему в заголовке написано “Теги категорий(начало)”? Потому, что слишком длинный пост получился и я его решил разбить на два. Недавно я писал про авторские теги шаблонов WordPress, сейчас вот про теги категорий. Это будет цикл статей про теги шаблонов WordPress. После того как опишу все теги шаблонов будет статья про Цикл(The Loop), а также примеры использования тегов, цикла и т.д.

the_category

Выводит ссылку на категорию или категории к которой относится сообщение. Используется в Цикле.

Пример:

<p>Опубликовано в: <?php the_category(' '); ?></p>

Выводит ссылки на категории разделенные разделителем(если категорий больше 1):

<p>Опубликовано в: <?php the_category(', '); ?></p>

в данном случае разделитель запятая.

Параметры

separator
(строка) Текст или символ для отображения между двумя категориями. По умолчанию располагает ссылки в ненумерованном списке.
parents
(строка) Как отображать ссылки в дочерних (под) категориях.

Опции:

multiple
- показывает раздельные ссылки к родительским и дочерним категориям, отображая, отношения “родитель/потомок”.
single
- показывает ссылку только на дочернюю категорию, а текст ссылки отображает отношения “родитель/потомок”.

Примечание: По умолчанию показывается ссылка на дочернюю категорию, без отображения отношений “родитель/потомок”.

the_category_rss

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

Пример(Фрагмент RSS2 ленты):

Параметры:

тип
(*string*) Тип ленты. Значения:
  • ‘rss’ (По умолчанию)
  • ‘rdf’

the_category_ID

Запрещено

Выводит или возвращает идентификационный номер категории в которой опубликовано сообщение. Используется в Цикле.

Пример(Так как этот тег больше не поддерживается вы можете заменить его следующим php кодом):

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

the_category_head

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

Пример для страницы одной записи:

(Так как этот тег больше не поддерживается, он заменяется на php код)

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

Пример для страницы категории:

<?php echo get_the_category_by_ID($cat); ?>

single_cat_title

Выводит/возвращает имя категории для текущей страницы. Используется внутри Цикла.

Параметры:

prefix
(string) Текст для вывода перед именем категории. По умолчанию '' (нет текста).
display
(boolean) Выводить имя категории(TRUE) или вернуть для использования в дальнейшем в коде PHP(FALSE). По умолчанию TRUE.

Пример:

Выводит текст: Вы сейчас просматриваете категорию: перед именем категории.

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

Пример для использования имени категории в дальнейшем в PHP коде: Присваивает переменной $current_category имя текущей категории для дальнейшего использования.

<?php $current_category = single_cat_title("", false); ?>

category_description

Возвращает описание категории.

Параметры:

category
(integer) ID категории для возвращения ее описания. По умолчанию текущая категория(если не указано).

Пример: Выводит описание категории с ID = 3.

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

wp_dropdown_categories

Добавлена с версии WordPress 2.1. Выводит список категорий в виде выпадающего списка.

Параметры:

show_option_all
(string) Текст для добавления элемента выбора всех категорий в выпадающий список.
show_option_none
(string) Текст для добавления элемента выпадающего списка для выбора ни одной из категорий.
orderby
(string) Ключ для сортировки по. Значения:
  • 'ID' (По умолчанию)
  • 'name'
order
(string) Порядок сортировки. Значения:
  • 'ASC' (По умолчанию)
  • 'DESC'
show_last_update
(boolean) Устанавливает показывать ли дату последнего сообщения для каждой категории. Значения:
  • 1 (True)
  • 0 (False – По умолчанию)
show_count
(boolean) Устанавливает, показывать ли дату последнего сообщения в каждой категории. Значения:
  • 1 (True)
  • 0 (False – По умолчанию)
hide_empty
(boolean) Устанавливает показывать ли категории в которых нет сообщений. Значения:
  • 1 (True – По умолчанию)
  • 0 (False)
child_of
(integer) Отображает лишь те категории которые являются потомками указанной категории. Не имеет значения по умолчанию.
exclude
(string) Запятая отделяет список ID категорий для исключения. Для примера, ‘exclude=4,12′ значит, что категории с ID 4 и 12 НЕ будут отображаться/возвращаться. По умолчанию ничто не исключается.
echo
(boolean) Показывает список (TRUE) или возвращает для использования в PHP (FALSE). По умолчанию TRUE.
  • 1 (True – По умолчанию)
  • 0 (False)
selected
(integer) ID категории которая сейчас выбрана в выпадающем списке. По умолчанию никакая категория не выбрана.
hierarchical
(boolean) Выводит категории в виде иерархического списка(дочерние категории выводятся с отступом). По умолчанию FALSE.
  • 1 (True)
  • 0 (False – По умолчанию)
name
(string) Имя присваиваемое выпадающему списку. По умолчанию ‘cat’.
class
(string) Класс присваиваемый выпадающему списку. По умолчанию ‘postform’.
depth
(integer) Этот параметр контролирует сколько уровней в иерархии категорий будут включены в список категорий. Значение по умолчанию 0 (выводит все категории и их потомков). Этот параметр добавлен с верси 2.5
  • 0 – Все категории, включая дочерние (По умолчанию).
  • -1 – Все категории отображаются без отступа(отменяет **иерархию**).
  • 1 – Выводит только главные категории.
  • n – Значение n (любое число) для глубины вывода категорий.

Значения по умолчанию:

$defaults = array( 'show_option_all' => '', 'show_option_none' => '', 'orderby' => 'ID', 'order' => 'ASC', 'show_last_update' => 0, 'show_count' => 0, 'hide_empty' => 1, 'child_of' => 0, 'exclude' => '', 'echo' => 1, 'selected' => 0, 'hierarchical' => 0, 'name' => 'cat', 'class' => 'postform', 'depth' => 0);

По умолчанию, использование возвращает:

<?php wp_dropdown_categories(); ?>

Примеры:

Выводит выпадающий иерархический список категорий в HTML форме с кнопкой отправления, в сайдбаре WordPress, с выводом количества сообщений в каждой категории.

<li id="categories">
    <h2><?php _e('Categories:'); ?></h2>
    <form action="<?php bloginfo('url'); ?>" method="get">
        <?php wp_dropdown_categories('show_count=1&hierarchical=1'); ?>
        <input type="submit" name="submit" value="Показать" />
    </form>
</li>

dropdown_cats

Не поддерживается.

Используйте тег wp_dropdown_categories.