Описание функции wp_video_shortcode()
Функция wp_video_shortcode() генерирует HTML-код для встраивания видео на страницу или запись в WordPress. Позволяет использовать различные атрибуты для настройки внешнего вида видео. Эта функция используется в основном в контексте коротких кодов для вставки видео файлов, таких как MP4, WebM, Ogg и других форматов.
Функция поддерживает различные параметры для управления воспроизведением и внешним видом видео.
Параметры
$atts
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Ассоциативный массив атрибутов для настройки видео
Возможные значения:
src: URL видеофайла
width: Ширина видео в пикселях
height: Высота видео в пикселях
poster: URL изображения для предварительного просмотра
loop: 1,
autoplay: 1,
controls: 1,
Возвращаемое значение
Тип: string
Описание: HTML-код для вставки видео на страницу
Возможные значения:
• HTML-тег
• Пустая строка в случае отсутствия src
Примеры использования
Простой пример вставки видео с заданным источником
$video = wp_video_shortcode(array('src' => 'video.mp4'));
echo $video;
Вставка видео с размерами и элементами управления
$video = wp_video_shortcode(array('src' => 'video.mp4', 'width' => 640, 'height' => 360, 'controls' => true));
echo $video;
Элемент
Проверка на наличие источника видео
$video = wp_video_shortcode(array('src' => ''));
if(empty($video)) {
echo 'Ошибка: источник видео не указан';
}
Вывод сообщения об ошибке при отсутствии источника
Создание собственного короткого кода для вставки видео
function my_video_shortcode() {
return wp_video_shortcode(array('src' => 'video.mp4', 'poster' => 'poster.jpg'));
}
add_shortcode('my_video', 'my_video_shortcode');
Теперь можно использовать [my_video] в записях
Безопасность
Валидация входных данных: Проверка URL и значений параметров внутри функции
Санитизация: URL очищается с помощью esc_url() перед вставкой
Рекомендации: Используйте esc_html() для вывода пользовательских данных
— Связанные функции
Создает короткий код для вставки аудио
Регистрация обработчика для встраивания медиа
— Хуки
Фильтрует атрибуты перед генерацией HTML для видео
— Примечания
– Ограничения
Не поддерживает все форматы видео, только перечисленные в документации
– Частые проблемы
- Ошибка при отсутствии атрибута src
- Некорректное отображение при неправильных параметрах ширины/высоты
