Описание функции has_custom_header()
Функция has_custom_header() проверяет, установлен ли пользовательский заголовок для текущей темы. Она используется в темах для определения, нужно ли отображать стандартный заголовок или заголовок, заданный пользователем. Эта функция полезна для создания адаптивных и индивидуализированных дизайнов тем.
Функция возвращает true, если пользовательский заголовок установлен, и false в противном случае.
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если пользовательский заголовок установлен, иначе false
Возможные значения:
• true — пользовательский заголовок установлен
• false — пользовательский заголовок не установлен
Примеры использования
Проверка и вывод пользовательского заголовка, если он установлен
if ( has_custom_header() ) {
the_header_image_tag();
} else {
echo '<h1>Стандартный заголовок</h1>';
}
Отображение стандартного заголовка, если пользовательский не установлен
Применение функции в шаблоне темы для динамического выбора заголовка
if ( has_custom_header() ) {
// Выводим пользовательский заголовок
the_custom_header_markup();
} else {
// Используем стандартный заголовок
get_template_part('template-parts/header', 'default');
}
Возможность использования различных шаблонов заголовков
Безопасность
Валидация входных данных: Функция не принимает параметры, поэтому валидация не требуется
Санитизация: Не требуется, так как функция не обрабатывает входные данные
Рекомендации: Используйте функцию внутри условных операторов для проверки наличия заголовка
— Связанные функции
Добавляет поддержку пользовательского заголовка в теме
Получает данные о пользовательском заголовке
— Примечания
– Ограничения
Работает только в контексте темы с поддержкой пользовательских заголовков
– Частые проблемы
- Возвращает false, если поддержка не добавлена в тему
- Не отображает заголовок, если он не установлен
