has_custom_header() │ WP 4.7.0

Проверяет установлена ли картинка для шапки темы, или установлено ли видео и доступно для показа на текущей странице запроса.

Функция сработает (вернет true), если в настройках темы (касомайзере) для шапки установлена картинка. Или если установлено видео и это видео должно покатываться на текущей странице (обычно видео показывается только на главной странице).

Возможность устанавливать картинку или видео для шапки активируется через add_theme_support( 'custom-header' );

Работает на основе: has_header_video(), has_header_image(), is_header_video_active()
1 раз — 0.000148 сек (быстро) | 50000 раз — 2.97 сек (быстро) | PHP 7.1.0, WP 4.7

Хуков нет.

Возвращает

true|false. True - если элемент для шапки установлен. False - если нет.

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

if( has_custom_header() ){
	// для заголовка темы установлено видео или картинка
}

Примеры

0

#1 Проверим есть ли картинка или видео для шапки

Если есть то выведем HTML код:

if( has_custom_header() ){
	the_custom_header_markup();
}

Для картинки выведет HTML:

<div id="wp-custom-header" class="wp-custom-header">
	<img 
		src="http://example.com/wp-content/uploads/2016/05/image.jpg" width="954" height="1300" alt="Тестовый сайт" 
		srcset="http://example.com/wp-content/uploads/2016/05/image.jpg 954w, http://example.com/wp-content/uploads/2016/05/image-220x300.jpg 220w, http://example.com/wp-content/uploads/2016/05/image-768x1047.jpg 768w, http://example.com/wp-content/uploads/2016/05/image-751x1024.jpg 751w" 
		sizes="(max-width: 954px) 100vw, 954px"
	/>
</div>

Для видео выведет следующий HTML. А также в подвал будут подключены скрипты. HTML видео создается скриптом и заменяет HTML картинки.

<div id="wp-custom-header" class="wp-custom-header">
	<video id="wp-custom-header-video" autoplay="" loop="" width="954" height="1300" src="http://example.com/wp-content/uploads/2017/01/polina.mp4"></video>
	<button type="button" id="wp-custom-header-video-button" class="wp-custom-header-video-button wp-custom-header-video-play">Пауза</button>
</div>

Скрипты в подвале:

<script type='text/javascript' src='http://example.com/wp-includes/js/wp-custom-header.min.js'></script>

<script type='text/javascript' src='http://example.com/wp-includes/js/mediaelement/mediaelement-and-player.min.js'></script>

<script type='text/javascript' src='http://example.com/wp-includes/js/mediaelement/wp-mediaelement.min.js'></script>

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

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

Код has_custom_header() WP 6.7.1

wp-includes/theme.php 
function has_custom_header() {
	if ( has_header_image() || ( has_header_video() && is_header_video_active() ) ) {
		return true;
	}

	return false;
}

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

Условные теги (все)

Настройки (кастомайзер)