Плагин для WordPress: камера на сайте одним шорткодом
Чтобы вывести камеру на сайт WordPress, писать код не нужно: установите плагин и вставьте один шорткод на любую страницу, в запись или виджет.
Что понадобится
- WordPress 5.8 или новее и PHP 7.4 или новее.
- Активная камера в кабинете VIDEOCAMERA LIVE — проверка подключения должна быть пройдена.
- Zip-архив плагина
videocamera-live— напишите на info@videocamera.ge или позвоните, если его у вас ещё нет.
Установка
- В админке WordPress откройте Plugins → Add New → Upload Plugin, выберите zip-файл и нажмите Install Now. Либо загрузите папку
videocamera-liveв/wp-content/plugins/. - Активируйте плагин в меню Plugins.
- В нашем кабинете откройте настройки встраивания камеры и скопируйте публичный ID — это часть кода встраивания после
/embed/. - Вставьте шорткод на страницу: в блочном редакторе — блок Shortcode, в классическом — прямо в текст, в областях виджетов — блоком Shortcode. В Elementor и других конструкторах тоже есть элемент Shortcode.
Шорткод и его атрибуты
Минимальному варианту нужен один атрибут — публичный ID камеры:
[videocamera_live id="PUBLIC_ID"]
[videocamera_live id="PUBLIC_ID" width="800px" aspect_ratio="4/3" title="Gudauri, ski slope live"]
[videocamera_live id="PUBLIC_ID" key="EMBED_KEY"]| Атрибут | По умолчанию | Что делает |
|---|---|---|
id | — (обязательный) | Публичный ID камеры из кабинета: латинские буквы, цифры, - и _. |
width | 100% | Ширина плеера. Единицы: px, %, em, rem, vw, vh — например, 800px. |
aspect_ratio | 16/9 | Пропорции; высота считается автоматически. Для камеры 4:3 — 4/3. |
title | пусто | Описание фрейма для экранных дикторов, например «Гудаури, склон онлайн». |
key | пусто | Ключ встраивания — только для камеры, у которой в кабинете включено встраивание по ключу. |
Если width или aspect_ratio записаны неверно, плагин подставит значение по умолчанию. Если id нет или он неверный, посетитель ничего не увидит, а вошедший в систему редактор увидит на странице сообщение об ошибке — так проблему замечаете вы, а не посетители.
Страница настроек
На странице Settings → VIDEOCAMERA LIVE одно поле — Base URL, адрес платформы. По умолчанию это https://live.videocamera.ge, и обычно его менять не нужно. Он меняется, только если платформа развёрнута на вашем собственном отдельном сервере; поле принимает только адрес https://.
Чего плагин никогда не делает
- Не хранит и никуда не передаёт RTSP-логин, пароль или IP-адрес камеры. В WordPress есть только публичный ID и параметры отображения.
- Не хранит и не кэширует токены просмотра — платформа выдаёт их заново при каждой загрузке. Поэтому плагины кэширования не сломают трансляцию.
- Не добавляет на сайт свой JavaScript или CSS и не гонит видео через ваш хостинг — сайт не тормозит. Плеер загружается во фрейме, лениво (
loading="lazy"). - Проверяет и экранирует каждый атрибут перед выводом — странный текст в шорткоде не попадёт в HTML в сыром виде.
Можно обойтись и без плагина, вставив обычный iframe-код в блок «Custom HTML», — см. Как встроить камеру на сайт. Плагин просто удобнее и работает даже у редакторов, которым WordPress не разрешает вставлять iframe.
Нужен ли плагину пароль от камеры?
Нет, никогда. В WordPress вводится только публичный ID камеры (и, для встраивания по ключу, ключ встраивания). Данные камеры хранятся только в нашем кабинете, в зашифрованном виде.
Вставил шорткод, но на странице ничего нет. Почему?
Войдите в систему и откройте страницу — как редактор вы увидите текст ошибки. Чаще всего неверно скопирован id. Если плеер появился, но пишет, что просмотр на этом сайте не разрешён, добавьте домен сайта в разрешённые домены.
Можно несколько камер на одной странице?
Да — по шорткоду на камеру, у каждого свой id. Плееры загружаются лениво, страница не утяжеляется.
Работает ли в Elementor и других конструкторах?
Да, если в конструкторе есть элемент Shortcode — в Elementor он есть. Вставьте туда тот же [videocamera_live id="PUBLIC_ID"].