> 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 %}

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

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

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/guide/sait/ustanovka-plaginov.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.