single_tag_title()

Функция single_tag_title() возвращает или выводит на экран заголовок текущей метки на архивной странице.

Параметры

  • $prefix string
    Текст, который будет выведен перед заголовком
    По умолчанию: ''
  • $display bool
    Выводить или возвращать заголовок метки
    По умолчанию: true
single_tag_title( $prefix, $display );

Возвращает

string|void Если параметр $display имеет значение false, то возвращает string (заголовок страницы метки).

Дополнительная информация

  1. Функцию принято использовать в файлах архива категорий, меток и других таксономий.
  2. Функция используется вне цикла (loop) WordPress.
  3. Функция полностью идентична single_cat_title().

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

Пример 1. Вывод заголовка метки

single_tag_title();

Пример 2. Вывод заголовка метки и текста перед ним

single_tag_title( 'Архив метки: ' );

Функция не добавляет пробел в конце префикса, его надо добавить вручную.

Пример 3. Запись заголовка метки в переменную

$tag_title = single_tag_title('', false);

Хуки

single_tag_title

Информация о функции

Добавлена в версии 2.3.0

wp-includes/general-template.php

Исходный код в Github

Другие функции

is_time()

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

is_month()

Определяет, является ли текущая страница архивной страницей записей за месяц.

is_year()

Определяет, является ли текущая страница архивной страницей за определенный год.

is_date()

Определяет, является ли текущая страница архивной страницей по дате.

is_category()

Определяет, является ли текущая страница страницей категории.

is_tax()

Определяет, является ли текущая страница архивной страницей кастомной таксономии.

is_tag()

Определяет, является ли текущая страница архивной страницей метки.

is_day()

Определяет, является ли текущая страница архивной страницей по дню.

post_type_archive_title()

Выводит или возвращает заголовок архивной страницы любого типа поста.

single_month_title()

Возвращает или выводит на экран заголовок архивной страницы по месяцам.

get_the_archive_title()

Возвращает заголовок любой архивной страницы.

the_archive_title()

Выводит на экран заголовок архивной страницы.

single_term_title()

Возвращает или выводит на экран заголовок текущего элемента таксономии на архивной странице.

single_cat_title()

Возвращает или выводит на экран заголовок страницы архива категории.