---
url: https://docs.ogmabox.com/ru/app/plugins.md
description: >-
  Устанавливайте, управляйте, обновляйте и разрабатывайте плагины Ogma из
  локальных пакетов, папок, ZIP-архивов и каталога.
---

# Плагины {#plugins}

Плагины расширяют Ogma собственными страницами интерфейса, серверной обработкой, обработчиками событий и панелями настроек в пределах заявленных разрешений.

## Что могут добавить плагины {#what-plugins-can-add}

* Собственные страницы интерфейса в левой навигации.
* Серверные маршруты обработки запросов или ответов.
* Обработчики событий перехвата трафика.
* Страницы настроек плагина.
* Команды, регистрируемые в палитре команд.

## Установка из папки {#install-from-folder}

1. Нажмите **Установить** в разделе плагинов.
2. Выберите **Папка**.
3. Выберите корневой каталог плагина. Он должен содержать корректный манифест и объявленные в нём файлы.
4. Ogma проверит пакет и зарегистрирует его.
5. Включите плагин для активации.

## Установка из ZIP-архива {#install-from-zip-archive}

1. Нажмите **Установить** в разделе плагинов.
2. Выберите **Zip**.
3. Выберите файл `.zip` плагина.
4. Проверьте обнаруженные имя и версию.
5. Нажмите **Установить**, затем включите плагин.

При установке ZIP содержимое копируется в управляемый каталог плагинов Ogma. Исходный архив после установки можно удалить.

## Предупреждения о совместимости {#compatibility-warnings}

После установки на странице плагина могут появиться предупреждения. Они информационные и не препятствуют работе.

Типичные предупреждения:

* **Файлы без ссылок в манифесте** — файлы пакета, не объявленные в манифесте.
* **Отсутствующий адаптер среды выполнения** — плагин использует API, которому нужен адаптер совместимости, отсутствующий в этой версии Ogma.

Проверяйте предупреждения перед включением незнакомого плагина.

## Включение и отключение {#enable-and-disable}

Переключайте **Включено** в строке плагина для активации и деактивации. Отключённые плагины остаются установленными, но не выполняются. Повторное включение восстанавливает работу без переустановки.

## Вкладки сведений о плагине {#plugin-detail-tabs}

Выберите плагин, чтобы открыть панель сведений со следующими вкладками.

| Вкладка | Содержимое |
|-----|----------|
| Обзор | Имя, версия, автор, описание и источник. |
| Предупреждения | Проблемы совместимости, обнаруженные при установке или включении. |
| Разрешения | Запрошенные плагином и выданные Ogma разрешения во время выполнения. |
| Файлы | Список файлов пакета. |
| Журналы | Вывод плагина с подсветкой синтаксиса структурированных строк. |
| Интерфейс | Собственная страница плагина, отображаемая внутри панели. |

## Разрешения {#permissions}

Вкладка разрешений перечисляет все разрешения манифеста и текущий статус выдачи. Серверные вызовы контролируются на сервере. Интерфейс отражает актуальное состояние каждого разрешения.

Если плагин работает не так, как ожидается, проверьте выдачу нужных разрешений.

## Режим разработки {#dev-mode}

Плагины из папки показывают метку **Разработка** и кнопку **Обновить**.

Нажмите **Обновить**, чтобы применить изменения кода без переустановки. Плагин перезапускается и заново регистрирует все обработчики и маршруты. Это обычный цикл работы разработчика плагина.

Плагины в режиме разработки остаются связанными с исходной папкой. Изменения её файлов вступают в силу при следующей перезагрузке.

## Каталог {#marketplace}

Вкладка **Каталог плагинов** показывает плагины сообщества из реестра Awesome Ogma Plugins.

1. Просмотрите список или выполните поиск.
2. Нажмите плагин, чтобы увидеть описание, версию и сведения о совместимости.
3. Нажмите **Установить** для прямой установки.
4. Если для установленного плагина каталога доступна новая совместимая версия, действие меняется на **Обновить**.

Для установки из каталога нужно сетевое соединение для получения пакета.

## Связанные страницы {#related-pages}

* [Первый плагин](/ru/plugins/quickstart)
* [Backend SDK](/ru/plugins/backend-sdk)
* [Frontend SDK](/ru/plugins/frontend-sdk)