header_image()
Выводит на экран УРЛ картинки шапки (заголовка), которая устанавливается в настройках темы.
Перед выводом URL очищается через esc_url().
Работает только когда у темы есть возможность устанавливать картинку-шапку.
Используйте get_header_image(), когда нужно получить URL в переменную.
Работает на основе: get_header_image()
1 раз — 0.005023 сек (очень медленно) | 50000 раз — 3.03 сек (быстро)
Хуков нет.
Возвращает
null
. Ничего не выведет если:
-
текущая тема не поддерживает картинку-шапку. Как включить такую поддержку читайте здесь: add_theme_support().
- для текущей темы не установлена картинка заголовка. Устанавливается она в настройках:
Внешний вид > Customize
(Appearance > Customize).
Использование
header_image();
Примеры
#1 Выведем img тег картинки для шапки сайта
<img src="<?php header_image(); ?>" alt="<?php bloginfo('title'); ?>">
Список изменений
С версии 2.1.0 | Введена. |
Код header_image() header image WP 6.5.2
function header_image() { $image = get_header_image(); if ( $image ) { echo esc_url( $image ); } }