Изучаем теги шаблонов: часть вторая

Изучаем теги шаблонов: часть первая Изучаем теги шаблонов: часть вторая Изучаем теги шаблонов: часть третья Изучаем теги шаблонов: часть четвертая Изучаем теги шаблонов: часть пятая Изучаем теги шаблонов: часть шестая

Во второй статье из нашей серии мы рассмотрели первую «порцию» тегов шаблонов в WordPress. Сегодня мы рады представить следующую их часть. Мы рассмотрим теги, связанные с таксономией и метками.

Получаем описание рубрики: category_description()

Тег шаблона возвращает описание текущей(указанной) рубрики.

Настройки

Этот тег шаблона принимает лишь один настройка:

  • $category_ID(integer, необязательный): ID рубрики. По умолчанию: запрашиваемая рубрика.

Применение

<?php $cat_desc = get_category_description( 15);?>

Получаем описание тега: tag_description()

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

Настройки

Этот тег шаблона принимает лишь один настройка:

  • $tag_ID(integer, необязательный): ID тега. По умолчанию: текущий тег.

Применение

<?php// Выводим описание текущего тега.echo tag_description();// Получаем описание определенного тега.$special_tag_desc = tag_description( 42);?>

Получаем описание элемента таксономии: term_description()

Тег возвращает описание элемента таксономии(метки, категории и иное).

Настройки

Этот тег шаблона принимает два параметры:

  • $term_ID(integer, необязательный): ID метки. По умолчанию: описание текущего элемента;
  • $taxonomy(sting, необязательный): Название таксономии. По умолчанию: ‘post_tag‘.

Применение

<?php// Выводим описание текущей метки. echo term_description();// Получаем описание конкретной метки из определенной таксономии. $special_term_desc = term_description( 14, 'laptop_inches');?>

Получаем и выводим заголовок страницы для категорий архивов: single_cat_title()

Тег отображает и возвращает имя категории текущей страницы.

Настройки

Этот тег шаблона принимает два параметры:

  • $prefix(sting, необязательный): Что должно выводиться перед заголовком. По умолчанию: ‘ ‘;
  • $echo(bool, необязательный): Вывести имя категории(TRUE) или вернуть(FALSE). По умолчанию: TRUE.

Применение

<?php// Выводим заголовок рубрики с приставкой. single_cat_title( 'Рубрики: ');// Получаем заголовок рубрики. $cat_title = single_cat_title( ' ', false);?>

Получаем и выводим заголовок страницы архива тегов: single_tag_title()

Тег шаблона получает и отображает заголовок тега для последующего использования в заголовках страниц.

Настройки

Этот тег шаблона принимает два параметры:

  • $prefix(sting, необязательный): текст, выводимый перед заголовком. По умолчанию: ‘ ‘;
  • $echo(опционально – логическое значение): Вывести заголовок(TRUE) или приобрести(FALSE). По умолчанию: TRUE.

Применение

<?php// Выводим заголовок тега с приставкой. single_tag_title( 'Архив тегов: ');// Получаем заголовок тега. $tag_title = single_tag_title( '', false);?>

Получаем и выводим заголовок страницы архива меток: single_term_title()

Тег шаблона получает и возвращает заголовок таксономии текущего поста.

Настройки

Этот тег шаблона принимает два параметры:

  • $prefix(integer, необязательный): текст перед заголовком. По умолчанию: ‘ ‘;
  • $echo(bool, необязательный): Вывести заголовок(TRUE) или вернуть(FALSE). По умолчанию: TRUE.

Применение

<?php// Вывести заголовок метки с приставкой. single_term_title( 'Архив меток: ');// Получаем заголовок метки.$term_title = single_term_title( '', false );?>

Получаем и выводим категории записи: get_the_category_list() и the_category()

Теги извлекают и отображают категории записи.

Настройки

Оба тега шаблонов принимают три параметры:

  • $separator (sting, необязательный): разделитель между категориями. По умолчанию: ‘ ‘. Если этот настройка не установлен, то категории будут отображаться в виде неупорядоченного списка;
  • $parents (sting, необязательный): Как вывести родительские категории (‘multiple‘, ‘single‘ или ‘ ‘.). По умолчанию: ‘ ‘;
  • $post_ID (integer, необязательный): ID записи. По умолчанию: текущая запись.

