Модули и пакеты для Portal

Для разработчиков и интеграторов

Portal поддерживает функциональные модули — ZIP-архивы .portalmod, в которых вы описываете всё необходимое для развёртывания решения у заказчика одним действием. Не нужно отдельно создавать узлы, списки и библиотеки в админке и по очереди загружать расширения: платформа прочитает module.json и развернёт инфраструктуру автоматически.

В каталоге ниже — готовые демо-модули с исходниками. Их можно установить как есть или использовать как шаблон для своих решений.

Что входит в один пакет

Структура архива

my-solution.portalmod (ZIP)
├── module.json          # манифест: узлы, списки, зависимости
├── packages/
│   ├── widget.portalpart
│   ├── on-change.portalevent
│   └── nightly.portaltimer
├── seed/                # опционально: начальные данные
└── provisioner/         # опционально: C# для сложной логики

Установка у заказчика

1. Соберите .portalmod локально или скачайте готовый из каталога.
2. На портале заказчика откройте Админка → Модули (или вызовите POST /api/v1/modules/install).
3. Загрузите один файл — платформа создаст узлы, списки, библиотеки, страницы, зарегистрирует расширения и при необходимости выполнит provisioner.
4. Повторная установка той же версии пропускается; новая версия обновляет модуль с миграцией данных.

Зависимости между модулями задаются в requires — например, модуль «Дни рождения» требует предварительно установленную «Адресную книгу».