Функция the_header_video_url() в WordPress используется для вывода URL видео, установленного в качестве видео-заголовка в настройках темы (кастомайзере). Эта функция выводит ссылку на локальное видео или внешнее видео, если оно установлено. Если видео для заголовка не было указано, функция не выведет ничего.
the_header_video_url();
- Возвращаемое значение: Функция не возвращает значение напрямую, а выводит URL видео. Если видео отсутствует, ничего не выводится.
Связанные функции
get_header_video_url(): Если нужно не вывести, а получить URL видео для последующей обработки, используйте эту функцию.has_header_video(): Проверяет, установлено ли видео для заголовка, и возвращаетtrue, если оно есть.
Базовый пример: Вывод видео с проверкой
В этом примере проверяется наличие видео-заголовка с помощью функции has_header_video(). Если видео установлено, выводится HTML-разметка тега <video> с источником из функции the_header_video_url().
<?php if ( has_header_video() ) { ?>
<video class="wp-video-shortcode" width="600" height="400" preload="metadata" controls>
<source type="video/mp4" src="<?php the_header_video_url(); ?>" />
</video>
<?php } ?>
Этот код проверяет, установлено ли видео в настройках темы, и, если да, выводит видео с элементом управления воспроизведением.
Пример: Получение и использование URL видео
Если нужно не просто вывести URL, а использовать его в логике программы, например, для динамической обработки, используйте функцию get_header_video_url():
<?php
$video_url = get_header_video_url();
if ( $video_url ) {
echo '<p>Видео доступен по URL: ' . esc_url( $video_url ) . '</p>';
}
?>
Этот код сначала получает URL видео-заголовка и выводит его в абзаце, если видео установлено.
Заключение
Функция the_header_video_url() удобна для вывода URL видео, установленного в настройках заголовка. Она позволяет гибко работать с видео-заголовками в темах WordPress, легко интегрируя их в дизайн сайта. Для более сложной обработки можно использовать связку функций has_header_video() и get_header_video_url(), что позволяет настраивать поведение темы в зависимости от наличия видео.