Применение

<?php// Получаем неупорядоченный список категорий текущей записи.get_the_category_list();// Выводим категории текущей записи, разделенные запятыми и с родительскими категориями (если есть).the_category( ', ', 'multiple' );?>

Получаем и выводим категории записей для рассылки: get_the_category_rss() и the_category_rss()

Теги могут приобрести все записи категории, отформатированные для вывода в RSS .

Настройки

Оба тега шаблонов принимают лишь один настройка:

  • $feed_type (sting, необязательный): Тип рассылки. По умолчанию: тип рассылки по умолчанию.

Применение

<?php// Получаем контент из категорий для рассылки в стандартном формате.get_the_category_rss();// Выводим содержимое категорий для рассылки типа atom.the_category_rss( 'atom' );?>

Получаем и выводим теги к записи: get_the_tag_list() и the_tags()

Возвращают и отображают все теги, связанные с указанной записью.

Настройки

Оба тега шаблона принимают по три параметры.

  • $before (sting, необязательный): Текст или HTML -код, который выводится перед выводом. Значение по умолчанию: ‘ ‘ для get_the_tag_list() и ‘Tags: ‘ для the_tags() ;
  • $sep (sting, необязательный): Текст, который будет использоваться в виде разделителя. Значение по умолчанию: ‘ ‘ для get_the_tag_list() и ‘, ‘ для the_tags() ;
  • $after (sting, необязательный): Текст или HTML -код, который выводится после вывода. По умолчанию: ‘ ‘.

Применение

<?php// Получаем простой список ссылок для тегов.get_the_tag_list();// Выводим теги с произвольными настройками.the_tags( '<div class="mytheme-tags">' . __( 'Tags: ', 'translation-domain' ) , ' &middot; ', '</div>' );?>

Получаем и выводим метки записи: get_the_term_list() и the_terms()

Теги получают и отображают список терминов таксономии, относящихся к определенному посту.

Настройки

Оба тега шаблонов принимают 5 настроек:

  • $post_ID (sting, необязательный): ID записи. По умолчанию: текущая запись;
  • $taxonomy (sting, обязательный): Таксономия, для которой необходимо приобрести список терминов. По умолчанию:‘ ‘;
  • $before (sting, необязательный): Текст или HTML -код, который выводится перед выводом. По умолчанию: ‘ ‘;
  • $sep (sting, необязательный): Разделитель терминов таксономий. По умолчанию: ‘, ‘;
  • $after (sting, необязательный): Текст или HTML -код, который выводится после вывода. По умолчанию: ‘ ‘.

Применение

<?php// Получаем метки текущей записи из таксономии "Available Brands".get_the_term_list( $post->ID, 'available-brands' );// Выводим метки текущей записи из таксономии "Available Brands" с произвольным оформлением.the_terms( $post->ID, 'available-brands', __( 'Доступные бренды: ', 'translation-domain' ), ' - ' );?>

Выводим таксономии записи: the_taxonomies()

Тег отображает таксономии записи и доступные опции.

Настройки

Этот тег шаблона принимает лишь один настройка:

  • $args (array, необязательный): Массив содержит следующие аргументы:

—‘ post ‘ (integer): ID записи. По умолчанию: 0. —‘ before ‘ (sting, необязательный): HTML -код, который добавляется до вывода. По умолчанию: ‘ ‘. —‘ sep ‘ (sting): разделитель. По умолчанию: ‘ ‘. —‘ after ‘ (sting): HTML -код, который добавляется после вывода. По умолчанию: пусто‘ ‘. —‘ template ‘ (sting): Шаблон вывода списка. По умолчанию: ‘%s: %l.’ где %s – это метка таксономии, а %l – список ссылок.

Применение

<?php$args = array( 'before' => '<div class="taxonomies">', 'sep' => ', ', 'after' => '</div>');the_taxonomies( $args );?>

Получаем и выводим ссылку «настроить тег»: get_edit_tag_link() и edit_tag_link()

Данные теги получают или отображают ссылку «настроить тег», которую можно без проблем использовать в шаблонах.

Настройки

get_edit_tag_link() принимает два параметры:

  • $tag_ID (integer, обязательный): ID тег. По умолчанию: NULL ;
  • $taxonomy (sting, необязательный): Тип таксономии. По умолчанию: ‘post_tag‘.

