Получение Разметки Пользовательского Заголовка в WordPress

Функция get_custom_header_markup() позволяет получить разметку для пользовательского заголовка в WordPress. Это полезно, если вы хотите настроить заголовок вашего сайта.

Когда использовать

Эта функция используется в основном в следующих случаях:

• Для отображения изображения заголовка с сайта.
• Если ваш сайт поддерживает пользовательские заголовки.

Что возвращает

Функция возвращает строку — разметку для пользовательского заголовка в случае успешного выполнения.

Как использовать

Для вызова функции просто используйте следующий код:

get_custom_header_markup();

Пример использования

Давайте рассмотрим пример, как можно использовать get_custom_header_markup() для отображения заголовка с изображением:

// Проверяем, есть ли заголовок
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-код, похожий на этот:

Изменения в коде

Функция get_custom_header_markup() была введена в версии 4.7.0. Код функции выглядит следующим образом:

function get_custom_header_markup() {
if ( ! has_custom_header() && ! is_customize_preview() ) {
return '';
}

return sprintf(
    '
%s
',
    get_header_image_tag()
);

}

Связанные функции

Есть несколько других функций, которые могут быть полезны при работе с пользовательскими заголовками:

• get_header_image() — для получения изображения заголовка.
• has_custom_header() — для проверки, установлен ли пользовательский заголовок.
• is_header_video_active() — для проверки, активно ли видео заголовка.

Заключение

Используя функцию get_custom_header_markup(), вы можете легко настроить заголовок вашего сайта. Эта функция позволяет отображать изображение заголовка или видео, что улучшает внешний вид вашего веб-сайта. Не забудьте проверить, поддерживает ли ваша тема пользовательские заголовки!