Функция the_custom_header_markup()

Введение

Функция the_custom_header_markup() в WordPress используется для отображения разметки пользовательского заголовка. Это позволяет вам добавлять изображения или видео в заголовок вашего сайта.

Основная информация

• Версия: WP 4.7.0 и выше
• Возвращаемое значение: null — ничего (пустое значение).

Исполнение

Чтобы использовать эту функцию, просто вставьте следующую строку в ваш шаблон:

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

Пример 1: Отображение заголовка с изображением

При вызове функции the_custom_header_markup(), если у вас загружено изображение, она создаст следующий HTML-код:

Пример 2: Отображение заголовка с видео

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

В результате HTML-код будет выглядеть так:

    
    Пауза

Код функции

Вот как выглядит реализация функции the_custom_header_markup():

function the_custom_header_markup() {
$custom_header = get_custom_header_markup();
if ( empty( $custom_header ) ) {
return;
}

echo $custom_header;

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

}

Объяснение кода

1. Функция проверяет, есть ли доступная разметка заголовка с помощью get_custom_header_markup().
2. Если разметка пуста, функция просто завершает работу и ничего не выводит.
3. Если разметка есть, она отображается с помощью echo.
4. Если заголовок с видео активен, подключаются необходимые скрипты.

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

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

• get_custom_header_markup()
• get_header_image()
• has_custom_header()
• has_header_video()
• is_header_video_active()

Эти функции помогают управлять заголовками, изображениями и видео на вашем сайте.

Заключение

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