single_term_title()
Выводит на экран или получает заголовок текущей таксономии (категории, метки и т.п.). Предназначена для страниц архивов.
Предназначен для использования в файле шаблона элемента таксономии (термина) для отображения заголовка страницы (названия термина). Пробел между префиксом и заголовком нужно указывать в параметре $prefix, т.е. автоматически пробел не добавляется.
Хуки из функции
Возвращает
Строку|null
. Заголовок текущего элемента таксономии (категории, метки и т.п.). Вернется null, если не удалось получить заголовок или когда результат выводиться на экран.
Использование
<?php single_term_title( $prefix, $display ); ?>
- $prefix(строка)
- Текст, который будет показан перед заголовком.
По умолчанию: '' - $display(логический)
- Если установить этот параметр в 0 (false), то результат функции будет возвращен, а не выведен на экран.
По умолчанию: 1 (true)
Примеры
#1 Заголовок текущей таксономии
Выведем на экран заголовок текущей таксономии "Учебники для школьников" с предшествующем текстом "Вы просматриваете раздел: ". Под таксономией понимается произвольная таксономия, или это может быть раздел категории (рубрики), или метка:
<p><?php single_term_title('Вы просматриваете раздел: '); ?>.</p>
Получим: Вы просматриваете раздел: Учебники для школьников
#2 Получим заголовок в переменную
Пример показывающий, как получить заголовок в переменную $term_title, а не выводить его на экран:
<?php $term_title = single_term_title('', 0); ?>
Список изменений
С версии 3.1.0 | Введена. |