Zásuvné moduly
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
- 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
- V zobrazení Zásuvné moduly klikněte na Nainstalovat.
- Zvolte Cesta ke složce.
- Vyberte kořenový adresář pluginu. Adresář musí obsahovat platný manifest pluginu a soubory, které manifest deklaruje.
- Ogma ověří balíček a zaregistruje jej.
- Povolte plugin, aby se aktivoval.
Instalace ze ZIP archivu
- V zobrazení Zásuvné moduly klikněte na Nainstalovat.
- Zvolte Soubor ZIP.
- Vyberte soubor pluginu
.zip. - Zkontrolujte zjištěný název a verzi pluginu.
- 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
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í
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
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í
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
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ů
Karta Katalog pluginů uvádí komunitní pluginy z registru Awesome Ogma Plugins.
- Procházejte nebo prohledávejte seznam pluginů.
- Klikněte na plugin a zobrazte jeho popis, verzi a metadata kompatibility.
- Kliknutím na Nainstalovat jej přímo nainstalujte.
- 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.