modrepo.ru для авторов компонентов: API, CI, чат и обновления без очереди

Пока modstore.pro временно недоступен, авторы могут публиковать и обновлять компоненты на modrepo.ru — с тем же сценарием «Установщика», к которому все привыкли. Ниже — кабинет, API, шифрование и поддержка покупателей.

Первая проверка, дальше сразу в каталог

Вручную смотрим только первую публикацию компонента. Когда он уже в каталоге, новые версии из кабинета или через API выходят сразу. Ошибочную версию можно снять самому — она пропадёт из «Установщика», архив останется у вас и его можно скачать из кабинета. Описание, обложку и ссылки меняете без модерации.


Подробности — в правилах модерации. Бесплатный компонент из каталога можно забрать себе, если он ваш.

API и публикация из CI

Токен выпускается в «Моих компонентах» один раз. Через API: список своих пакетов, PATCH описания и ссылок (включая

source_url

), загрузка версии и обложки, картинки для описания, статистика скачиваний. Для платного обновления поле

notify=1

шлёт письмо покупателям с активной лицензией.

<code>curl -H "Authorization: Bearer $MODREPO_TOKEN" \
  -F "file=@_packages/mycomponent-1.2.0-pl.transport.zip" \
  -F "changelog=Исправлена ошибка" \
  -F "notify=1" \
  https://modrepo.ru/api/v1/packages/mycomponent/versions</code>

Готовый workflow для GitHub Actions: github-actions-publish.yml. Секрет —

MODREPO_TOKEN

. Документация: /authors/api.

Шифрование в формате modstore

Платный пакет можно собрать с EncryptedVehicle под ключ modrepo.ru. В author-kit три файла для

_build

, encode-эндпоинт совместим по формату с modstore.pro — меняете URL и токен.


Инструкция: /authors/protection.

Чат с покупателями

Покупатель пишет с страницы компонента — у автора в «Сообщениях» появляется диалог. В чате видна переписка, лицензии на домены и статус «в сети» / «заходил». Можно прикрепить файл (скрин, лог, zip) и закрыть вопрос кнопкой «Вопрос решён».


В «Сообщениях» — список диалогов по компонентам, письма о новых сообщениях и HTTPS-webhook для Telegram-бота или CRM. Отвечать можно и через API.


Доки: /authors/support. Рядом на странице компонента — открытое обсуждение.

Ветки MODX 2 и 3, статистика

При загрузке версии указываете диапазон MODX — «Установщик» отдаёт сайту подходящую ветку. На странице компонента видны даты публикации и обновления, список версий; в кабинете — скачивания всего, по дням и по версиям.

Кабинет и продажи

В «Моих компонентах» сверху сводка: непрочитанные чаты, обсуждения без ответа автора, для продавца — доля за 7 дней и доступный баланс. У каждой версии — «Скачать» и «Снять». Платные: промокоды, продажа через агентский договор, письмо покупателям о релизе (чекбокс при загрузке).


В разделе «Продажа компонентов» — баланс (холд / доступно / выплаты), таблица продаж и графики доли и выплат: по дням за 30 дней и по месяцам за год — в привычном для авторов modstore виде.


С чего начать: раздел «Авторам». Вопросы — в комментарии.