Перейти к содержимому
SceneCMS

Маркетплейс

Установка модулей и тем и проверка подписанных пакетов.

Что это

Каталог модулей и тем для SceneCMS, открывается из Админка → Маркетплейс. У каждого продукта есть версия, диапазон совместимости и подписанный пакет за ним.

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

Установка

  1. Откройте Админка → Маркетплейс. Каталог запрашивается с вашим ключом и доменом, поэтому знает, что вам принадлежит.
  2. Нажмите Установить у бесплатного продукта или Обновить, когда предложена новая версия.
  3. Пакет скачивается, проверяются его подпись и контрольные суммы каждого файла, файлы кладутся в нужный каталог.

Ничего не включается за вашей спиной: после установки модуль выключен, а тема не активна, пока вы не нажмёте 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 — отвечаем в течение рабочего дня.

Контакты