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() ); }