Поиск и добавление интеграций в Medusa Admin
В этом руководстве вы узнаете, как найти интеграцию в каталоге и добавить её в проект.
Каталог показывает интеграции, опубликованные для Модуля интеграций: и уже зарегистрированные в проекте, и те, которые ещё можно добавить. На карточке интеграции видны иконка, название, автор, краткое описание и то, установлена ли интеграция.
Как открыть каталог
Чтобы открыть каталог:
- Перейдите в Настройки → Интеграции.
- Нажмите Найти интеграции.
Вкладки над каталогом фильтруют его по категории, а поиск находит интеграцию по названию, описанию или npm-пакету. У установленной интеграции есть отметка Установлено и кнопка Настройки, которая открывает её страницу, а кнопки Добавить нет. Если зарегистрировано несколько инстансов одного провайдера, у них одна карточка, и Настройки открывает инстанс, зарегистрированный последним.
Добавление интеграции
Каталог сам пакеты не устанавливает. Чтобы добавить интеграцию, нужно установить её пакет и зарегистрировать провайдера в , а каталог показывает инструкцию для обоих шагов.
Чтобы добавить новую интеграцию:
- Перейдите в Настройки → Интеграции.
- Нажмите Найти интеграции.
- Найдите нужную интеграцию.
- Нажмите Добавить.
- Следуйте инструкции по установке в открывшейся боковой панели. Она содержит команду установки, фрагмент регистрации в и шаги настройки, которые нужно выполнить после перезапуска сервера. У каждого блока кода есть своя кнопка копирования, а кнопка Читать документацию открывает полную документацию интеграции, если у записи каталога есть ссылка на документацию.
- Перезапустите сервер.
Инструкция по настройке показывается на русском, если язык Medusa Admin русский, и на английском в остальных случаях. Если у записи нет инструкции на этом языке, в панели показывается инструкция на другом языке.
После этого интеграция появится в списке со статусом Не настроено. Что делать дальше, читайте в разделе Настройка интеграции.
Откуда берётся каталог
Модуль загружает каталог с и хранит его в памяти в течение часа. Если недоступен, модуль показывает последний загруженный каталог, а до первой успешной загрузки копию, которая поставляется с установленной версией . Поэтому страница работает и без доступа в интернет.
Интеграция считается установленной, если в зарегистрирован провайдер с тем же идентификатором.
Хотите добавить вашу интеграцию в каталог? Сделайте Pull Request или напишите в чат поддержки в Telegram.