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

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' => *);

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

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

<?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) Текст который будет выводиться после последней метки. По умолчанию нет.

Примеры:

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

<?php the_tags(); ?>

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

<?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>