get_custom_header_markup()
Отримує розмітку HTML для заголовка шапки. Там може бути картинки та відео.
У кастомайзері <div> в якому повинен бути заголовок виводитися завжди незалежно від того, чи встановлений заголовок для теми чи ні.
Функція виводить HTML картинки, якщо вона є оберненою в <div id="wp-custom-header" class="wp-custom-header">.
Щоб показати відео заголовка, якщо воно є і повинне відображатись на поточній сторінці, потрібно підключити скрипт:
if( is_header_video_active() && ( has_header_video() || is_customize_preview() ) ){
wp_enqueue_script( 'wp-custom-header');
}Використовуйте the_custom_header_markup() , щоб відразу вивести HTML на екран і підключити потрібні скрипти відео, якщо відео доступне на сторінці.
Працює на основі:
get_header_image_tag()
get_header_image_tag()
Основа для:
the_custom_header_markup()
the_custom_header_markup()
Хуків немає.
Повертає
Строку. HTML код зображення заголовка.
Використання
$html = get_custom_header_markup();
Приклади
#1 Виведемо HTML код заголовка шапки
Цей код виведе картинку шапки.
// функція сама перевіряє, чи є заголовок для шапки - has_custom_header()
echo get_custom_header_markup();
// Якщо є відео шапки і воно працює для поточної сторінки підключимо скрипт щоб показати відео.
if ( is_header_video_active() && ( has_header_video() || is_customize_preview() ) ) {
wp_enqueue_script( 'wp-custom-header');
wp_localize_script( 'wp-custom-header', '_wpCustomHeaderSettings', get_header_video_settings() );
}В результаті отримаємо слід. HTML код:
<div id="wp-custom-header" class="wp-custom-header"> <img src="http://example.com/wp-content/uploads/2016/05/cropped.jpg" width="954" height="1300" alt="Тестовий сайт" srcset="http://example.com/wp-content/uploads/2016/05/cropped.jpg 954w, http://example.com/wp-content/uploads/2016/05/cropped-220x300.jpg 220w , http://example.com/wp-content/uploads/2016/05/cropped-768x1047.jpg 768w, http://example.com/wp-content/uploads/2016/05/cropped-751x1024.jpg 751w " sizes="(max-width: 954px) 100vw, 954px" /> </div>
список змін
| З версії 4.7.0 | Введено. |
Код get_custom_header_markup() get custom header markup WP 6.0.2
function get_custom_header_markup() {
if ( ! has_custom_header() && ! is_customize_preview() ) {
return '';
}
return sprintf(
'<div id="wp-custom-header" class="wp-custom-header">%s</div>',
get_header_image_tag()
);
}