Статьи

Руководство по тегам шаблонов Tuts +: вторая партия

Январь 5, 2019

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

Получение описания категории: category_description()

Этот тег шаблона возвращает описание категории.

параметры

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

  • $category_ID (необязательно — целое число) :
    Идентификатор категории.
    (По умолчанию: запрашиваемая категория)

использование

1
2
3
4
5
<?php
 
$cat_desc = get_category_description( 15 );
 
?>

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

Этот шаблон тега возвращает описание тега.

параметры

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

  • $tag_ID (необязательно — целое число) :
    Идентификатор тега.
    (По умолчанию: текущий тег)

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Display the description of current tag.
echo tag_description();
 
// Get the description of a specific tag.
$special_tag_desc = tag_description( 42 );
 
?>

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

Этот шаблонный тег просто возвращает описание термина.

параметры

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

  • $term_ID (необязательно — целое число) :
    Идентификатор термина.
    (По умолчанию: текущий термин)
  • $taxonomy (необязательно — строка) :
    Таксономия термина.
    По умолчанию: ‘post_tag’

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Display the description of current term.
echo term_description();
 
// Get the description of a specific term from a specific taxonomy.
$special_term_desc = term_description( 14, ‘laptop_inches’ );
 
?>

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

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

параметры

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

  • $prefix (необязательно — строка) :
    Префикс к названию.
    (По умолчанию: пусто)
  • $echo (необязательно — логическое) :
    Будь эхо ( TRUE ) или вернуть ( FALSE ) тег.
    (По умолчанию: TRUE )

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Display the category title with a prefix.
single_cat_title( ‘Category: ‘ );
 
// Get the category title.
$cat_title = single_cat_title( », false );
 
?>

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

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

параметры

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

  • $prefix (необязательно — строка) :
    Префикс к названию.
    (По умолчанию: пусто)
  • $echo (необязательно — логическое) :
    Будь эхо ( TRUE ) или вернуть ( FALSE ) тег.
    (По умолчанию: TRUE )

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Display the tag title with a prefix.
single_tag_title( ‘Tag Archive: ‘ );
 
// Get the tag title.
$tag_title = single_tag_title( », false );
 
?>

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

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

параметры

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

  • $prefix (необязательно — строка) :
    Префикс к названию.
    (По умолчанию: пусто)
  • $echo (необязательно — логическое) :
    Будь эхо ( TRUE ) или вернуть ( FALSE ) тег.
    (По умолчанию: TRUE )

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Display the term title with a prefix.
single_term_title( ‘Term Archive: ‘ );
 
// Get the term title.
$term_title = single_term_title( », false );
 
?>

Получение и отображение категорий сообщений: get_the_category_list() & the_category()

Эти теги шаблона извлекают и выводят категории, назначенные посту.

параметры

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

  • $separator (необязательно — строка) :
    Разделитель текста.
    (По умолчанию: Пусто — если этот параметр пуст, функции вернутся и отобразят неупорядоченный список категорий)
  • $parents (необязательно — строка) :
    Как отобразить родительские категории («несколько», «один» или «пусто»).
    (По умолчанию: пусто)
  • $post_ID (необязательно — целое число) :
    Идентификатор поста.
    (По умолчанию: текущий пост)

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Get an unordered list of current post’s categories.
get_the_category_list();
 
// Display current post’s categories separated by commas and with their parents (if there are any).
the_category( ‘, ‘, ‘multiple’ );
 
?>

Получение и отображение категорий сообщений для каналов: get_the_category_rss() & the_category_rss()

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

параметры

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

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

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Get feed items of categories for the default feed type.
get_the_category_rss();
 
// Display feed items of categories for atom feeds.
the_category_rss( ‘atom’ );
 
?>

Получение и отображение тегов сообщения: get_the_tag_list() & the_tags()

Эти теги шаблонов возвращают или отображают теги ваших сообщений.

параметры

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

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

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Get a plain list of tag links.
get_the_tag_list();
 
// Display the tags with custom parameters.
the_tags( ‘<div class=»mytheme-tags»>’ . __( ‘Tags: ‘, ‘translation-domain’ ) , ‘ &middot; ‘, ‘</div>’ );
 
?>

Получение и отображение условий публикации: get_the_term_list() & the_terms()

Эти теги шаблона получают и отображают список терминов, назначенных для публикации.

параметры

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

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

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Getting current post’s terms from the «Available Brands» taxonomy.
get_the_term_list( $post->ID, ‘available-brands’ );
 
// Display current post’s terms from the «Available Brands» taxonomy with some customization.
the_terms( $post->ID, ‘available-brands’, __( ‘Available Brands: ‘, ‘translation-domain’ ), ‘ — ‘ );
 
?>

Отображение таксономий сообщения: the_taxonomies()

Этот тег шаблона отображает таксономии и термины, связанные с этими таксономиями.

