---
url: https://docs.ogmabox.com/uk/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}

Після встановлення Ogma може показувати попередження на сторінці подробиць плагіна. Вони інформаційні й не перешкоджають запуску.

Типові попередження:

* **Файли без посилань у маніфесті** — файли пакета, не заявлені в маніфесті.
* **Відсутній адаптер середовища виконання** — плагін використовує API, що потребує адаптера сумісності, відсутнього в цій версії Ogma.

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

## Увімкнення й вимкнення {#enable-and-disable}

Перемикайте **Увімкнено** в рядку плагіна для активації або деактивації. Вимкнені плагіни залишаються встановленими, але не виконуються. Повторне ввімкнення відновлює плагін без перевстановлення.

## Вкладки подробиць плагіна {#plugin-detail-tabs}

Виберіть плагін, щоб відкрити панель подробиць. Панель має такі вкладки.

| Вкладка | Вміст |
|-----|----------|
| Огляд | Назва, версія, автор, опис і джерело плагіна. |
| Попередження | Проблеми сумісності, виявлені під час установлення або ввімкнення. |
| Дозволи | Що плагін запросив і що Ogma надав під час виконання. |
| Файли | Список файлів пакета плагіна. |
| Журнали | Вивід плагіна під час виконання з підсвічуванням синтаксису структурованих рядків журналу. |
| UI | Власна сторінка плагіна, відображена в інтерфейсі. |

## Дозволи {#permissions}

Вкладка дозволів перелічує кожен дозвіл, заявлений плагіном у маніфесті, й поточний стан надання. Серверні виклики перевіряються на сервері. Інтерфейс відображає актуальний стан кожного дозволу.

Якщо плагін працює не так, як очікується, перевірте на вкладці дозволів, чи надано потрібні дозволи.

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

Плагіни, встановлені з папки, показують позначку **Розробка** і кнопку **Перезавантажити**.

Натисніть **Перезавантажити**, щоб застосувати зміни коду без перевстановлення. Плагін перезапускається й повторно реєструє всі обробники та маршрути. Це стандартний цикл роботи авторів плагінів.

Плагіни в режимі розробки залишаються пов’язаними з вихідною папкою. Зміни її файлів набувають чинності після наступного перезавантаження.

## Каталог плагінів {#marketplace}

Вкладка **Каталог плагінів** перелічує плагіни спільноти з реєстру Awesome Ogma Plugins.

1. Перегляньте список плагінів або виконайте пошук.
2. Натисніть плагін, щоб побачити опис, версію й метадані сумісності.
3. Натисніть **Установити** для безпосереднього встановлення.
4. Якщо для встановленого плагіна з каталогу доступна новіша сумісна версія, дія змінюється на **Оновити**.

Установлення з каталогу потребує мережевого з’єднання для отримання пакета.

## Пов’язані сторінки {#related-pages}

* [Швидкий старт плагінів](/uk/plugins/quickstart)
* [SDK серверної частини](/uk/plugins/backend-sdk)
* [SDK інтерфейсу](/uk/plugins/frontend-sdk)