и edit_tag_link() принимает четыре параметры:

  • $link (sting, необязательный): Текст для ссылки. По умолчанию: ‘Edit This‘;
  • $before (sting, необязательный): Текст или HTML -код, который выводится перед выводом. По умолчанию: ‘ ‘;
  • $after (sting, необязательный): Текст или HTML -код, который выводится после вывода. По умолчанию: ‘ ‘;
  • $tag (object, необязательный): Объект тега. По умолчанию: NULL .

Применение

<?php// Получаем ссылку «настроить тег» для текущего тега. $edit_tag_link = get_edit_tag_link();// Получаем ссылку «настроить метку» для определенной метки.$edit_tag_link = get_edit_tag_link( 4, 'keyboard-brand' );// Выводим ссылку «настроить тег» для текущего тега.edit_tag_link( __( 'Edit', 'translation-domain' ), '<strong>', '</strong>' );// Выводим ссылку «настроить метку» для определенной метки.edit_tag_link( __( 'Настроить', 'translation-domain' ), ' ', ' ', 11 );?>

Получаем и выводим список категорий: wp_list_categories()

Тег получает и отображает список категорий в виде ссылок.

Настройки

Этот тег принимает лишь один настройка:

  • $args (array, необязательный): Массив содержит следующие элементы:

—‘ show_option_all ‘ (string): Показывает ссылку на главную страницу (или на “Страницу записей”, выставленную в разделе Параметра > Чтение ), если выставлено не пустое значение. Значение будет анкорным текстом ссылки. По умолчанию: ‘ ‘; —‘ show_option_none ‘ (string): Текст, который будет выводиться при отсутствии рубрик. По умолчанию: ‘Нет рубрик‘; —‘ orderby ‘ (string): Способ сортировки рубрик. Принимает значения ‘name‘, ‘ID‘, ‘slug‘, ‘count‘ и ‘term_group‘. По умолчанию: ‘name‘; —‘ order ‘ (string): Сортировать элементы по возрастанию (‘ASC‘) или по убыванию (‘DESC‘). По умолчанию: ‘ ASC ‘; —‘ style ‘ (sting): Стиль выведения рубрик—’list‘ генерирует неупорядоченный список ссылок, ‘none‘ генерирует список ссылок, разделенных тегом <br />. По умолчанию: ‘list‘; —‘ show_count ‘ (integer): Показывает число записей рядом с каждой рубрикой. По умолчанию: 0; —‘ hide_empty ‘ (integer): Скрывать пустые рубрики или нет. По умолчанию: 1; —‘ use_desc_for_title ‘ (integer): Использовать описания в виде атрибута title для ссылки. По умолчанию: 1; —‘ child_of ‘ (integer): Вывод только дочерних элементов из категории указанного ID . По умолчанию: 0; —‘ feed ‘ (string): Если используется не пустое значение, рядом с каждой категорией будет выводиться ссылка на рассылку. Значение будет использоваться в виде анкорного текста ссылок. По умолчанию: ‘ ‘; —‘ feed_type ‘ (string): Тип рассылки (‘rss‘, ‘rss2‘, ‘atom‘ или ‘rdf‘). По умолчанию: ‘ ‘; —‘ feed_image ‘ (string): Путь к изображению, которое будет использоваться вместо анкорного текста ссылки на рассылку. По умолчанию: ‘ ‘; —‘ exclude ‘ (string): ID рубрик через запятую, которые необходимо исключить из списка. По умолчанию: ‘ ‘; —‘ exclude_tree ‘ (string): То же, что «exclude«, но этот настройка используется, если аргумент hierarchical выставлен на 1. По умолчанию: ‘ ‘; —‘ current_category ‘ (integer): Добавляет класс «current-cat«, если это необходимо. По умолчанию: 0; —‘ hierarchical ‘ (integer): Вывод элементов в иерархическом формате. По умолчанию: 1; —‘ title_li ‘ (string): Обрамляет результат тегом <li> и отображает заголовок перед списком рубрик. По умолчанию: ‘Категории‘; —‘ echo ‘ (integer): Отображать результат (1) или возвращать его (0). По умолчанию: 1; —‘ depth ‘ (integer): Максимальная глубина иерархии. По умолчанию: 0; —‘ taxonomy ‘ (string): Таксономия для списка. По умолчанию: ‘category‘.

