Описание
Выводит заголовок текущей метки, если просматривается архивная страница метки.
С версии 3.1+ эта функция абсолютно идентична функциям: single_cat_title() и single_term_title(). Более правильно использовать single_term_title() для получения заголовка страниц архивов меток, категорий или других таксономий.
single_tag_title() работает на базе single_term_title().
Функция возвращает текст, заголовок страницы текущей метки. Если заголовок получить не удалось функция ничего не возвращает.
Использование
<?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); ?>
На заметку
- С версии 3.1.0 использует функция single_term_title()
single_tag_title()
из файла: /wp-includes/general-template.php WP 3.3.2function single_tag_title( $prefix = '', $display = true ) {
return single_term_title( $prefix, $display );
}Ещё из раздела
Смотрите также: Функции WordPress и Теги Шаблона.
Как перевести первую букву метки в верхний регистр и вывести?
Использую функцию:
Но тег выводится в нижнем регистре
Извиняюсь, функцию ucfirst, а не ucwords. Но суть от этого не меняется