Установка плагинов
Раздел «Установка плагинов» позволяет подключать дополнительные модули к iEXExchanger через панель управления.
Сейчас основной рабочий сценарий раздела — установка плагинов курсов. Такой плагин добавляет новый внешний источник курсов и после установки может автоматически загрузить пары курсов в систему.
После установки источник появляется в штатном разделе «Курсы из источников» и дальше используется как обычный источник курса.
Где находится раздел
В панели управления откройте: «Утилиты» — «Установка плагинов»
Если раздел не отображается, у пользователя нет права на установку внешних модулей.
Права доступа
Для работы с разделом у группы пользователя должно быть включено право:
Чтобы выдать доступ:
Откройте «Пользователи» — «Группы пользователей».
Выберите нужную группу.
Откройте блок «Базовое управление».
Включите право «Разрешить установку внешних модулей».
Сохраните изменения.
После этого пользователи выбранной группы смогут открывать раздел «Установка плагинов» и управлять внешними модулями.
Для чего нужен раздел
Через этот раздел можно:
загрузить ZIP-архив плагина из админки;
установить плагин по ссылке на ZIP-архив;
проверить пакет перед установкой;
подключить плагин как источник курсов;
загрузить пары курсов из плагина;
включить или отключить установленный плагин;
проверить состояние плагина;
заполнить секреты и настройки плагина;
запустить миграции, если они есть;
откатиться на предыдущий релиз плагина;
удалить плагин.
Что можно устанавливать
На текущем этапе через админку используется установка плагинов типа:
Такой плагин добавляет в систему внешний источник курсов.
После установки источник отображается в разделе: «Парсер курсов» — «Курсы из источников»
Если плагин содержит список пар или умеет получить их из внешнего источника, система может загрузить эти пары автоматически.
Типы вроде «Мерчант», «Выплаты», «KYC», «AML» и «Внешний модуль» предусмотрены архитектурой, но если они отключены в вашей версии, в списке выбора они не отображаются.
Перед установкой
Перед установкой убедитесь, что у вас есть:
корректный ZIP-архив плагина;
или прямая ссылка на ZIP-архив;
доступ к разделу установки плагинов;
понимание, откуда получен плагин.
Архив должен быть именно в формате: .zip
Максимальный размер ZIP-архива через админку: 50 MB
Не загружайте плагины из неизвестных источников. Плагин может обращаться к внешним сервисам, использовать API-ключи и влиять на работу курсов.
Способы установки
Доступно два способа установки.
ZIP из админки
Если архив плагина находится на вашем компьютере
Ссылка на ZIP
Если архив размещён по ссылке
ZIP из админки
Откройте «Утилиты» — «Установка плагинов».
Нажмите «Установить».
В поле «Тип» выберите «Курсы».
В поле «Источник» выберите «ZIP из админки».
В блоке «Архив» выберите ZIP-файл или перетащите его в область загрузки.
Проверьте поле «Папка».
В поле «Версия» оставьте
latestили укажите нужную версию.В поле «Пары курсов» выберите подходящий режим.
Нажмите «Проверить пакет».
Если система показала «Пакет можно установить», нажмите «Установить».
После установки плагин появится в таблице установленных плагинов.
Если это плагин курсов, система создаст для него источник в разделе «Курсы из источников».
Ссылка на ZIP
Откройте «Утилиты» — «Установка плагинов».
Нажмите «Установить».
В поле «Тип» выберите «Курсы».
В поле «Источник» выберите «Ссылка на ZIP».
В поле «Ссылка» укажите прямую ссылку на ZIP-архив.
Если архив закрытый, укажите «Токен».
Заполните «Папка» и «Версия», если требуется.
Выберите режим «Пары курсов».
Нажмите «Проверить пакет».
После успешной проверки нажмите «Установить».
Пример ссылки:
Токен используется только для скачивания приватного архива. Он не является настройкой плагина и не используется как API-ключ самого модуля.
Поля при установке
Пары курсов
Поле отображается для плагинов типа «Курсы».
По настройке плагина
Система использует режим, который задан внутри плагина
Проверить и загрузить пары
Плагин получает пары из источника и загружает их в систему
Не загружать при установке
Источник создаётся без первичной загрузки пар
Для большинства курсовых плагинов рекомендуется выбирать:
Этот режим удобен, если внешний источник доступен и должен сразу создать список пар.
Если плагин требует API-ключи, иногда лучше выбрать:
После установки можно заполнить секреты, настройки и выполнить проверку состояния.
Предпросмотр пакета
Перед установкой система обязательно проверяет пакет.
Это безопасный этап: плагин ещё не устанавливается в систему.
В блоке «Предпросмотр пакета» отображается:
название плагина;
тип плагина;
версия;
среда запуска — PHP или JS;
стандарт совместимости;
основной файл;
количество пар курсов;
количество файлов в архиве;
план установки;
ошибки и предупреждения, если они найдены.
Если отображается:
установка разрешена.
Если отображается, что есть проблемы, откройте список ошибок и исправьте причину.
Частые причины:
неверный архив;
отсутствует файл описания плагина;
неподдерживаемый стандарт;
отсутствует основной файл;
несовместимая версия системы;
ошибка загрузки пар.
Что происходит после установки
После установки система:
проверяет архив;
распаковывает файлы плагина в безопасное хранилище;
создаёт запись плагина в реестре;
создаёт активный релиз;
регистрирует функции плагина;
создаёт источник курсов, если это плагин курсов;
сохраняет настройки, секреты и миграции, если они описаны в плагине;
запускает импорт пар курсов, если выбран соответствующий режим.
Файлы плагинов хранятся в системном хранилище, а не в публичной папке сайта.
Это нужно, чтобы плагины не терялись при обновлении основного кода проекта.
Загрузка данных плагина
Если плагин курсов загружает большой список пар, после установки может появиться блок «Загрузка данных плагинов».
В нём отображается:
статус загрузки;
процент выполнения;
сколько записей загружено;
сколько создано;
сколько обновлено;
сколько пропущено.
Возможные статусы:
Ожидает загрузки
Задача создана и ждёт запуска
Загружаются данные
Импорт выполняется
Данные загружены
Импорт завершён
Ошибка загрузки
Импорт не смог завершиться
Заменен новым импортом
Запущен новый импорт, старый больше не актуален
Если импорт ещё выполняется, не устанавливайте тот же плагин повторно.
Дождитесь завершения или проверьте ошибку, если она появилась.
Таблица установленных плагинов
После установки плагин появляется в таблице «Установленные плагины».
В таблице отображается:
Название
Название плагина
Тип и группа
Тип плагина и связанная группа
Источник установки
ZIP или ссылка
Статус
Текущее состояние плагина
Совместимость
Результат проверки совместимости
Health-check
Последний результат проверки состояния
Хранение
Где находятся файлы плагина
Дата установки
Когда плагин был установлен
Кто загрузил
Пользователь, который установил плагин
Активный релиз
Текущая версия плагина
Действия
Доступные операции
Статусы плагина
Действия с установленным плагином
Включить или отключить
Переключатель статуса позволяет включить или отключить плагин.
Если отключить плагин курсов, связанный источник курсов станет неактивным и перестанет использоваться как активный источник.
Отключение удобно использовать, если внешний сервис временно недоступен или источник больше не должен участвовать в расчётах.
Проверить состояние
Кнопка проверки состояния запускает health-check плагина.
Для плагинов курсов система проверяет, может ли плагин обратиться к источнику и получить данные.
После проверки отображается один из статусов:
Health-check полезен, если:
источник перестал обновлять курсы;
пары не загружаются;
нужно проверить API-ключи;
нужно проверить доступность внешнего сервиса;
нужно убедиться, что плагин работает после обновления.
Секреты
Кнопка «Секреты» появляется, если плагину нужны скрытые данные.
Например:
API-ключ;
токен;
пароль;
секретный ключ.
Заполненные секреты хранятся отдельно от файлов плагина.
Если поле уже заполнено, система показывает, что секрет сохранён. При повторном открытии значение не раскрывается.
Если оставить поле пустым и сохранить форму, ранее сохранённый секрет не изменится.
Настройки
Кнопка «Настройки» появляется, если плагин поддерживает пользовательские параметры.
Это могут быть:
URL;
режим работы;
таймаут;
числовые значения;
переключатели;
списки;
JSON-параметры.
Эти значения не считаются секретами.
Не указывайте в обычных настройках пароли, токены и приватные ключи, если для этого есть отдельный раздел «Секреты».
Запустить миграции
Если плагин поставляется со своими миграциями, в действиях появляется кнопка запуска миграций.
Миграции не запускаются автоматически без явного действия администратора.
Запускайте их только если понимаете, что плагину нужны дополнительные таблицы или поля для работы.
Миграции меняют структуру базы данных. Запускайте их только для доверенных плагинов.
Откатить релиз
Если у плагина есть несколько установленных релизов, можно выбрать предыдущий релиз и выполнить откат.
Это полезно, если после обновления плагина появились ошибки, а предыдущая версия работала стабильно.
При откате система:
проверяет файлы выбранного релиза;
проверяет совместимость;
делает выбранный релиз активным;
обновляет данные плагина;
сохраняет связь с источником курсов.
Удалить
Удаление отключает плагин и убирает его из активного списка.
Для плагинов курсов система действует осторожно: она не удаляет используемые пары курсов, если они связаны с направлениями обмена.
Это защищает направления от поломки после удаления плагина.
Где смотреть источник после установки
Если установлен плагин типа «Курсы», откройте: «Парсер курсов» — «Курсы из источников»
Там появится новый источник.
У источников, созданных плагином, может отображаться пометка:
Внутри источника можно проверить:
список загруженных пар;
активность источника;
количество курсов;
связанные данные;
корректность обновления курсов.
Рекомендуемый порядок после установки
После установки плагина рекомендуется выполнить проверку по порядку:
Дождитесь завершения загрузки данных, если она запущена.
Заполните «Секреты», если плагин их требует.
Заполните «Настройки», если они есть.
Нажмите «Проверить состояние».
Откройте «Парсер курсов» — «Курсы из источников».
Проверьте, что источник появился и включён.
Проверьте список пар курсов.
Включите нужные пары.
Подключите нужную пару к направлению обмена.
Проверьте обновление курса на тестовом направлении.
Частые проблемы
Раздел «Установка плагинов» не отображается
У пользователя нет права на установку внешних модулей.
Проверьте группу пользователя:
«Пользователи» — «Группы пользователей» — нужная группа — «Базовое управление»
Включите право:
ZIP-архив не загружается
Проверьте:
файл имеет расширение
.zip;размер файла не превышает
50 MB;архив не повреждён.
Пакет не проходит проверку
Откройте блок «Предпросмотр пакета» и посмотрите список ошибок.
Частые причины:
архив повреждён;
отсутствует файл описания плагина;
неверный тип плагина;
неподдерживаемый стандарт;
несовместимая версия системы;
отсутствует основной файл.
Плагин установился, но источник курсов не появился
Проверьте:
выбран ли тип «Курсы»;
поддерживает ли плагин функцию источника курсов;
включён ли сам плагин;
обновлена ли страница «Курсы из источников».
Пары курсов не загрузились
Проверьте режим «Пары курсов» при установке.
Если был выбран вариант:
пары не будут загружены автоматически.
Также проверьте блок «Загрузка данных плагинов» и ошибку импорта, если она появилась.
Health-check показывает ошибку
Обычно это означает, что плагин не смог обратиться к внешнему источнику или ему не хватает данных для работы.
Проверьте:
заполнены ли секреты;
заполнены ли настройки;
доступен ли внешний API;
не изменился ли формат ответа внешнего сервиса;
нет ли сетевых ограничений на сервере.
После исправления повторите проверку состояния.
После отключения плагина перестали обновляться курсы
Это нормальное поведение.
Отключённый плагин не используется системой. Включите его обратно или выберите другой источник курсов для направлений.
Важное предупреждение
Устанавливайте только проверенные плагины.
Плагин может:
обращаться к внешним сервисам;
получать данные;
использовать API-ключи;
влиять на работу курсов;
запускать миграции, если они предусмотрены.
Перед установкой на рабочем проекте желательно проверить плагин на тестовом окружении.
Коротко
Раздел «Установка плагинов» используется для подключения внешних модулей через админку.
Сейчас основной рабочий сценарий — установка плагинов курсов.
Для доступа нужно право «Разрешить установку внешних модулей».
Плагин можно установить из ZIP-архива или по ссылке.
Перед установкой система обязательно проверяет пакет.
После установки плагин курсов появляется в разделе «Парсер курсов» — «Курсы из источников».
Последнее обновление
Это было полезно?