> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/sait/ustanovka-plaginov.md).

# Установка плагинов

Плагины расширяют возможности iEXExchanger: добавляют источники курсов, платёжные инструменты, проверки и интеграции. Плагин можно установить из каталога готовых плагинов, ZIP-архива или по защищённой ссылке.

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

### Разделы управления

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-34c25757e6cda21f1a3e17564e6382b401ad0407%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**«Плагины» — «Готовые плагины»**

Здесь находятся плагины, поставленные вместе с проектом или его обновлением. В этом разделе можно установить или обновить плагин, а также отключить или удалить уже установленную версию.

**«Плагины» — «Установленные плагины»**

Здесь можно установить ZIP-пакет или подключить архив по ссылке, заполнить настройки, добавить данные подключения, включить плагин, проверить его работу, восстановить предыдущую версию или удалить установку.

### Установка готового плагина

{% stepper %}
{% step %}

#### Откройте каталог

Перейдите в раздел **«Плагины» — «Готовые плагины»**.
{% endstep %}

{% step %}

#### Выберите плагин

Найдите нужный плагин и проверьте его версию, автора и готовность к установке.

Метка «Поставщик подтверждён» означает, что поставщик пакета подтверждён системой. Если отображается метка «Поставщик не подтверждён», происхождение пакета не подтверждено.

{% hint style="warning" %}
Перед установкой пакета с меткой «Поставщик не подтверждён» внимательно проверьте автора, запрашиваемые доступы и план установки.
{% endhint %}

Нажмите «Установить».
{% endstep %}

{% step %}

#### Проверьте сведения о плагине

Дождитесь завершения проверки. Если пакет прошёл проверку, появится сообщение «Плагин готов к установке».

Проверьте разделы «Доступы плагина» и «Что будет сделано». В них перечислены действия, которые сможет выполнять плагин, и изменения, запланированные при установке.

Если отображается сообщение «Плагин пока нельзя установить», изучите найденные проблемы. До их устранения установка будет недоступна.
{% endstep %}

{% step %}

#### Подтвердите установку

Нажмите «Установить» в окне проверки.

После завершения появится сообщение «Плагин установлен.».
{% endstep %}

{% step %}

#### Перейдите к установленному плагину

Откройте раздел **«Плагины» — «Установленные плагины»**.

Новый плагин будет иметь статус «Отключен». Перед включением заполните обязательные настройки и данные подключения.
{% endstep %}
{% endstepper %}

### Установка ZIP-архива или архива по ссылке

Откройте раздел **«Плагины» — «Установленные плагины»** и нажмите «Установить».

Выберите способ получения пакета.

{% tabs %}
{% tab title="ZIP-файл" %}
В поле «Источник» выберите «ZIP-файл».

Нажмите «Выбрать ZIP-архив» и выберите файл на устройстве или перетащите архив в область загрузки. Максимальный размер файла — 50 MB.
{% endtab %}

{% tab title="Ссылка на ZIP" %}
В поле «Источник» выберите «Ссылка на ZIP».

Вставьте защищённую HTTPS-ссылку в поле «Ссылка». Если поставщик ограничил доступ к архиву, заполните поле «Код доступа (если требуется)».
{% endtab %}
{% endtabs %}

{% stepper %}
{% step %}

#### Запустите проверку пакета

Нажмите «Проверить пакет» и дождитесь завершения проверки.
{% endstep %}

{% step %}

#### Изучите предпросмотр

В блоке «Предпросмотр пакета» проверьте название, тип, версию и автора плагина.

Изучите разделы «Какие данные и действия будут доступны плагину» и «План установки».

Если отображается результат «Есть проблемы», установка будет недоступна. Исправьте указанные проблемы и повторно нажмите «Проверить пакет».
{% endstep %}

{% step %}

#### Установите пакет

Если отображается результат «Пакет можно установить», нажмите «Установить».

После изменения ZIP-файла, ссылки или кода доступа пакет необходимо проверить повторно.
{% endstep %}

{% step %}

#### Проверьте появление плагина

После сообщения «Плагин установлен.» закройте окно установки и найдите плагин в списке.

Установленный пакет должен иметь статус «Отключен».
{% endstep %}
{% endstepper %}

### Настройка и включение плагина

Набор доступных настроек зависит от плагина. Действия «Настройки» и «Данные подключения» отображаются только тогда, когда они предусмотрены установленным пакетом.

{% stepper %}
{% step %}

#### Заполните настройки

Если для плагина доступно действие «Настройки», откройте его и заполните обязательные поля.

Нажмите «Сохранить настройки». После сохранения появится сообщение «Настройки плагина сохранены.».
{% endstep %}

{% step %}

#### Добавьте данные подключения

Если доступно действие «Данные подключения», откройте его и заполните обязательные поля.

Нажмите «Сохранить данные».

{% hint style="info" %}
При повторном открытии окна пустые поля не изменяют уже сохранённые данные подключения.
{% endhint %}
{% endstep %}

{% step %}

