Как добавить видео в 1С-Битрикс

Видео на страницах сайта под управлением 1С-Битрикс можно добавить несколькими способами: встроить ролик с YouTube или VK Видео через код вставки, загрузить файл напрямую в медиабиблиотеку и вывести его штатным медиаплеером либо разместить видео в описании товара или новости через визуальный редактор. Выбор зависит от того, где размещён ролик и какие требования предъявляются к скорости загрузки страницы.

Самый надёжный вариант для большинства случаев — внешний видеохостинг. Файл хранится на сторонней площадке, не занимает дисковое пространство сайта и не нагружает сервер при просмотрах. Локальная загрузка оправдана, когда ролик нельзя публиковать в открытом доступе или когда требуется полный контроль над показом без сторонней рекламы и логотипов.

Ниже разобраны все рабочие способы: от простой вставки через редактор до вывода видео в инфоблоках и настройки медиаплеера. Отдельно описаны типичные ошибки, из-за которых ролик не отображается на странице, и способы проверить результат.

Способы добавления видео: что выбрать

Перед началом работы определите, где находится ролик и как часто вы планируете публиковать видео. Для единичной вставки в текст статьи достаточно визуального редактора. Если видео — регулярная часть контента (обзоры товаров, видеоинструкции), правильнее настроить отдельное свойство инфоблока и вывод через шаблон компонента.

Учитывайте и формат файла. Браузеры стабильно воспроизводят MP4 (кодек H.264); файлы AVI, MOV или MKV могут не проигрываться штатным плеером. Если ролик в «неудобном» формате, перекодируйте его заранее любым конвертером или загрузите на видеохостинг, который сделает это автоматически.

Вставка видео через визуальный редактор

Это базовый способ, доступный контент-менеджеру без доступа к коду. Откройте страницу, новость или элемент инфоблока на редактирование. В панели визуального редактора найдите кнопку вставки видео (значок плейера; в разных версиях интерфейса она может называться «Вставить видео» или находиться в меню «Вставить»).

1. 1
   Откройте нужную страницу или элемент в режиме редактирования и установите курсор в место вставки ролика.
2. 2
   Нажмите кнопку «Вставить видео» на панели визуального редактора.
3. 3
   Укажите источник: ссылку на ролик с видеохостинга или загрузите файл с компьютера через диалог выбора.
4. 4
   Задайте размеры плеера (ширину и высоту) и при необходимости включите автовоспроизведение — для основного контента его лучше отключить.
5. 5
   Сохраните страницу и откройте её в публичном разделе: проверьте, что плеер отображается и ролик запускается.

После вставки редактор формирует код плеера автоматически. Не редактируйте его вручную без необходимости: при следующем открытии страницы в визуальном режиме редактор может перезаписать ручные правки. Если нужно точное позиционирование, переключитесь в режим HTML и работайте уже там.

Вставка ролика с YouTube или VK Видео через код

На странице ролика на видеохостинге нажмите «Поделиться» и скопируйте код вставки — это фрагмент с тегом <iframe>. В редакторе Битрикс переключитесь в режим исходного кода (кнопка «HTML» или «Источник») и вставьте код в нужное место текста. Сохраните страницу.

Частая проблема: после сохранения iframe исчезает. Причина — настройки фильтрации визуального редактора или прав группы пользователей. Проверьте настройки модуля «Управление структурой» и права группы, под которой работает редактор: у пользователя должно быть разрешение на использование HTML без фильтрации. Обычно это доступно администраторам и контент-редакторам с расширенными правами.

Для адаптивности задайте iframe ширину 100% и оберните его в контейнер с пропорциональной высотой, если шаблон сайта не делает это автоматически. Иначе на мобильных устройствах плеер может выходить за границы экрана.

Загрузка видеофайла и вывод через медиаплеер Битрикс

Если ролик должен храниться на сайте, загрузите файл через медиабиблиотеку (Контент → Медиабиблиотека) или через диалог вставки видео в редакторе. Файл попадёт в структуру /upload/ и получит внутренний идентификатор. Штатный медиаплеер Битрикс умеет воспроизводить MP4 и FLV и выводится как в редакторе, так и через компонент в публичной части.

Обратите внимание на ограничения загрузки. Максимальный размер файла определяется настройками PHP на сервере: параметры upload_max_filesize и post_max_size. Если ролик весит больше установленного лимита, загрузка оборвётся без понятного сообщения. Лимит можно увеличить в настройках хостинга или в файле .htaccess / конфигурации PHP, либо загрузить файл по FTP в папку /upload/ и привязать его через медиабиблиотеку.

Видео в инфоблоках: товары, новости, статьи

Для каталога товаров или регулярных видеопубликаций удобнее хранить ссылку на ролик в отдельном свойстве инфоблока. Создайте свойство типа «Строка» (для ссылки на YouTube/VK) или «Файл» (для загружаемого видео) в настройках нужного инфоблока. Заполняйте его при редактировании элемента — так видео будет привязано к конкретному товару и не потеряется в тексте описания.

Вывод настраивается в шаблоне компонента (например, catalog.element или news.detail). Для ссылки на YouTube достаточно извлечь идентификатор ролика и подставить его в iframe. Для файлового свойства используйте штатный вызов медиаплеера через компонент bitrix:player или API ядра.

<?$APPLICATION->IncludeComponent("bitrix:player","",array("PATH" => $arResult["DISPLAY_PROPERTIES"]["VIDEO"]["FILE_VALUE"]["SRC"],"WIDTH" => "640","HEIGHT" => "360","TYPE" => "video"));?>

Работы с шаблоном компонента выполняйте в кастомизированном шаблоне (скопируйте его в папку шаблона сайта), а не в файлах ядра. Правки в системных шаблонах будут стёрты при очередном обновлении продукта.

Проверка результата и типичные ошибки

После публикации откройте страницу в браузере в режиме инкогнито — так вы увидите её глазами посетителя без кэша административной сессии. Проверьте: плеер отображается, ролик запускается, звук и разматывание работают, на мобильном устройстве плеер не ломает вёрстку.

Если ролик на внешнем хостинге не отображается, проверьте настройки приватности самого ролика: видео с ограничением «только по ссылке» или запретом встраивания на сторонних сайтах не будет воспроизводиться на вашей странице. Это настраивается на стороне видеохостинга.

Частые вопросы