Описание функции single_term_title()
Функция single_term_title() выводит название термина (категории, тега и т.д.) для текущего термина в контексте таксономии. Она автоматически определяет, какой термин должен быть отображен, и форматирует его для удобного отображения на сайте.
Функция обычно используется в шаблонах тем для отображения заголовков страниц архивов таксономий.
Параметры
$display
Тип: bool
Обязательный: Нет
По умолчанию: true
Описание: Флаг, указывающий, нужно ли выводить название термина сразу
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: string
Описание: Возвращает название термина в случае, если не происходит немедленный вывод
Возможные значения:
• Строка с названием термина
• null если термин не найден
Примеры использования
single_term_title();
// Выводит название текущего термина
single_term_title('', false);
// Возвращает название термина без немедленного вывода
$term_title = single_term_title('', false);
if ($term_title === null) {
echo 'Термин не найден';
}
// Проверка на существование термина
<h1><?php single_term_title(); ?></h1>
// Выводит заголовок для страницы архива термина
if (is_tag()) {
echo '<h1>';
single_term_title();
echo '</h1>';
}
// Вывод заголовка на странице тега
Безопасность
Валидация входных данных: Параметр display валидируется внутри функции
Санитизация: Функция автоматически обрабатывает данные перед выводом
Рекомендации: Для вывода названий используйте esc_html() для защиты от XSS
— Связанные функции
Получает объект термина по ID
Проверяет существование термина
— Примечания
– Ограничения
Не работает вне контекста термина
– Частые проблемы
- Возвращает null, если текущий термин не установлен
- Неверный вывод при использовании в неправильном контексте
