gtsStore

gtsStore превращает сайт на MODX 3 в магазин дополнений: покупатели находят пакеты, покупают их и устанавливают прямо из админки своего сайта через поставщика пакетов.

Что умеет

• Обычные и зашифрованные пакеты. Публикуйте готовый .transport.zip как есть или поставьте галочку «Зашифровать». Менять сборку пакета не нужно.
• Привязка к сайту. Покупатель получает ключ, а домен определяется сам при первой установке. Купленный пакет скачивается на этом домене без ограничений, другим доменам магазин отказывает.
• Продажа через MiniShop3. Покупка создаёт обычный заказ. Статус «Оплачен» выдаёт лицензию, «Отменён» снимает её.
• Личный кабинет. Регистрация, вход, восстановление пароля, ключи сайтов, список покупок.
• Витрина. Плашки с логотипами и ценами на главной и страница пакета с описанием в Markdown.
• Публикация через API. Токен и готовая инструкция позволяют ИИ-агенту публиковать пакеты и заполнять их страницы удалённо.
• Управление в админке MODX. Публикация версий, описание с предпросмотром, файлы и логотип, авторы, лицензии, ключи и журнал запросов.

Как работает шифрование

При публикации магазин шифрует всё содержимое пакета, включая файлы и резолверы, алгоритмом AES-256-GCM. В пакете остаётся только загрузчик. При установке он запрашивает ключ у магазина, а магазин проверяет логин, ключ сайта, домен и лицензию. После установки расшифрованные файлы удаляются из папки пакета.

После установки код дополнения находится на сайте покупателя в открытом виде. Шифрование защищает пакет при передаче и установке, но не код на уже установленном сайте.

Работа через API

Магазин можно наполнять удалённо, в том числе с помощью ИИ-агента:

• публиковать новые пакеты и версии, обычные и зашифрованные;
• заполнять страницу пакета: название, описание, цену и авторов;
• загружать логотип и файлы для описания.

Токен и готовая инструкция находятся в админке: Компоненты → Магазин пакетов → вкладка «API и ИИ». Там токен можно сгенерировать, скопировать и отозвать, а инструкцию скопировать и передать ИИ-агенту. Адрес вашего магазина в ней подставляется сам.

Токен даёт все права администратора, который его создал. Выдавайте его на короткий срок и отзывайте после работы.

Требования

Ставить их заранее не нужно. Подключите поставщика этого магазина и установите gtsStore: недостающие пакеты скачаются и установятся сами. pdoTools, VueTools и MiniShop3 берутся с modx.com, поэтому поставщик modx.com должен быть подключён (в MODX он есть по умолчанию) и доступен, gtsAPI и PHPExcel берутся из этого магазина. Если поставить их не удалось, установка прерывается, а причина записывается в журнал ошибок сайта.

Быстрый старт

1. Установите пакет. Он создаст главную, каталог и страницу личного кабинета.
2. Откройте «Компоненты → Магазин пакетов» и опубликуйте первый пакет.
3. Заполните описание, загрузите логотип и укажите авторов.
4. Настройте системную настройку site_start, чтобы главной страницей сайта стал ресурс магазина.

Как покупатель устанавливает пакет

1. Регистрируется в личном кабинете и получает ключ сайта.
2. Покупает пакет на его странице.
3. В MODX открывает «Установщик → Поставщики» и добавляет поставщика с адресом магазина, логином и ключом.
4. Загружает и устанавливает пакет как обычно.

Оплата

По умолчанию используется способ «Подтверждение вручную»: администратор переводит заказ в статус «Оплачен». Онлайн-оплату можно подключить через платёжные модули MiniShop3.

Перед запуском магазина

Заполните реквизиты организации в системных настройках gtsstore_org_*: они выводятся в оферте, политике конфиденциальности и футере. Тексты документов это шаблоны: покажите их юристу и поправьте страницы в менеджере, обновление пакета их не затрёт. Для регистрации нужна рабочая отправка почты: без подтверждения адреса войти нельзя.

• Включите HTTPS: MODX передаёт ключ сайта в адресе запроса.