Описание функции single_cat_title()
Функция single_cat_title() используется для отображения заголовка текущей категории на страницах архивов категорий. Она выводит название категории, в которую попадает текущий пост или страница. Если не указано, используется заголовок текущей категории по умолчанию.
Функция может быть использована в шаблонах категорий и в других местах, где необходимо отобразить название категории.
Параметры
$display
Тип: bool
Обязательный: Нет
По умолчанию: true
Описание: Определяет, нужно ли выводить заголовок сразу или возвращать его в виде строки
Возможные значения:
true: Выводит заголовок сразу
false: Возвращает заголовок как строку
Возвращаемое значение
Тип: string|void
Описание: Возвращает название текущей категории или ничего, если выводится сразу
Возможные значения:
• Строка с названием категории при display=false
• Нет значения при display=true
Примеры использования
Выводит название текущей категории на странице архива
single_cat_title();
Например, ‘Новости’
Получение названия категории без немедленного вывода
$cat_title = single_cat_title('', false);
// Выводим заголовок в другом месте
echo $cat_title;
Используется когда нужно отобразить заголовок позже
Безопасность
Валидация входных данных: Функция не принимает пользовательских входных данных
Санитизация: Не требуется, так как обрабатывает только внутренние данные WordPress
Рекомендации: При выводе заголовка используйте esc_html() для защиты от XSS
— Связанные функции
Получает название категории по ID
Получает описание текущей категории
— Примечания
– Ограничения
Не работает вне контекста категории
– Частые проблемы
- Пустой вывод, если нет текущей категории
- Некорректный вывод при использовании в неправильном контексте