параметры

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

  • $args (необязательно — массив) :
    Массив следующих аргументов:
    • 'post' (целое число): ID сообщения.
      (По умолчанию: 0)
    • 'before' (строка): HTML-код, добавляемый перед выводом.
      (По умолчанию: пусто)
    • 'sep' (строка): разделитель текста.
      (По умолчанию: ‘ ‘)
    • 'after' (строка): HTML-код, добавляемый после вывода.
      (По умолчанию: пусто)
    • 'template' (строка): шаблон, используемый для отображения терминов таксономии.
      (По умолчанию: «% s:% l.», Где %s — метка таксономии, а %t — список терминов).

использование

01
02
03
04
05
06
07
08
09
10
11
<?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 (обязательно — целое число) :
    Идентификатор тега.
    (По умолчанию: NULL )
  • $taxonomy (необязательно — строка) :
    Тип таксономии.
    По умолчанию: ‘post_tag’

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

  • $link (необязательно — строка) :
    Текст для отображения по ссылке.
    (По умолчанию: «Редактировать это»)
  • $before (необязательно — строка) :
    Текст или HTML-код для отображения перед выводом.
    (По умолчанию: пусто)
  • $after (необязательно — строка) :
    Текст или HTML-код для отображения после вывода.
    (По умолчанию: пусто)
  • $tag (обязательно — объект) :
    Отметить объект.
    (По умолчанию: NULL )

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
<?php
 
// Retrieving the current tag’s «edit tag» link.
$edit_tag_link = get_edit_tag_link();
 
// Retrieving a specific term’s «edit term» link.
$edit_tag_link = get_edit_tag_link( 4, ‘keyboard-brand’ );
 
// Displaying the current tag’s «edit tag» link.
edit_tag_link( __( ‘Edit’, ‘translation-domain’ ), ‘<strong>’, ‘</strong>’ );
 
// Displaying a specific tag’s «edit tag» link.
edit_tag_link( __( ‘Edit’, ‘translation-domain’ ), », », 11 );
 
?>

Получение и отображение списка категорий: wp_list_categories()

Этот тег шаблона возвращает или отображает список категорий или терминов из любого вида таксономии.

параметры

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

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

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<?php
 
$args = array(
     
    // Show an «All Posts» link.
    ‘show_option_all’ => __( ‘All Posts’, ‘translation-domain’ ),
     
    // Order by post count.
    ‘orderby’ => ‘count’,
     
    // Show post count.
    ‘show_count’ => 1,
     
    // Show feed links.
    ‘feed’ => ‘Feed’,
     
    // Remove title_li.
    ‘title_li’ => »
);
 
wp_list_categories( $args );
 
?>

Получение и отображение HTML- wp_dropdown_categories() категорий: wp_dropdown_categories()

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

параметры

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

  • $args (необязательно — массив) :
    Массив следующих аргументов:
    • 'show_option_all' (строка): текст для отображения для отображения всех категорий / таксономий.
      (По умолчанию: пусто)
    • 'show_option_none' (строка): текст для отображения без отображения категорий / таксономий.
      (По умолчанию: пусто)
    • 'option_none_value' (смешанный): значение, используемое, когда категория / таксономия не выбрана.
      (По умолчанию: -1)
    • 'orderby' (строка): какой столбец использовать для упорядочивания категорий / таксономий.
      (По умолчанию: «ID»)
    • 'order' (строка): в каком направлении упорядочить категории / таксономии.
      По умолчанию: «ASC»
    • 'show_count' (логическое или целое): показывать, сколько сообщений в категории / таксономии.
      (По умолчанию: 0)
    • 'hide_empty' (логическое или целое): скрывать ли категории / таксономии, к которым не прикреплены какие-либо сообщения.
      (По умолчанию: 1)
    • 'child_of' (целое число): Показать все категории, которые являются потомками данного идентификатора.
      (По умолчанию: 0)
    • 'exclude' (строка): список разделенных запятыми идентификаторов категорий / таксономий, которые необходимо исключить из списка.
      (По умолчанию: пусто)
    • 'echo' (логическое или целое): отображать или получать содержимое.
      (По умолчанию: 1)
    • 'depth' (целое число): максимальная глубина.
      (По умолчанию: 0)
    • 'tab_index' (integer): индекс табуляции для элемента SELECT .
      (По умолчанию: 0)
    • 'name' (строка): значение атрибута NAME для элемента SELECT .
      По умолчанию: «кошка»
    • 'id' (строка): идентификатор элемента SELECT .
      (По умолчанию: пусто)
    • 'class' (string): CSS-класс для элемента SELECT .
      По умолчанию: «постформа»
    • 'selected' (целое число): идентификатор категории / таксономии, который будет выбран по умолчанию.
      (По умолчанию: 0)
    • 'taxonomy' (строка): название таксономии для извлечения.
      По умолчанию: «категория»

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
<?php
 
