Темы оформления публичной карты

Система ORBISMap позволяет модифицировать или создавать темы оформления публичной карты. Для изменения предустановленной темы, её необходимо скачать через менеджер тем.

Архив с темой оформления имеет в своём составе:

Специализированные поля package.json

Примечание: При назначении идентификатора темы можно использовать латинские буквы, цифры, а также символы "-" и "_"

Структура файла widgets.json

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

Для создания виджетов необходимо использовать следующие параметры:

Примечание: Поддерживаются следующие типы полей ввода: input[type=checkbox], input[type=text], textarea
{
     "widgets": [
         {
             "code": "toolsWidget",
             "name": "Виджет: Панель инструментов",
             "enabled": true,
             "fields": [
                 {
                     "name": "measurements",
                     "label": "Измерение расстояний",
                     "type": "checkbox",
                     "checked": true
                 },
                 {
                     "name": "searchLimit",
                     "label": "Количество результатов",
                     "value": "5",
                     "type": "text"
                 },
                 {
                     "name": "description",
                     "label": "Описание",
                     "value": "",
                     "type": "textarea"
                 }
             ]
         },
         {
            ...
         }
     ]
 }

Разработка и модификация темы

Модификация функционала тем оформления производится с использованием возможностей ORBISMap JS API

Примечание: Модифицированные темы могут быть настроены под конкретные карты. Логика работы изменённых тем обеспечивается компетенциями разработчика темы.
Внимание: При изменении функционала темы оформления, настройки некоторых виджетов конструктора публикаций могут стать недоступны.

Для разработки требуется Node.js v6+ и пакетный менеджер npm или yarn. Установка всех необходимых зависимостей выполняется командой $ npm install в папке с темой.

Сборка модифицированой темы выполняется командами:

Для удобства разработки сконфинурирован dev-сервер, запуск которого выполняется командой

$ npm run start_devServer

Dev-сервер следит за всеми изменениями в файлах исходного кода темы и выполняет автоматическую пересборку. Для просмотра результата работы dev-сервера можно перейти по ссылке

Установка модифицированной темы

Для установки модифицированной темы папку с ней необходимо упаковать в zip архив, и загрузить его через менеджер тем ORBISMap в настройках публикации.

Примечание: Рекомендуется удалить папку `node_modules` для уменшения размера архива.