has_custom_header()
Перевіряє, чи встановлено зображення для шапки теми, чи встановлено відео та доступно для показу на поточній сторінці запиту.
Функція спрацює (поверне true), якщо в налаштуваннях теми (касомайзері) для шапки встановлено зображення. Або якщо встановлено відео і це відео має покочуватися на поточній сторінці (зазвичай відео відображається лише на головній сторінці).
Можливість встановлення картинки або відео для шапки активується через add_theme_support( ‘custom-header’ );
(швидко) | 50000 разів – 2.97 сек
(швидко) |
PHP 7.1.0, WP 4.7
Хуків немає.
Повертає
true|false. True – якщо встановлений елемент для шапки. False – якщо ні.
Використання
if( has_custom_header() ){
// для заголовка теми встановлено відео або зображення
}Приклади
#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() has custom header WP 6.0.2
function has_custom_header() {
if ( has_header_image() || ( has_header_video() && is_header_video_active() ) ) {
return true;
}
return false;
}