---
url: https://docs.ogmabox.com/cs/app/plugins.md
description: >-
  Instalujte, spravujte, aktualizujte a vyvíjejte pluginy Ogma z lokálních
  balíčků, složek, ZIP archivů a tržiště.
---

# Zásuvné moduly {#plugins}

Pluginy rozšiřují Ogma o vlastní stránky rozhraní, backendové zpracování, obsluhu událostí a panely nastavení – vše v mezích deklarovaných oprávnění pluginu.

## Co mohou pluginy přidat {#what-plugins-can-add}

* Vlastní stránky rozhraní přístupné z levé navigace.
* Backendové trasy zpracovávající požadavky nebo odpovědi.
* Obsluhu událostí vyvolaných zachyceným provozem.
* Stránky nastavení pro konfiguraci konkrétního pluginu.
* Příkazy, které lze registrovat v paletě příkazů.

## Instalace ze složky {#install-from-folder}

1. V zobrazení **Zásuvné moduly** klikněte na **Nainstalovat**.
2. Zvolte **Cesta ke složce**.
3. Vyberte kořenový adresář pluginu. Adresář musí obsahovat platný manifest pluginu a soubory, které manifest deklaruje.
4. Ogma ověří balíček a zaregistruje jej.
5. Povolte plugin, aby se aktivoval.

## Instalace ze ZIP archivu {#install-from-zip-archive}

1. V zobrazení **Zásuvné moduly** klikněte na **Nainstalovat**.
2. Zvolte **Soubor ZIP**.
3. Vyberte soubor pluginu `.zip`.
4. Zkontrolujte zjištěný název a verzi pluginu.
5. Klikněte na **Nainstalovat** a poté plugin povolte.

Instalace ze ZIP se kopírují do spravovaného adresáře pluginů Ogma. Původní archiv lze po instalaci odstranit.

## Upozornění na kompatibilitu {#compatibility-warnings}

Po instalaci může Ogma zobrazit upozornění na stránce podrobností pluginu. Jsou informativní a nebrání spuštění pluginu.

Běžná upozornění:

* **Soubory bez odkazu v manifestu** – soubory přítomné v balíčku, které manifest nedeklaruje.
* **Chybějící kompatibilní vrstva běhového prostředí** – plugin používá API vyžadující kompatibilní vrstvu, která v této verzi Ogma není přítomna.

Před povolením neznámého pluginu upozornění zkontrolujte.

## Povolení a zakázání {#enable-and-disable}

Pomocí ovládacích prvků **Zapnout** a **Vypnout** plugin aktivujete nebo deaktivujete. Zakázané pluginy zůstávají nainstalované, ale neběží. Opětovným povolením se plugin obnoví bez nové instalace.

## Karty podrobností pluginu {#plugin-detail-tabs}

Vyberte plugin a otevřete jeho panel podrobností. Panel obsahuje následující karty.

| Karta | Obsah |
|-----|----------|
| Přehled | Název pluginu, verze, autor, popis a zdroj. |
| Upozornění | Problémy s kompatibilitou zjištěné při instalaci nebo povolení. |
| Oprávnění | Co plugin požadoval a co Ogma za běhu udělila. |
| Soubory | Seznam souborů v balíčku pluginu. |
| Protokoly | Výstup pluginu za běhu se zvýrazněním syntaxe strukturovaných řádků protokolu. |
| Rozhraní | Vlastní stránka pluginu vykreslená přímo v panelu. |

## Oprávnění {#permissions}

Karta Oprávnění uvádí každé oprávnění deklarované pluginem v manifestu a aktuální stav jeho udělení. Oprávnění pro backendová volání se vynucují na straně serveru. Rozhraní odráží aktuální stav každého oprávnění.

Pokud se plugin nechová podle očekávání, na kartě Oprávnění ověřte, že jsou požadovaná oprávnění udělena.

## Vývojový režim {#dev-mode}

Pluginy nainstalované ze složky zobrazují štítek **Vývoj** a tlačítko **Znovu načíst**.

Kliknutím na **Znovu načíst** použijete změny kódu bez opětovné instalace. Plugin se restartuje a znovu zaregistruje všechny obsluhy událostí a trasy. Jde o standardní postup průběžného vývoje pluginů.

Pluginy ve vývojovém režimu zůstávají propojené se zdrojovou složkou. Změny souborů v této složce se projeví při příštím opětovném načtení.

## Katalog pluginů {#marketplace}

Karta **Katalog pluginů** uvádí komunitní pluginy z registru Awesome Ogma Plugins.

1. Procházejte nebo prohledávejte seznam pluginů.
2. Klikněte na plugin a zobrazte jeho popis, verzi a metadata kompatibility.
3. Kliknutím na **Nainstalovat** jej přímo nainstalujte.
4. Pokud je pro nainstalovaný plugin z tržiště dostupná novější kompatibilní verze, akce se změní na **Aktualizovat**.

Instalace z tržiště vyžadují síťové připojení pro stažení balíčku.

## Související stránky {#related-pages}

* [Vytvořte svůj první plugin](/cs/plugins/quickstart)
* [Backendové SDK](/cs/plugins/backend-sdk)
* [Frontendové SDK](/cs/plugins/frontend-sdk)