Теги для работы с категориями WordPress
Доброго времени суток. Мы с Вами продолжаем изучать теги для шаблонов 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-рассылку данного блога.
[…] Мы продолжаем изучать теги для шаблонов WordPress. Так в прошлой статье мы рассмотрели теги для работы с категориями в WordPress. А […]
Приветствую Вас.
Подскажите пожалуйста, как мне убрать надпись Категория: и вообще всю эту строку.
Весь вид портит на сайте, раньше такого не было.
Спасибо!
Надпись «Категория» где именно Вы хотите ее убрать?
Так я картинку прикрепил, там показано где эта надпись.
Так вы ответите мне, или вы не знаете? Так напишите здесь, чего я жду второй день от вас ответа?
Это меняется в самом шаблоне.