has_header_image() │ WP 4.2.0

Проверяет, установлена ли картинка для шапки сайта (custom header).

Функция возвращает true, если для текущего сайта задано изображение шапки через настройки темы или через кастомайзер. Если изображение не установлено — возвращает false.

Часто используется перед выводом шапки сайта, чтобы избежать пустых <img> тегов.

Для того, чтобы была возможность установить картинку заголовка для темы нужно включить поддержку темы custom-header — add_theme_support( 'custom-header' ).

Не путать с get_header_image(), который возвращает URL картинки.

Можно использовать вместе с has_header_video() для комбинированной логики отображения.

Основа для: has_custom_header()

Хуков нет.

Возвращает

true|false. Логические true или false.

Использование

has_header_image();

Примеры

0

#1 Показ изображения или видео 

if ( has_header_video() && is_header_video_active() ) {
	the_custom_header_markup();
}
elseif ( has_header_image() ) {
	echo '<img src="' . esc_url( get_header_image() ) . '" alt="">';
}
-1

#2 Проверим есть ли у темы картинка заголовка

Выведем картинку, если она есть:

if( has_header_image() ){
	echo sprintf( '<img src="%s" alt="%s">', 
		esc_url( get_header_image() ),
		esc_attr( get_bloginfo( 'title' ) )
	);
}

Заметки

Список изменений

С версии 4.2.0 Введена.

Код has_header_image() WP 7.0

wp-includes/theme.php 
function has_header_image() {
	return (bool) get_header_image();
}

theme_support

custom_header (настройки шапки темы: картинка цвет видео)

Другие функции темы