Получение URL-видео заголовка в WordPress (GET_HEADER_VIDEO_URL)

# Получение URL-видео заголовка в WordPress (GET_HEADER_VIDEO_URL)

Функция get_header_video_url() позволяет получить URL видео для заголовка вашего сайта. Она сначала проверяет, есть ли локальное видео, и если его нет, то использует внешнее видео.

## Как это работает?

Эта функция полагается на две другие функции WordPress:

- get_theme_mod() — позволяет получит�� настройки темы.
- wp_get_attachment_url() — возвращает URL файла по его ID.

Также эта функция используется в следующих функциях:

- has_header_video() — проверяет, есть ли видео заголовка.
- the_header_video_url() — выводит URL видео заголовка.

## Возвращаемое значение

Функция может вернуть строку с URL видео или false, если видео отсутствует.

## Использование функции

Для того чтобы получить URL видео заголовка, просто вызовите функцию:

```php
get_header_video_url();

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

Как отобразить видео заголовка, если оно есть

$url = get_header_video_url();
if( $url ){
    echo wp_video_shortcode( array(
        'src'      => $url,
        'poster'   => '',
        'height'   => 400,
        'width'    => 600,
    ) );
}

Этот код проверяет, есть ли URL для видео. Если он есть, функция wp_video_shortcode() создает HTML-код для отображения видео.

Результат кода будет следующим:

История изменений

• С версии 4.7.0 — функция была добавлена в WordPress.

Код функции

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

function get_header_video_url() {
$id = absint( get_theme_mod( 'header_video' ) );

if ( $id ) {
    // Получаем URL файла по ID вложения.
    $url = wp_get_attachment_url( $id );
} else {
    $url = get_theme_mod( 'external_header_video' );
}

/**
 * Фильтрует URL видео заголовка.
 *
 * @param string $url URL видео заголовка, если доступно.
 */
$url = apply_filters( 'get_header_video_url', $url );

if ( ! $id && ! $url ) {
    return false;
}

return sanitize_url( set_url_scheme( $url ) );

}

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

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

• get_custom_header_markup() — получение HTML-разметки кастомного заголовка.
• has_custom_header() — проверяет, есть ли кастомный заголовок.
• the_custom_header_markup() — выводит HTML-разметку кастомного заголовка.

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