Доброго времени суток. Мы с Вами продолжаем изучать теги для шаблонов WordPress. В прошлой статье мы с Вами рассмотрели теги для работы с закладками. А сегодня мы остановимся на тегах, которые необходимы для работы с категориями. Давайте приступим…

Прежде чем мы приступим к рассмотрению тегов для работы с категориями в WordPress. Давайте рассмотрим, что же такое категория или рубрика. Категория (рубрика) позволяют объединять посты общей тематики. Тем самым мы улучшаем юзабилити нашего ресурса, а это в свою очередь повышает количество посещений.
И так…
Теги для работы с категориями:

• category_description
• single_cat_title
• the_category
• the_category_rss
• wp_dropdown_categories
• wp_list_categories
• single_tag_title
• tag_description
• the_tags
• wp_generate_tag_cloud
• wp_tag_cloud
• term_description
• single_term_title
• get_the_term_list
• the_terms
• the_taxonomies

category_description()
Возвращает описание категории, которое вводиться в поле “Описание” при создании категории. Принимает обязательный параметр $category_id, где $category_id — это ID категории, которой мы хотим получить описание.
Пример:

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

Наверх

single_cat_title()
Показывает или возвращает для дальнейшей обработки название категории текущего поста. Используется только вне механизма The Loop. Принимает следующие параметры $prefix, $display , где

• $prefix — текст перед выводом категории.
• $display — показывать название категории(true) или возвращать для дальнейшей обработки(false)

Пример:

<p><?php single_cat_title('Категория: '); ?>.</p>

Перед названием категории будет выведена надпись “Категория: ”

Наверх

the_category()
Отображает ссылку на категорию или категории, к которым принадлежит сообщение. Используется внутри механизма The Loop. Может принимать следующие параметры: $separator, $parents, $post_id, где:

• $separator — текст или символ, которыми разделяются ссылки на категории. По умолчанию ссылки на категории отображаются в виде неупорядоченного списка
• $parents — как отображать ссылки на категории, которые являются дочерними: multiple — показывать и ссылку на категорию, и ссылку на подкатегорию, single — показывать ссылку на категорию только ту, к которой принадлежит сообщение
• $post_id — ID сообщения для которого необходимо получить ссылки на категории.

Пример:

<p>Категории: <?php the_category(' '); ?></p>

Будет выведен список ссылок на категории, разделенных пробелами

Наверх

the_category_rss()
Показывает категории сообщения в RSS потоке. Может принимать следующий параметр $type, где $type — тип потока RSS, atom или rdf. По умолчанию RSS.

Наверх

wp_dropdown_categories()
Отображает или возвращает для дальнейшего использования список категорий. Принимает в качестве параметра массив $args вида:

<?php $args = array(
    'show_option_all'    => ,
    'show_option_none'   => ,
    'orderby'            => 'ID',
    'order'              => 'ASC',
    'show_count'         => 0,
    'hide_empty'         => 1,
    'child_of'           => 0,
    'exclude'            => ,
    'echo'               => 1,
    'selected'           => 0,
    'hierarchical'       => 0,
    'name'               => 'cat',
    'id'                 => ,
    'class'              => 'postform',
    'depth'              => 0,
    'tab_index'          => 0,
    'taxonomy'           => 'category',
    'hide_if_empty'      => false ); ?> 

где:

• show_option_all — текст для показа всех категорий, по умолчанию пусто
• show_option_none — текст для показа “Нет категорий”, по умолчанию пусто
• orderby — поле по которому происходит сортировка, по умолчанию ID
• order — порядок сортировки
• show_count — количество категорий, которые будут показываться, по умолчанию все.
• hide_empty — показывать (false) или не показывать (true) категории в которых нет постов, по умолчанию true
• child_of — показывать потомков категории (true) или не показывать (flase) потомков
• exclude — перечисляем ID категорий через запятую, которые не будем показывать.
• echo — показывать(true) или возвращать для дальнейшей обработки (false) список категорий. По умолчанию true
• selected — ID категории, которая будет выбрана по умолчанию
• hierarchical — показывать все категории (false) или показывать категории до depth вложения.
• depth — глубина вложенности
• name — имя значения атрибута для выбора. По умолчанию cat
• id — ID значение выбранного элемента. По умолчанию name
• class — class выбранного элемента. По умолчанию postform
• tab_index — tabindex выбранного элемента
• taxonomy — возвращает таксономию. Может принимать следующие значения: ‘category’, ‘post_tag’ или любую зарегистрированную таксономию
• hide_if_empty — скрыть выпадающий список(true) или показывать выпадающий список (false), если он пустой. По умолчанию false