Применение

<?php$args = array( // Показываем ссылку "Все записи". 'show_option_all' => __( 'Все записи', 'translation-domain' ), // Сортировка по номеру записи. 'orderby' => 'count',  // Показывать номера записей.    'show_count' => 1,    // Показывать ссылки на рассылки.    'feed' => 'Feed',    // Удаление title_li.    'title_li' => '');wp_list_categories( $args );?>

Получаем и выводим выпадающий HTML-список категорий: wp_dropdown_categories()

Тег получает и отображает выпадающий список (элемент <select>), состоящий из наименований категорий.

Настройки

Этот тег шаблона принимает лишь один настройка:

  • $args (array, необязательный): Массив содержит следующие элементы:

—‘ show_option_all ‘ (string): Текст для выведения во всех категориях. По умолчанию: ‘ ‘; —‘ show_option_none ‘ (string): Текст, который выводится при отсутствии категорий. По умолчанию: ‘ ‘; —‘ option_none_value ‘ (смешанное значение): Значение, которое используется при отсутствии выбранных категорий. По умолчанию: -1; —‘ orderby ‘ (string): сортировка отображаемых категорий по определенным критериям. По умолчанию: ‘ID‘; —‘ order ‘ (string): направление сортировки (по возрастанию или убыванию). По умолчанию: ‘ASC‘; —‘ show_count ‘ (bool или integer): Показывать или нет число записей в категории. По умолчанию: 0; —‘ hide_empty ‘ (bool или integer): показывать или нет категории без записи. По умолчанию: 1; —‘ child_of ‘ (integer): Показывать или нет все дочерние категории. По умолчанию: 0; —‘ exclude ‘ (string): Список разделенных запятыми ID категорий, которые необходимо исключить из списка. По умолчанию: ‘ ‘; —‘ echo ‘ (bool или integer): Отображать или извлекать контент. По умолчанию: 1; —‘ depth ‘ (integer): Максимальная глубина вложенности. По умолчанию: 0; —‘ tab_index ‘ (integer): значение атрибута tabindex для элемента SELECT .По умолчанию: 0; —‘ name ‘ (string): Значение атрибута NAME для элемента SELECT . По умолчанию: ‘cat‘; —‘ id ‘ (string): значение атрибута ID элемента SELECT . По умолчанию: пусто; —‘ class ‘ (string): CSS -класс для элемента SELECT . По умолчанию: ‘postform‘; —‘ selected ‘ (integer): ID категории, которая должна быть выбрана по умолчанию. По умолчанию: 0; —‘ taxonomy ‘ (string): название таксономии для вывода. По умолчанию: ‘category‘.

Применение

<?php$args = array(    'show_option_none' => __( 'Ничего не найдено', 'translation-domain' ),    'orderby' => 'title',    'show_count' => 1,    'echo' => 0,    'name' => __( 'brands', 'translation-domain' ),    'taxonomy' => __( 'available-brands', 'translation-domain' ));$brands_dropdown = wp_categories_dropdown( $args );?>

Получаем и выводим облако тегов: wp_tag_cloud()

Тег получает или отображает облако тегов, сгенерированное из указанной таксономии (по умолчанию: из тегов).

Настройки

Этот тег шаблона принимает лишь один настройка:

  • $args (array, необязательный):

Массив содержит следующие аргументы: —‘ smallest ‘ (integer): Самый мелкий размер шрифта. По умолчанию: 8; —‘ largest ‘ (integer): Самый крупный размер шрифта. По умолчанию: 22; —‘ unit ‘ (string): Единица изменения размера текста. По умолчанию: ‘pt‘; —‘ number ‘ (string): Максимальное число тегов для выведения. По умолчанию: 45; —‘ format ‘ (string): Как выводить список тегов: ‘flat‘ – элементы разделяются пробелом, ‘list‘ – неупорядоченный HTML -список, и ‘array‘ – в виде PHP -массива. По умолчанию: ‘flat‘; —‘ separator ‘ (string): Текст разделителя. По умолчанию: «n«; —‘ orderby ‘ (string): Критерии сортировки тегов (‘name‘ или ‘count‘). По умолчанию: ‘name‘; —‘ order ‘ (string): Сортировать элементы по возрастанию (‘ASC‘) или по убыванию (‘DESC‘) порядке. По умолчанию: ‘ASC‘; —‘ include ‘ (array): Массив из ID , которые следует включить в выдачу. По умолчанию: ‘ ‘; —‘ exclude ‘ (array): Массив из ID , которые следует исключить из выдачи. По умолчанию: ‘ ‘; —‘ taxonomy ‘ (string): Таксономия, из которой будет построено облако. По умолчанию: ‘post_tag‘; —‘ link ‘ (string): Результат нажатия на ссылку ‘view‘ для просмотра ‘edit‘ для редактирования ссылок. Работает с аргументом ‘post_type‘. По умолчанию: ‘view‘; —‘ post_type ‘ (string): Если аргумент ‘link‘ выставлен на ‘edit‘, то вам необходимо указать ‘post_type‘, чтобы определить, какие типы записей будут в списке “редактировать ссылки”. По умолчанию: пусто; —‘ echo ‘ (boolean): вывести облако на экран или возвращать значение для дальнейшей обработки. По умолчанию: TRUE .

Применение

<?php$args = array(    // Самый мелкий и крупный размер шрифта.    'smallest' => 10,    'largest'  => 32,    // Приобретать только 20 тегов.    'number' => 20,    // Сортировать по популярности.    'orderby' => 'count',    // Произвольная таксономия.    'taxonomy' => 'brands',    // Вместо выведения вернуть выдачу.    'echo' => 0);$tag_cloud = wp_tag_cloud( $args );?>

Получаем произвольно сгенерированное облако тегов: wp_generate_tag_cloud()

Возвращает HTML строку со сформированным «облаком тегов».

Настройки

Тег принимает два параметры:

  • $tags (array, обязательный): Массив со списком тегов. По умолчанию: NULL ;
  • $args (array, обязательный): Массив включает следующие элементы:

—‘ smallest ‘ (integer): Самый мелкий размер шрифта. По умолчанию: 8; —‘ largest ‘ (integer): Самый крупный размер шрифта. По умолчанию: 22; —‘ unit ‘ (string): Единица изменения размера текста. По умолчанию: ‘pt‘; —‘ number ‘ (string): Сколько тегов отображать. По умолчанию: 0; —‘ format ‘ (string): Как выводить список тегов: ‘flat‘ – элементы разделяются пробелом, ‘list‘ – неупорядоченный HTML -список, и ‘array‘ – в виде PHP -массива. По умолчанию: ‘flat‘; —‘ separator ‘ (string): Текст разделителя. По умолчанию: «n«; —‘ orderby ‘ (string): По каким критериям сортировать теги (‘name‘ или ‘count‘). По умолчанию: ‘name‘; —‘ order ‘ (string): Сортировать элементы по возрастанию (‘ASC‘) или по убыванию (‘DESC‘). По умолчанию: ‘ASC‘; —‘ topic_count_text ‘ (string): Текст всплывающей подсказки для ссылки, привязанной к тегу. По умолчанию: NULL ; —‘ topic_count_text_callback ‘ (string): callback -функция, которая получает число записей с использованием этого тега, и выводит его в подсказке к ссылке, привязанной к тегу. По умолчанию: NULL ; —‘ topic_count_scale_callback ‘ (string): callback-функция, которая работает с аргументами ‘smallest‘ и ‘largest’ и высчитает размеры шрифта для тегов в зависимости от числа упоминаний. По умолчанию: ‘default_topic_count_scale‘; —‘ filter ‘ (integer): если этот настройка выставлен на 0, функцию не применяет фильтр с таким же названием (‘wp_generate_tag_cloud‘). По умолчанию: 1.

Применение

<?php// Получаем массив с тегами для текущей записи.$tags = get_the_tags( ' ', ', ', ' ' );// Выставляем аргументы.$args = array(    'smallest' => 10,    'largest'  => 36,    'orderby'  => 'count'   );wp_generate_tag_cloud( $tags, $args );?>

В завершение

Надеемся, вам понравилась вторая «порция» тегов шаблонов. В ближайшее время мы представим остальные части этого цикла.

Если у вас возникли какие-либо вопросы или замечания, обязательно напишите об этом в комментариях. И если вам понравилась наша статья, не забудьте поделиться ей с друзьями!

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *