single_tag_title()
Выводит заголовок текущей метки, если просматривается архивная страница метки.
С версии 3.1+ эта функция абсолютно идентична функциям: single_cat_title() и single_term_title().
Логичнее использовать single_term_title() для получения заголовка страниц архивов меток, категорий или других таксономий.
Работает на основе: single_term_title()
Хуков нет.
Возвращает
Строку|null
. Заголовок страницы текущей метки. Если заголовок получить не удалось функция ничего не возвращает.
Использование
<?php single_tag_title( $prefix, $display ); ?>
- $prefix(строка)
- Текст, который будет показан перед заголовком.
По умолчанию: '' - $display(логический)
- Если установить этот параметр в 0 (false), то результат функции будет возвращен, а не выведен на экран.
По умолчанию: 1 (true)
Примеры
#1 Заголовок текущей метки с предшествующем текстом
Предполагается, что мы просматриваем страницу метки "Продвижение сайтов".
<p><?php single_tag_title('Вы просматриваете метку: '); ?>.</p>
Получим: Вы просматриваете метку: Продвижение сайтов
#2 Заголовок в переменную
Этот пример показывает как получить заголовок в переменную $current_tag, а не выводить его на экран:
<?php $current_tag = single_tag_title("", 0); ?>
Список изменений
С версии 2.3.0 | Введена. |
Код single_tag_title() single tag title WP 6.7.1
function single_tag_title( $prefix = '', $display = true ) { return single_term_title( $prefix, $display ); }