$args = array(
    ‘show_option_none’ => __( ‘Nothing!’, ‘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 (необязательно — массив) :
    Массив следующих аргументов:
    • 'smallest' (целое число): наименьший размер текста.
      (По умолчанию: 8)
    • 'largest' (целое): 'largest' большой размер текста.
      (По умолчанию: 22)
    • 'unit' (строка): Единица размера текста.
      По умолчанию: «pt»
    • 'number' (строка): сколько тегов вернуть
      (По умолчанию: 45)
    • 'format' (строка): как вернуть список тегов — «flat» для плоского списка, разделенного пробелами, «list» для неупорядоченного списка HTML и «array» для массива PHP.
      По умолчанию: «плоский»
    • 'separator' (строка): текст разделителя.
      По умолчанию: «\ n»
    • 'orderby' (строка): как упорядочить теги по (‘name’ или ‘count’).
      (По умолчанию: «имя»)
    • 'order' (строка): заказывать элементы в порядке возрастания (ASC) или убывания (DESC).
      По умолчанию: «ASC»
    • 'include' (массив): массив идентификаторов для включения.
      (По умолчанию: пусто)
    • 'exclude' (массив): массив идентификаторов для исключения.
      (По умолчанию: пусто)
    • 'taxonomy' (строка): таксономия, чтобы получить условия.
      По умолчанию: ‘post_tag’
    • 'link' (строка): «просмотр» для внешнего просмотра, «редактирование» для внутренних ссылок редактирования. Работает с аргументом post_type.
      (Вид по умолчанию’)
    • 'post_type' (строка): если аргумент ‘link’ установлен на ‘edit’, вы должны установить для ‘post_type’ тип поста, чтобы указать, какой тип постов будет в списке «редактировать ссылки».
      (По умолчанию: пусто)
    • 'echo' (логическое значение): выводить тег шаблона или нет.
      (По умолчанию: TRUE )

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<?php
 
$args = array(
     
    // Smallest & largest font sizes.
    ‘smallest’ => 10,
    ‘largest’ => 32,
     
    // Get only 20 tags.
    ‘number’ => 20,
     
    // Order by term popularity.
    ‘orderby’ => ‘count’,
     
    // Custom taxonomy.
    ‘taxonomy’ => ‘brands’,
     
    // Return output instead of echoing.
    ‘echo’ => 0
);
 
$tag_cloud = wp_tag_cloud( $args );
 
?>

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

Этот шаблонный тег возвращает облако тегов, но на этот раз вы можете выбрать свои собственные теги.

параметры

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

  • $tags (обязательно — массив) :
    Массив списка тегов.
    (По умолчанию: NULL )
  • $args (необязательно — массив) :
    Массив следующих аргументов:
    • 'smallest' (целое число): наименьший размер текста.
      (По умолчанию: 8)
    • 'largest' (целое): 'largest' большой размер текста.
      (По умолчанию: 22)
    • 'unit' (строка): Единица размера текста.
      По умолчанию: «pt»
    • 'number' (строка): сколько тегов вернуть
      (По умолчанию: 0)
    • 'format' (строка): как вернуть список тегов — «flat» для плоского списка, разделенного пробелами, «list» для неупорядоченного списка HTML и «array» для массива PHP.
      По умолчанию: «плоский»
    • 'separator' (строка): текст разделителя.
      По умолчанию: «\ n»
    • 'orderby' (строка): как упорядочить теги по (‘name’ или ‘count’).
      (По умолчанию: «имя»)
    • 'order' (строка): заказывать элементы в порядке возрастания (ASC) или убывания (DESC).
      По умолчанию: «ASC»
    • 'topic_count_text' (строка): это множественное число с nooped от _n_noop () для генерации текста для всплывающей подсказки ссылки тега.
      (По умолчанию: NULL )
    • 'topic_count_text_callback' (строка): это функция обратного вызова, которая дает счетчик сообщений с этим тегом возвращает текст для всплывающей подсказки ссылки тега.
      (По умолчанию: NULL )
    • 'topic_count_scale_callback' (строка): это функция обратного вызова, которая работает с «самыми 'smallest' и 'largest' аргументами для вычисления размеров шрифта сгенерированных тегов.
      По умолчанию: default_topic_count_scale
    • 'filter' (integer): если установлено значение 0, функция не пропустит фильтр с тем же именем.
      (По умолчанию: 1)

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
<?php
 
// Get an array of the tags from current post.
$tags = get_the_tags( », ‘, ‘, » );
 
// Set arguments.
$args = array(
    ‘smallest’ => 10,
    ‘largest’ => 36,
    ‘orderby’ => ‘count’
);
 
wp_generate_tag_cloud( $tags, $args );
 
?>

Вывод

Надеюсь, вам понравилась эта вторая партия тегов шаблонов. Осталось еще шесть пакетов, так что следите за обновлениями тегов шаблонов!

Если у вас есть какие-либо вопросы, комментарии или исправления, вы можете поделиться с нами своими мыслями в разделе «Комментарии». И если вам понравилась статья, не забудьте поделиться ею с друзьями!

34
Share: