Теги для работы с категориями WordPress

Ромчик
6

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

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

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-рассылку данного блога.

Понравилась статья? Поделись с друзьями.
  • Add to favorites
  • Добавить ВКонтакте заметку об этой странице
  • Twitter
  • Facebook
  • Мой Мир
  • LiveJournal
  • Одноклассники
  • Блог Я.ру
  • MySpace
  • FriendFeed
  • В закладки Google
  • Google Buzz
  • Яндекс.Закладки
  • Reddit
  • StumbleUpon
  • Technorati
  • del.icio.us
  • БобрДобр
  • LinkedIn
  • Memori.ru
  • Сто закладок
  • Blogger

  • Теги для работы с комментариями WordPress | Все о WEB программировании - 06.03.2012 в 13:20

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

  • Роман - 14.09.2012 в 13:20

    Приветствую Вас.
    Подскажите пожалуйста, как мне убрать надпись Категория: и вообще всю эту строку.
    Весь вид портит на сайте, раньше такого не было. 
    Спасибо!

    • Roman - 14.09.2012 в 14:38

      Надпись «Категория» где именно Вы хотите ее убрать?

    • Роман - 14.09.2012 в 15:20

      Так я картинку прикрепил, там показано где эта надпись.

    • Роман - 15.09.2012 в 16:18

      Так вы ответите мне, или вы не знаете? Так напишите здесь, чего я жду второй день от вас ответа?

    • Roman - 16.09.2012 в 19:43

      Это меняется в самом шаблоне.

  • ©2012-2017 По всем вопросам обращайтесь через форму обратной связи

    Яндекс.Метрика