Где взять компоненты MODX, пока не работает modstore.pro

modstore.pro не работает со 2 ноября. Илья Уткин рассказал, что случилось и чего ждать, в заметке «modstore.pro недоступен: что случилось и что дальше». Уже установленные дополнения работают. Скачать, установить или обновить пакет через поставщика modstore.pro не получится, пока Beget не вернёт базу магазина.
Прошла неделя. Мне и другим авторам пишут в личку: кому-то нужно поставить компонент на новый сайт, кому-то обновить старый, а взять пакет негде. Я запустил отдельный репозиторий пакетов modxtips.ru. Он подключается в «Установщик» как обычный поставщик и отдаёт пакеты прямо в админку MODX.

Что там есть

• 57 бесплатных компонентов: pdoTools, miniShop2 и MiniShop3, Tickets, Ace, SendIt, ZoomX, FileMan, modHelpers, ImageOptimizer и другие.
• Поставщик сам выбирает версию под ваш MODX: сайт на MODX 2 получит pdoTools 2.x, сайт на MODX 3 получит pdoTools 3.x.
• Каталог с поиском и фильтрами по назначению, версии MODX и автору.

Список бесплатных компонентов modstore я восстановил по веб-архиву. Сами пакеты взял из открытых источников: релизы авторов на GitHub и официальный репозиторий modx.com. В репозиторий попали только компоненты с открытой лицензией и публичной сборкой. Архивы хранятся на сервере modxtips.ru, поэтому скачивание не зависит от GitHub.

Поддержку по компонентам ведут их авторы, ссылка на страницу автора есть в карточке каждого пакета. Если один из компонентов ваш, его можно забрать себе и вести самостоятельно: подробности ниже, в разделе «Авторам».

Как подключить

1. Зарегистрируйтесь на modxtips.ru и подтвердите почту. API-ключ появится в кабинете.
2. В админке MODX откройте «Пакеты» → «Установщик» → «Поставщики» и добавьте нового поставщика: название

   modxtips.ru

   , URL службы

   https://modxtips.ru/extras/

   , имя пользователя: email аккаунта, API-ключ: из кабинета.
3. В «Установщике» нажмите «Загрузить пакеты», выберите поставщика modxtips.ru, найдите компонент и установите его.

Поставщика modstore.pro не удаляйте и его ключи не пересоздавайте, как советует Илья. Новый поставщик встаёт рядом со старым, и после возвращения modstore оба останутся в списке.

Что нового для пользователей

С момента публикации заметки на сайте появилось:

• Раздел «Пользователям»: как подключить поставщика, установить и обновить компонент, выбрать ветку под MODX 2 или MODX 3, что значат ошибки «Установщика» и как их исправить, какие лицензии у компонентов и как перейти с modstore.pro.
• Счётчики на странице компонента, как на modstore: сколько раз его скачали, сколько лицензий купили, когда опубликовали и когда обновили. Счёт идёт с запуска modxtips.ru, история modstore сюда не попала.
• Сортировка каталога «Сначала популярные» по числу скачиваний.
• Обложки у всех компонентов в каталоге.

Авторам

Главное нововведение — раздел «Авторам». Бесплатные компоненты с modstore я перенёс сам, чтобы пользователи не остались без обновлений. Вести их должны авторы, поэтому теперь любой компонент из каталога можно забрать себе.



Как забрать компонент. Зарегистрируйтесь на modxtips.ru и напишите на info@modxtips.ru с email аккаунта и списком компонентов. Авторство подтвердите любым удобным способом: письмом с почты из пакета, коммитом или issue в репозитории компонента, сообщением из профиля на modx.pro. Я назначу вас владельцем, и компоненты появятся в кабинете в разделе «Мои компоненты» со всеми версиями и счётчиками скачиваний. После передачи я в компоненте ничего не меняю: описание и версии полностью ваши.

Что можно делать в кабинете:

• менять название, описание, разделы каталога, ссылки на поддержку и документацию;
• загрузить свою обложку вместо моей;
• выпускать новые версии. Если у компонента разные ветки для MODX 2 и MODX 3, укажите при загрузке диапазон версий MODX, и «Установщик» отдаст каждому сайту подходящую;
• смотреть статистику: скачивания всего, по версиям и по дням за последние 30 дней, у платных компонентов ещё и число активных лицензий.

Модерация. Новые версии проверяю вручную: пакет ставится на заявленные версии MODX, не ломает админку, в коде нет вредоносных вставок и обращений к сторонним серверам без ведома пользователя. Результат приходит на почту. Описание, ссылки, разделы и обложка меняются без модерации, сразу.

Доверенные авторы. Авторам известных компонентов, перешедшим с modstore, и тем, у кого уже приняли несколько версий без замечаний, даю статус доверенного автора. Их версии публикуются сразу после загрузки. Первую публикацию платного компонента и смену цены проверяю всегда, даже у доверенных.

API. Авторы просили API, чтобы выпускать версии прямо из скрипта сборки или CI. Оно готово. Токен выпускается в кабинете, в «Моих компонентах», и показывается один раз. Через API можно получить список своих компонентов, поменять описание и ссылки, загрузить версию или обложку, забрать статистику. Загрузка версии выглядит так:

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

В документации описаны все методы и коды ошибок, там же готовый workflow для GitHub Actions: публикуете релиз на GitHub, и версия сама уходит на modxtips.ru.

Новые компоненты. Бесплатный компонент может выложить любой разработчик через кабинет. Платные продают авторы со статусом ИП или самозанятого. Магазин работает агентом автора: принимает оплату через ЮKassa, выдаёт покупателю чек и лицензию на домен. Шифровать пакет не нужно, лицензию modxtips.ru проверяет сам при скачивании. Условия описаны на странице «Продажа компонентов».

Если не хотите быть в каталоге. Напишите мне, и я сниму компонент с публикации. Учтите, что тогда пользователи, которые ставили его с modstore.pro, останутся без обновлений.

Что с покупками на modstore

Ключи и лицензии modstore.pro на modxtips.ru не действуют: доступа к базе магазина у меня нет. Платных компонентов других авторов без их согласия на сайте нет. Если платный компонент нужен срочно, пишите его автору.

Что дальше

В комментариях к заметке Ильи я назвал репозиторий временным. Я решил его развивать и после того, как modstore заработает. Как два магазина будут жить рядом, обсудим с Ильёй. Он уже ответил, что эксклюзивного права на продажу дополнений у modstore нет и претензий быть не может.
Позже репозиторий переедет на адрес modrepo.ru. Старый адрес будет перенаправлять на новый, а о переезде я предупрежу заранее.
Вопросы и пожелания оставляйте в комментариях.