Пример:

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

Наверх

wp_list_categories()
Показывает список категорий в виде списка ссылок. Принимает параметр в виде массива $args:

<?php $args = array(
    'show_option_all'    => ,
    'orderby'            => 'name',
    'order'              => 'ASC',
    'show_last_update'   => 0,
    'style'              => 'list',
    'show_count'         => 0,
    'hide_empty'         => 1,
    'use_desc_for_title' => 1,
    'child_of'           => 0,
    'feed'               => ,
    'feed_type'          => ,
    'feed_image'         => ,
    'exclude'            => ,
    'exclude_tree'       => ,
    'include'            => ,
    'hierarchical'       => true,
    'title_li'           => __( 'Categories' ),
    'show_option_none'   => __('No categories'),
    'number'             => NULL,
    'echo'               => 1,
    'depth'              => 0,
    'current_category'   => 0,
    'pad_counts'         => 0,
    'taxonomy'           => 'category',
    'walker'             => 'Walker_Category' ); ?>

где:

• show_option_all — указываем ссылку на все категории, если пусто, то это ссылка не будет показываться

• orderby — поле по которому будет происходить сортировка: ID — по умолчанию, name, slug, count, term_group

• order — порядок сортировки
• show_last_update — будет показываться(true) или нет (false) последнее обновление метки для поста. По умолчанию false
• style — стиль для отображения категорий. Может принимать следующие значения: list — по умолчанию, none
• show_count — показывать (true) или не показывать (false) число сообщений в каждой категории
• hide_empty — Показывать (false) категории, в которых нет сообщений. По умолчанию true, т.е. скрывает категории без сообщений
• use_desc_for_title — будет ли название категории вставляться в title ссылки категории. Принимает следующие значения true — по умолчанию и false.
• child_of — отображение только категорий, которые имеют потомка по данному параметру.
• feed — отображение ссылке на RSS2 каждой категории.
• feed_type — тип потока
• feed_image — устанавливает картину как ссылку RSS поток
• exclude — указываем ID категорий через запятую, которые будут исключены из списка
• exclude_tree — исключение дерева-категорий из результатов
• include — включать в список только те категории, ID которых перечислен через запятю
• hierarchical — показывать подкатегории как внутренние элементы списка. По умолчанию true
• title_li — установить название и стиль внешнего элемента списка. По умолчанию: Category
• show_option_none — устанавливает ссылку на Без категории
• number — устанавливает лимит на количество отображаемых категорий. По умолчанию: нет лимита.
• echo — Показывать (true) или возвращать (false) список категорий для дальнейшей обработки
• depth — глубина вложенности подкатегорий
• current_category — позволяет появиться данной категории на страницах архива
• pad_counts — рассчитывает ссылку или сообщение по пунктам, включая элементы из дочерних категорий
• taxonomy — возвращает таксономию
• walker — экземпляр класса, который расширяет Walker_Category

Наверх

single_tag_title()
Отображает или возвращает заголовок для текущей страницы архива. Принимает следующие параметры: $prefix, $display, где

• $prefix — текст перед заголовком
• $display — отображать(true) или возвращать (false) результат

Пример:

<?php $current_tag = single_tag_title("", false); ?>

Наверх

tag_description()
Выводит описание тега по ID. В качестве параметра принимает $tag_id, $tag_id — ID тега.
Пример:

<?php echo 'Описание тега: ' . tag_description('1'); ?>

Наверх

the_tags()
Выводит ссылку или ссылки тегов к которым принадлежит сообщение. Может использоваться внутри механизма The Loop. В качестве параметров принимает: $before, $sep, $after , где:

• $before — текст перед ссылкой
• $sep — разделитель между ссылками на теги
• $after — текст после ссылки

