Теги шаблонов WordPress – Теги меток.

• wp_tag_cloud (С версии 2.3)
• the_tags (С версии 2.3)
• get_the_tags (С версии 2.3)
• get_the_tag_list (С версии 2.3)
• single_tag_title (С версии 2.3)

wp_tag_cloud

wp_tag_cloud выводит список меток который называют “облако меток”, где размер каждой метки зависит от того сколько раз она употребляется.

Параметры:

smallest

(integer) Размер текста метки с самым малым числом.

largest

(integer) Размер текста метки с самым большим числом.

unit

(string) Единица измерения для smallest и largest. Например: pt, px, em, %; по умолчанию pt (пункты).

number

(integer) Количество выводимых меток. (Используйте ’0′ для вывода всех меток.)

format

(string) Форматирование вывода облака меток.

• 'flat' (По умолчанию) разделяются пробелом
• 'list' метки заключаются в список UL с классом class=’wp-tag-cloud’
• 'array' метки возвращаются в виде архива для использования в PHP.

orderby

(string) Сортировка меток по:

• 'name' (По умолчанию) по имени
• 'count'

order

(string) Сортировка. В верхнем регистре:

• 'ASC' (По умолчанию)
• 'DESC'
• 'RAND' случайным образом.

exclude

(string) Список меток для исключения, разделенные запятой. Например, ‘exclude=5,27′ исключит метки с the term_id 5 или 27.

include

(string) Список меток для добавления, разделенные запятой. Например, ‘include=5,27′ добавит метки с the term_id 5 или 27.

Примеры:

Использование по умолчанию:

$defaults = array('smallest' => 8, 'largest' => 22,
  'unit' => 'pt', 'number' => 45, 'format' => 'flat',
  'orderby' => 'name', 'order' => 'ASC','exclude' => , 'include' => );

При использовании по умолчанию выводятся:

• smallest – Самая маленькая метка выводится размером 8
• largest – Самая большая метка выводится размером 22
• unit – Единица измерения по умолчанию ‘pt’ (пункты)
• number – Выводит 45 меток
• format – Выводит метки в плоском стиле (разделенными пробелами)
• orderby -Сортировка по имени
• order – Сортировка по возрастанию
• exclude – Не исключаются метки
• include – Добавляются все метки

Вывод популярных меток:

<?php if ( function_exists('wp_tag_cloud') ) : ?>
<li>
<h2>Popular Tags</h2>
<ul>
<?php wp_tag_cloud('smallest=8&largest=22'); ?>
</ul>
</li>
<?php endif; ?>

Ограничение до 30 меток и сортировка по числу употреблений:

<?php wp_tag_cloud('smallest=8&largest=22&number=30&orderby=count'); ?>

the_tags

Выводит метки(теги) к сообщению. Работает с версии 2.3. Используется в Цикле.

Параметры:

before

(string) Текст до вывода меток. По умолчанию Метки:

separator

(string) Текст которым будет отделяться каждая метка. По умолчанию запятая (,).

after

(string) Текст который будет выводиться после последней метки. По умолчанию нет.

Примеры:

По умолчанию:

<p><?php the_tags(); ?></p>

Разделенные стрелкой:

<?php the_tags('Метки: ',' > '); ?>

В списке:

<?php
the_tags('<ul><li>','</li><li>','</li></ul>');
?>

get_the_tags

Возвращает массив объектов, один объект для каждой метки, назначенной на сообщение. Используется в Цикле.

Поля:

term_id

id метки

name

Имя метки

slug

Короткое имя метки

term_group

Группа метки

taxonomy

Всегда ‘post_tag’ для меток

description

Описание метки

count

Количество использований метки, общее

Примеры:

Эта функция ничего не выводит, она возвращает массив данных для дальнейшего использования.

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo $tag->name . ' ';
}
}
?>

Выод меток в виде изображений названных как term_id и аттрибут alt установлен в название метки name.

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo '<img src="http://example.com/images/' . $tag->term_id . '.jpg"
alt="' . $tag->name . '" />';
}
}
?>

get_the_tag_list

Генерирует HTML строку меток связанных с текущим сообщением. Каждая метка будет ссылкой на страницу метки. Используется в Цикле.

Параметры:

before

(string) Текст выводимый перед метками.

separator

(string) Текст разделяющий метки.

after

(string) Текст выводимый после меток.

Примеры:

Эта функция ничего не выводит, она возвращает данные для дальнейшего использования.

Вывод списка меток заключенных в тег <p>, разделенный запятыми.

<?php
echo get_the_tag_list('<p>Метки: ',', ','</p>');
?>

Результат.

<p>
Метки:
<a href="tag1">1 Метка</a>,
<a href="tag2">2 Метка</a>, ...
</p>

single_tag_title

Выводит или возвращает имя метки для текущего сообщения.

Параметры:

prefix

(string) Текст перед именем метки. По умолчанию '' (нет текста).

display

(boolean) Вывести (TRUE) или вернуть (FALSE). По умолчанию TRUE.

Примеры:

Выводит текст “Сейчас вы просматриваете ” + имя метки.

<p><?php single_tag_title('Сейчас вы просматриваете '); ?>.</p>