Функция get_header_video_url() предназначена для получения URL видео заголовка, установленного в настройках кастомизации темы. Эта функция позволяет работать как с локальными, так и с внешними видео, что добавляет гибкость в настройку заголовка сайта.
Описание
С помощью функции get_header_video_url() можно получить ссылку на локальное видео, если оно доступно. Если локальное видео отсутствует, функция автоматически вернет URL внешнего видео. Если ни одно из видео не задано, будет возвращено значение false.
С версии 4.7 WordPress добавил возможность устанавливать видео заголовка, что дополнительно к изображениям позволяет сделать сайт более динамичным и привлекательным.
get_header_video_url(): string|falseВозвращаемое значение
- Строка: URL на видео заголовка.
- false: Если видео не установлено.
Пример 1: Вывод видео заголовка
Данный пример проверяет, есть ли установленное видео заголовка, и если оно есть, выводит его с помощью шорткода для видео:
$url = get_header_video_url();
if ($url) {
echo wp_video_shortcode(array(
'src' => $url,
'poster' => '',
'height' => 400,
'width' => 600,
));
}
Результат:
<div style="width:600px;" class="wp-video">
<!--[if lt IE 9]><script>document.createElement('video');</script><![endif]-->
<video class="wp-video-shortcode" id="video-123-4" width="600" height="400" preload="metadata" controls="controls">
<source type="video/mp4" src="http://example.com/wp-content/uploads/2024/09/sample-video.mp4" />
<a href="http://example.com/wp-content/uploads/2024/09/sample-video.mp4">http://example.com/wp-content/uploads/2024/09/sample-video.mp4</a>
</video>
</div>Пример 2: Проверка наличия видео
В этом примере можно использовать функцию, чтобы проверить, есть ли установленное видео, и выполнить соответствующие действия:
$url = get_header_video_url();
if ($url) {
// Выполняем дополнительные действия, если видео есть
echo "Заголовок имеет видео: " . esc_url($url);
} else {
echo "Видео заголовка не установлено.";
}
Результат:
"http://example.com/wp-content/uploads/2024/09/sample-video.mp4Пример 3: Использование в условии
Вы можете использовать get_header_video_url() в условиях для изменения поведения темы в зависимости от наличия видео:
if (get_header_video_url()) {
// Логика для страниц с видео заголовком
echo '<p>Этот заголовок содержит видео!</p>';
} else {
// Логика для страниц без видео
echo '<p>Заголовок без видео.</p>';
}
Заключение
Функция get_header_video_url() является полезным инструментом для разработчиков тем WordPress, позволяющим добавлять динамические элементы в заголовки. Она облегчает работу с видео заголовками, позволяя использовать как локальные, так и внешние ресурсы, что значительно улучшает пользовательский опыт на сайте.