get_header_image()
Получает УРЛ картинки шапки (заголовка), которая устанавливается в настройках темы.
get_header_image() работает только когда у темы есть возможность устанавливать картинку-шапку.
Если нужно вывести УРЛ на экран, а не получить его для обработки, используйте функцию header_image().
Работает на основе: get_theme_mod()
Хуков нет.
Возвращает
Строку|false. Пустая строка будет возвращена если:
- текущая тема не поддерживает картинку-шапку. Как включить такую поддержку читайте в этом описании add_theme_support().
- для текущей темы не установлена картинка заголовка. Устанавливается она в настройках: Внешний вид > Заголовок
Использование
get_header_image();
Примеры
#1 Выведем img тег картинки для шапки сайта
<img src="<?php echo get_header_image(); ?>" alt="<?php echo get_bloginfo('title'); ?>">
Список изменений
| С версии 2.1.0 | Введена. |
Код get_header_image() get header image WP 5.9.3
function get_header_image() {
$url = get_theme_mod( 'header_image', get_theme_support( 'custom-header', 'default-image' ) );
if ( 'remove-header' === $url ) {
return false;
}
if ( is_random_header_image() ) {
$url = get_random_header_image();
}
return esc_url_raw( set_url_scheme( $url ) );
}