#### Примените обновление данных

Если в строке плагина доступно действие «Применить обновление данных», у текущей версии есть ещё не применённые изменения.

Сопоставьте действие с разделом «План установки», затем нажмите «Применить обновление данных». Дождитесь сообщения «Обновление данных плагина применено.».
{% endstep %}

{% step %}

#### Включите плагин

Используйте переключатель в столбце «Статус».

Перед включением система проверит совместимость пакета, его файлы и заполнение обязательных полей. После успешного включения статус изменится на «Включен».
{% endstep %}

{% step %}

#### Проверьте работу

В строке плагина нажмите действие «Проверить работу».

После завершения появится сообщение «Состояние плагина проверено.». Результат отображается в столбце «Состояние».
{% endstep %}
{% endstepper %}

<table><thead><tr><th width="244.21484375">Результат проверки</th><th>Значение</th></tr></thead><tbody><tr><td>«Не проверялся»</td><td>Проверка работы ещё не выполнялась</td></tr><tr><td>«Работает»</td><td>Проверка завершена успешно</td></tr><tr><td>«Есть предупреждение»</td><td>Проверка завершена с замечанием; изучите сообщение плагина</td></tr><tr><td>«Не работает»</td><td>Проверка завершилась ошибкой; устраните указанную причину до использования плагина</td></tr></tbody></table>

### Плагины источников курсов

Если плагин добавляет источник курсов, загрузка его данных начинается после установки пакета. Ход загрузки отображается в блоке «Загрузка данных плагинов».

| Статус                   | Значение                                           |
| ------------------------ | -------------------------------------------------- |
| «Ожидает загрузки»       | Загрузка создана и ожидает запуска                 |
| «Загружаются данные»     | Пары курсов загружаются                            |
| «Данные загружены»       | Загрузка завершена                                 |
| «Ошибка загрузки»        | Данные не удалось загрузить                        |
| «Заменен новым импортом» | Началась более новая загрузка данных этого плагина |

После появления статуса «Данные загружены» откройте раздел **«Парсер курсов» — «Курсы из источников»**.

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-d371b69a9a8e4ef7b348558c4081082531fa874d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Найдите источник с отметкой «Плагин», откройте его и проверьте загруженные пары. Новые пары добавляются выключенными, поэтому включите только те пары, которые будут использоваться в направлениях обмена.

### Обновление плагина

Если версия готового плагина отличается от установленной, в разделе **«Плагины» — «Готовые плагины»** отображается действие «Обновить».

Для плагина, полученного отдельным ZIP-файлом или по ссылке, откройте окно «Установка плагина» и передайте пакет новой версии тем же способом, который использовался при установке.

Новая версия проходит такой же предпросмотр пакета. После обновления плагин получает статус «Отключен».

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

### Восстановление предыдущей версии

Если для плагина сохранена предыдущая версия, в строке плагина отображаются выбор версии и действие «Откатить».

Выберите нужную версию и нажмите «Откатить». После сообщения «Предыдущая версия плагина восстановлена.» проверьте настройки и данные подключения.

Восстановленная версия остаётся отключённой. Включите её с помощью переключателя и выполните действие «Проверить работу».

{% hint style="danger" %}
Действие «Откатить» восстанавливает предыдущую версию плагина, но не отменяет уже выполненное действие «Применить обновление данных».
{% endhint %}

### Отключение плагина

Чтобы временно остановить плагин, выключите переключатель в столбце «Статус». Плагин останется установленным, а его статус изменится на «Отключен».

Активный готовый плагин также можно отключить действием «Отключить» в разделе **«Плагины» — «Готовые плагины»**.

Для повторного включения используйте переключатель в разделе **«Плагины» — «Установленные плагины»**. Для установленной, но отключённой текущей версии в каталоге готовых плагинов отображается действие «Удалить».

### Удаление плагина

В разделе **«Плагины» — «Установленные плагины»** выберите действие «Удалить» и подтвердите удаление.

Если пакет находится в каталоге готовых плагинов, его архив останется в разделе **«Плагины» — «Готовые плагины»**. Такой плагин можно установить повторно.

Для повторной установки плагина, полученного отдельным ZIP-файлом или по ссылке, снова потребуется исходный архив или доступная ссылка.

{% hint style="danger" %}
Отключение или удаление плагина — источника курсов делает его источник неактивным. Связанные направления получают ошибку «Источник курсов плагина отключён.». Загруженные пары курсов при этом сохраняются.
{% endhint %}

### Проверка результата

После установки и настройки убедитесь, что:

* в разделе **«Плагины» — «Установленные плагины»** отображается нужная версия;
* статус плагина — «Включен»;
* совместимость имеет значение «Совместим»;
* результат действия «Проверить работу» — «Работает»;
* для источника курсов загрузка имеет статус «Данные загружены», а необходимые пары включены в разделе **«Парсер курсов» — «Курсы из источников»**.

Если хотя бы одна из этих проверок не выполнена, плагин ещё не готов к использованию.
