Описание функции header_image()
Функция header_image() возвращает URL заголовочного изображения, установленного для текущей темы. Она используется для получения изображения, которое может быть отображено в заголовке сайта. Эта функция предназначена для работы с темами, поддерживающими заголовочные изображения и позволяет динамически изменять заголовок сайта в зависимости от настроек темы или предпочтений пользователя.
Возвращаемое значение
Тип: string|null
Описание: URL заголовочного изображения или null
Возможные значения:
• Строка с URL заголовочного изображения при его наличии
• null если заголовочное изображение не установлено
Примеры использования
Базовый пример получения и отображения заголовочного изображения
$header_image = header_image();
if ($header_image) {
echo '<img data-lazyloaded="1" src="data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs=" decoding="async" data-src="' . esc_url($header_image) . '" alt="Заголовок">';
}
Выводит изображение, если оно установлено
Проверка наличия заголовочного изображения перед выводом
$header_image = header_image();
if ($header_image !== null) {
echo '<img data-lazyloaded="1" src="data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs=" decoding="async" data-src="' . esc_url($header_image) . '" alt="Заголовок">';
} else {
echo 'Заголовочное изображение не установлено';
}
Выводит сообщение, если заголовочное изображение отсутствует
Безопасность
Валидация входных данных: Нет входных параметров для валидации
Санитизация: Выводимые данные должны быть очищены с помощью esc_url()
Рекомендации: Используйте esc_url() при выводе URL заголовочного изображения
— Связанные функции
Получает значение настроек темы, включая заголовочное изображение
Устанавливает миниатюру для записи, что может быть полезно в контексте заголовков
— Примечания
– Ограничения
Поддерживается только темами, которые объявили поддержку заголовочных изображений
– Частые проблемы
- Возврат null, если заголовочное изображение не установлено
- Некорректный вывод, если не используется esc_url()