Наверх

wp_generate_tag_cloud()
Возвращает HTML строку тегов. Создается, так называемое, облако тегов. В качестве параметров принимает $tags, $args

<?php $args = array(
    'smallest'  => 8,
    'largest'   => 22,
    'unit'      => 'pt',
    'number'    => 0,
    'format'    => 'flat',
    'separator' => '\n',
    'orderby'   => 'name',
    'order'     => 'ASC',
    'topic_count_text_callback'  => 'default_topic_count_text',
    'topic_count_scale_callback' => 'default_topic_count_scale',
'filter'    => 1 ); ?>

• smallest — самый маленький тег
• largest — самый большой тег
• unit — описывает размер шрифта
• number — ограничение на отображение количества тегов. Максимально 45
• format — стиль отображения тегов
• separator — разделение между тегами
• orderby — по какому полю будет происходить сортировка
• order — метод сортировки
• topic_count_text_callback — использует функцию default_topic_count_text
• topic_count_scale_callback — использует функцию default_topic_count_scale
• filter — фильтр

Наверх

wp_tag_cloud()
Отображает список тегов в то, что называют «облако тегов», где размер каждого тега определяется тем, как много раз данный тег назначался сообщению. Принимает ввиде аргумента массив $args

<?php $args = array(
    'smallest'                  => 8,
    'largest'                   => 22,
    'unit'                      => 'pt',
    'number'                    => 45,
    'format'                    => 'flat',
    'separator'                 => \"\n\",
    'orderby'                   => 'name',
    'order'                     => 'ASC',
    'exclude'                   => null,
    'include'                   => null,
    'topic_count_text_callback' => default_topic_count_text,
    'link'                      => 'view',
    'taxonomy'                  => 'post_tag',
    'echo'                      => true ); ?> 

где:

• smallest — самый маленький тег
• largest — самый большой тег
• unit — описывает размер шрифта
• number — ограничение на отображение количества тегов. Максимально 45
• format — стиль отображения тегов
• separator — разделение между тегами
• orderby — по какому полю будет происходить сортировка
• order — метод сортировки
• exclude — перечисление ID тегов через запятую, которые не включаются в облако тегов
• include — перечисление ID тегов через запятую, из которых состоит облако тегов
• topic_count_text_callback — использует функцию default_topic_count_text
• link — устанавливает связь с тегом для редактирования
• taxonomy — таксономия или массив таксономии, который используется в формировании облака тегов
• echo — отображать(true) или возвращать(false) результат для дальнейшей обработки

Наверх

term_description()
Выводит описание таксономии или термина по ID. В качестве параметров принимает $term_id, $taxonomy, где:

• $term_id — ID термина
• $taxonomy — ID тега

Наверх

single_term_title()
Показывает или возвращает заголовок термина по ID. В качестве параметров может принимать $prefix, $display, где:

• $prefix — текст перед заголовком
• $display — отображать (true) результат или возвращать (false) результат для дальнейшей обработки

Наверх

get_the_term_list()
Возвращает HTML строку таксономии терминов. В качестве параметров может принимать: $id, $taxonomy, $before, $sep, $after, где

• $id — ID сообщения
• $taxonomy — название таксономии
• $before — текст перед термином таксономии
• $sep — разделитель терминов таксономии
• $after — текст после терминов таксономии

Наверх

the_terms()
Отображает термины для определенной таксономии. В качестве параметров может принимать следующие аргументы: $id, $taxonomy, $before, $sep, $after см. get_the_term_list()

Наверх

the_taxonomies()
Используется в механизме The Loop для отображения таксономии без указания ID сообщения. Данную функцию можно использовать и без механизма The Loop. Принимает следующие параметр: $id, $before, $sep, $after, где:

• $id — ID сообщения
• $before — текст перед термином таксономии
• $sep — разделитель терминов таксономии
• $after — текст после терминов таксономии

Наверх

На этом рассмотрение тегов для работы с категориями в WordPress мы закончили. В следующей статье мы с Вами остановимся на изучении тегов для работы с комментариями. Так, что не пропускайте выхода новых статей, подписавшись на RSS-рассылку данного блога.