Веб-расширения
Раздел для разработч иков.
Веб-расширения — сторонние программы (веб-модули) внутри приложения Bpium. Расширение состоит из js-файла, css-файл и других ресурсов (например, шаблонов или изображений).
- Модальные — открывают ся в отдельном слое поверх открытого раздела в Bpium (например, каталога с записями). Могут занимать часть экрана или всю рабочую область приложения. При этом основной экран приложение Bpium остается в DOM-дереве. Пример — панель телефонии Oktell.
- Экранные — экранные модули занимают всю рабочую область приложения, замещая в DOM-дереве открытый раздел приложения. Этот тип расширений поддерживается пока не полностью.
- Фоновые — веб-расширение работает в фоне и управляет DOM-деревом (встраивает элементы) в нужный ему момент.
Каждое расширение имеет уникальный код-идентификатор. Код может состоять из латинских букв, цифр и знака дефис.
Исходный код минимального расширения приведен в нашем публичном репозитарии:
https://bitbucket.org/snippets/bpium/d4bMe/blank-modal-extension
Bpium защищает расширения от тиражирования между системами в разных компаниях. Все расширения проходят через систему лице нзирования. Подключение расширения к системе возможно только при наличии лицензии на это расширение в лицензии компании.
Чтобы зарегистрировать расширение в системе лицензирования Bpium, напишите письмо на почту [email protected], указан выбранный уникальный код расширения и ваш регистрационный номер лицензии.
Без регистрации расширения в системе лицензирования подключить его будет невозможно.
Подключать сторонние и собственные расширения можно только в серверной версии.
Файлы расширения необходимо разместить на внешнем веб-сервере или положить в рабочую папку на сервере Bpium (если у вас несколько серверов, то на каждый сервер):
bpium_path/www/modules/my-extension/Список подключенных расширений храниться в каталоге «Расширения» в отделе «Система». Для подключения расширения создайте новую запись в этом каталоге:
- Название — название расширения в главном меню приложения
- Код — уникальный идентификатор расширения, должен совпадать названием модуля в скрипте (переменная moduleName)
- JS URL — относительный или абсолютный путь до js-скртипта. Например для локально размещенного расширения:
modules/my-extension/main.js - CSS URL — относительный или абсолютный путь до js-скртипта. Например для локально размещенного расширения:
modules/my-extension/main.css
Сохраните запись и обновите страницу в браузере. Если все верно, то в консоле браузера в вкладке Network можно увидеть запросы к вашим файлам.
При старте веб-приложение Бипиум делает запрос к серверу:
/auth/companyОтвет сервера содержит набор подключенных расширений:
{ "domain": "admin", "title": "Моя компания", "extensions": [ массив расширений ]}Сервер не вернет расширения, на которые не получена лицензия для компании.
Last modified 2yr ago