Маркетплейс
Установка модулей и тем и проверка подписанных пакетов.
Что это
Каталог модулей и тем для SceneCMS, открывается из Админка → Маркетплейс. У каждого продукта есть версия, диапазон совместимости и подписанный пакет за ним.
Сейчас публикуются только продукты вендора. Схема уже поддерживает сторонних авторов, поэтому каталог может расти без миграции.
Установка
- Откройте Админка → Маркетплейс. Каталог запрашивается с вашим ключом и доменом, поэтому знает, что вам принадлежит.
- Нажмите Установить у бесплатного продукта или Обновить, когда предложена новая версия.
- Пакет скачивается, проверяются его подпись и контрольные суммы каждого файла, файлы кладутся в нужный каталог.
Ничего не включается за вашей спиной: после установки модуль выключен, а тема не активна, пока вы не нажмёте Enable или Activate.
Что проверяется
Пакет маркетплейса — это zip с:
marketplace-manifest.json slug, версия, файлы с SHA-256
marketplace-manifest.sig отдельная подпись Ed25519
files/<path> содержимое
До записи хотя бы одного файла установщик проверяет подпись публичным ключом из продукта, затем контрольную сумму каждого файла, затем совпадение slug и версии из манифеста с module.json или theme.json внутри. Пакет с одним изменённым байтом отбраковывается.
Path traversal тоже запрещён: подделанный zip не запишет ничего за пределами целевого каталога.
Откат
Предыдущая сборка модуля или темы переносится в storage/app/marketplace/rollback до того, как на её место встанет новая. Если копирование падает, старая сборка возвращается.
Правила лицензирования
- Бесплатные продукты: любая установка с действующей лицензией.
- Платные продукты: выданный заказ в личном кабинете.
- Установка новых продуктов требует действующей лицензии. Всё уже установленное работает бессрочно, в том числе после окончания года поддержки.
- Обновления установленного подчиняются тому же правилу, что и новые установки.
Это сделано намеренно: истёкшая лицензия не должна ломать работающий сайт, она лишь приостанавливает магазин.
Свои продукты
Модуль — это каталог с module.json, сервис-провайдером и, при необходимости, роутами, вьюхами и миграциями. Тема — каталог с theme.json и переопределениями Blade. И то, и другое описано в документации, которая едет в архиве продукта.
Если позже захотите публиковаться на маркетплейсе, схема вендоров и очередь ревью в кабинете уже есть — напишите нам, и мы откроем аккаунт.
Не нашли ответ?
Напишите на sales@scenecms.ru — отвечаем в течение рабочего дня.