the_tags()

Отображает метки (теги) записи
Функция WordPress
INT 2.3.0
WordPress Icon

Описание функции

Функция the_tags() используется для вывода тегов, связанных с определенным постом. Она отображает список тегов, которые были присвоены данному посту, и предоставляет возможность настроить формат вывода тегов.

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

the_tags( string $before = null, string $sep = ', ', string $after = '' )

Функция the_tags() принимает три необязательных параметра:

  • $before: Строка, которая будет выведена перед списком тегов. По умолчанию: null.
  • $sep: Строка, которая будет использоваться в качестве разделителя между тегами. По умолчанию: ', '.
  • $after: Строка, которая будет выведена после списка тегов. По умолчанию: ''.
<?php
  $before = 'Tags: ';
  $sep = ', ';
  $after = '';
  the_tags($before, $sep, $after);
?>

В данном примере кода функция the_tags() вызывается с заданными значениями параметров $before, $sep и $after. В результате будет выведен список тегов, начинающийся со строки «Tags: «, с разделителем «, » между тегами, и без строки после списка тегов.

Примеры использования

Отображение тегов для поста


/**
 * Отображает теги для поста.
 *
 * @param string $before Optional. Строка, которая будет выведена перед тегами. По умолчанию: 'Tags:'.
 * @param string $sep Optional. Строка, которая будет использоваться между тегами. По умолчанию: ', '.
 * @param string $after Optional. Строка, которая будет выведена после тегов. По умолчанию: ''.
 */
the_tags();

Форматирование тегов


/**
 * Отображает теги для поста с указанным форматированием.
 *
 * @param string $before Optional. Строка, которая будет выведена перед тегами. По умолчанию: 'Tags:'.
 * @param string $sep Optional. Строка, которая будет использоваться между тегами. По умолчанию: ', '.
 * @param string $after Optional. Строка, которая будет выведена после тегов. По умолчанию: ''.
 */
the_tags( '<ul><li>', '</li><li>', '</li></ul>' );

Создание ссылок на теги


/**
 * Отображает теги для поста с созданием ссылок на теги.
 *
 * @param string $before Optional. Строка, которая будет выведена перед тегами. По умолчанию: 'Tags:'.
 * @param string $sep Optional. Строка, которая будет использоваться между тегами. По умолчанию: ', '.
 * @param string $after Optional. Строка, которая будет выведена после тегов. По умолчанию: ''.
 */
the_tags( '<ul><li><a href="' . get_tag_link() . '">', '</a></li><li><a href="' . get_tag_link() . '">', '</a></li></ul>' );

Добавление префикса перед тегами


/**
 * Отображает теги для поста с добавлением префикса перед тегами.
 *
 * @param string $before Optional. Строка, которая будет выведена перед тегами. По умолчанию: 'Tags:'.
 * @param string $sep Optional. Строка, которая будет использоваться между тегами. По умолчанию: ', '.
 * @param string $after Optional. Строка, которая будет выведена после тегов. По умолчанию: ''.
 */
the_tags( 'Tagged with: ' );

Изменение разделителя между тегами


/**
 * Отображает теги для поста с изменением разделителя между тегами.
 *
 * @param string $before Optional. Строка, которая будет выведена перед тегами. По умолчанию: 'Tags:'.
 * @param string $sep Optional. Строка, которая будет использоваться между тегами. По умолчанию: ', '.
 * @param string $after Optional. Строка, которая будет выведена после тегов. По умолчанию: ''.
 */
the_tags( '', ' | ' );

Вопросы и ответы

Как изменить текст перед тегами?

Функция the_tags() позволяет изменить текст, который будет отображаться перед тегами.

Для этого нужно передать строку в качестве первого аргумента функции the_tags().

Например, чтобы изменить текст на «Метки:», нужно вызвать функцию следующим образом:


the_tags('Метки: ');

Как изменить разделитель между тегами?

Функция the_tags() также позволяет изменить разделитель, который будет использоваться между тегами.

Для этого нужно передать строку в качестве второго аргумента функции the_tags().

Например, чтобы изменить разделитель на «|», нужно вызвать функцию следующим образом:


the_tags('', ' | ');

Как изменить текст после тегов?

Функция the_tags() также позволяет изменить текст, который будет отображаться после тегов.

Для этого нужно передать строку в качестве третьего аргумента функции the_tags().

Например, чтобы изменить текст на «Конец меток.», нужно вызвать функцию следующим образом:


the_tags('', ', ', ' Конец меток.');

Как вывести только определенное количество тегов?

Функция the_tags() в WordPress позволяет вывести теги для поста. По умолчанию она выводит все теги, связанные с постом. Иногда может потребоваться вывести только определенное количество тегов.

Для этого можно использовать параметр $number, который указывает количество тегов для вывода. Например, чтобы вывести только 3 тега, нужно добавить следующий код:


the_tags('', ', ', '', 3);

Как отобразить теги без ссылок?

По умолчанию, функция the_tags() выводит теги с ссылками на соответствующие архивы. Иногда может потребоваться отобразить теги без ссылок.

Для этого можно использовать параметр $link, который принимает значение false. Например, чтобы отобразить теги без ссылок, нужно добавить следующий код:


the_tags('', ', ', '', false);

Как изменить классы или стили тегов?

Функция the_tags() в WordPress выводит теги с классами по умолчанию. Иногда может потребоваться изменить классы или стили тегов.

Для этого можно использовать параметр $class, который позволяет указать классы для тегов. Например, чтобы добавить класс «my-tag» к тегам, нужно добавить следующий код:


the_tags('', ', ', ' ', true, 'my-tag');

Как вывести теги только для определенного поста?

Функция the_tags() позволяет вывести теги только для определенного поста. Для этого необходимо передать в качестве первого параметра идентификатор поста.


$post_id = 123; // идентификатор поста
the_tags('', ', ', '', $post_id);

Как вывести теги в определенном порядке?

Функция the_tags() выводит теги в порядке их добавления к посту. Вы можете изменить порядок тегов, используя хук get_the_tags. Для этого необходимо добавить следующий код в файл functions.php вашей темы:


function custom_get_the_tags($tags, $post_id) {
    // изменяем порядок тегов
    shuffle($tags);
    return $tags;
}
add_filter('get_the_tags', 'custom_get_the_tags', 10, 2);

Как вывести теги с определенным разделителем?

Функция the_tags() выводит теги с разделителем по умолчанию — запятой и пробелом. Вы можете изменить разделитель, передав его вторым параметром:


the_tags('', ' | ', '');

Функция the_tags() позволяет выводить теги для поста в WordPress. Она предоставляет возможность указать текст, который будет выведен перед тегами, разделитель между тегами и текст, который будет выведен после тегов. Также, с помощью хука get_the_tags можно изменить порядок тегов. Функция является удобным инструментом для работы с тегами в WordPress.

Связанные элементы

  • Функция get_the_tags(): Возвращает массив объектов тегов, связанных с текущим постом.
  • Функция has_tag(): Проверяет, содержит ли текущий пост указанный тег.
  • Функция tag_description(): Возвращает описание указанного тега.
  • Функция get_tag_link(): Возвращает URL-адрес ссылки на указанный тег.
  • Функция get_tags(): Возвращает массив объектов тегов, связанных с постами, удовлетворяющими указанным параметрам.
Обсуждение