Описание функции the_header_video_url()
Функция the_header_video_url() возвращает URL видео для заголовка, если он установлен в настройках темы. Используется в темах, поддерживающих видео-заголовки, чтобы получить ссылку на видео, которое будет отображаться в заголовке сайта.
Функция обеспечивает доступ к видео заголовку, заданному в настройках кастомайзера
Возвращаемое значение
Тип: string|null
Описание: URL видео заголовка или null, если видео не установлено
Возможные значения:
• Строка с URL видео заголовка при наличии
• null если видео заголовка не установлено
Примеры использования
Базовый пример получения и отображения URL видео заголовка
$video_url = the_header_video_url();
if ($video_url) {
echo 'URL видео: ' . esc_url($video_url);
} else {
echo 'Видео не установлено';
}
Отобразит URL видео или сообщение о том, что видео не установлено
Использование функции в HTML-коде темы для отображения видео заголовка
<header class='site-header'>
<video src='<?php echo esc_url(the_header_video_url()); ?>' controls></video>
</header>
Проверяйте наличие видео перед выводом
Безопасность
Валидация входных данных: Нет параметров для валидации
Санитизация: URL автоматически очищается через esc_url() при выводе
Рекомендации: Всегда используйте esc_url() для вывода URL
— Связанные функции
Получает URL видео заголовка без вывода
Выводит HTML-разметку для пользовательского заголовка
— Примечания
– Ограничения
Функция возвращает URL только если видео установлено в настройках темы
– Частые проблемы
- Возвращает null, если видео не установлено
- Некорректный вывод при отсутствующем заголовочном видео
