single_term_title()

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

Параметры

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

Возвращает

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

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

  1. Функция часто используется в шаблонах архива таксономий (taxonomy.php, archive.php).
  2. Вернет или выведет название элемента таксономии, если на странице отображается только один термин таксономии.

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

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

single_term_title();

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

single_term_title( 'Категория: ' );

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

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

$term_title = single_term_title('', false);
echo $term_title;

Хуки

single_cat_title single_tag_title single_term_title

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

Добавлена в версии 3.1.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_tag_title()

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

single_cat_title()

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