---
url: https://docs.ogmabox.com/pl/app/plugins.md
description: >-
  Instaluj, aktualizuj i twórz wtyczki Ogma z lokalnych pakietów, folderów,
  archiwów ZIP i katalogu wtyczek oraz zarządzaj nimi.
---

# Wtyczki {#plugins}

Wtyczki rozszerzają Ogma o niestandardowe strony interfejsu, przetwarzanie w backendzie, obsługę zdarzeń i panele ustawień — wszystko w granicach uprawnień zadeklarowanych przez wtyczkę.

## Co mogą dodawać wtyczki {#what-plugins-can-add}

* Niestandardowe strony interfejsu dostępne z lewego panelu nawigacji.
* Trasy backendu przetwarzające żądania lub odpowiedzi.
* Procedury obsługi zdarzeń wywoływane przez przechwycony ruch.
* Strony ustawień do konfiguracji właściwej dla wtyczki.
* Polecenia, które można zarejestrować w palecie poleceń.

## Instalacja z folderu {#install-from-folder}

1. Kliknij **Zainstaluj** w widoku Wtyczki.
2. Wybierz **Ścieżka folderu**.
3. Wybierz katalog główny wtyczki. Katalog musi zawierać prawidłowy manifest wtyczki i zadeklarowane w nim pliki.
4. Ogma zweryfikuje pakiet i go zarejestruje.
5. Włącz wtyczkę, aby ją aktywować.

## Instalacja z archiwum zip {#install-from-zip-archive}

1. Kliknij **Zainstaluj** w widoku Wtyczki.
2. Wybierz **Plik ZIP**.
3. Wybierz plik `.zip` wtyczki.
4. Sprawdź wykrytą nazwę i wersję wtyczki.
5. Kliknij **Zainstaluj z ZIP**, a następnie włącz wtyczkę.

Wtyczki instalowane z zip są kopiowane do zarządzanego katalogu wtyczek Ogma. Oryginalne archiwum można usunąć po instalacji.

## Ostrzeżenia o zgodności {#compatibility-warnings}

Po instalacji Ogma może wyświetlić ostrzeżenia na stronie szczegółów wtyczki. Mają one charakter informacyjny — nie uniemożliwiają uruchomienia wtyczki.

Typowe ostrzeżenia:

* **Pliki bez odwołań** — pliki obecne w pakiecie, ale niezadeklarowane w manifeście.
* **Brak warstwy zgodności środowiska uruchomieniowego** — wtyczka używa API wymagającego warstwy zgodności, której nie ma w tej wersji Ogma.

Sprawdź ostrzeżenia przed włączeniem nieznanej wtyczki.

## Włączanie i wyłączanie {#enable-and-disable}

Użyj przełącznika **Włączone** w wierszu wtyczki, aby ją aktywować lub dezaktywować. Wyłączone wtyczki pozostają zainstalowane, ale nie działają. Ponowne włączenie przywraca wtyczkę bez ponownej instalacji.

## Karty szczegółów wtyczki {#plugin-detail-tabs}

Wybierz wtyczkę, aby otworzyć jej panel szczegółów. Panel zawiera następujące karty.

| Karta | Zawartość |
|-----|----------|
| Przegląd | Nazwa, wersja, autor, opis i źródło wtyczki. |
| Ostrzeżenia | Problemy zgodności wykryte podczas instalacji lub włączania. |
| Uprawnienia | Uprawnienia żądane przez wtyczkę i przyznane przez Ogma w czasie działania. |
| Pliki | Lista plików w pakiecie wtyczki. |
| Dzienniki | Dane wyjściowe wtyczki z podświetlaniem składni ustrukturyzowanych wierszy logów. |
| Interfejs | Niestandardowa strona wtyczki wyświetlana bezpośrednio w panelu. |

## Uprawnienia {#permissions}

Karta Uprawnienia zawiera wszystkie uprawnienia zadeklarowane w manifeście wtyczki i bieżący stan ich przyznania. Wywołania backendu są kontrolowane po stronie serwera. Interfejs odzwierciedla aktualny stan każdego uprawnienia.

Jeśli wtyczka nie działa zgodnie z oczekiwaniami, sprawdź kartę Uprawnienia, aby potwierdzić przyznanie wymaganych uprawnień.

## Tryb deweloperski {#dev-mode}

Wtyczki zainstalowane z folderu mają oznaczenie **Deweloperskie** i przycisk **Odśwież**.

Kliknij **Odśwież**, aby zastosować zmiany kodu bez ponownej instalacji. Wtyczka uruchomi się ponownie i ponownie zarejestruje wszystkie procedury obsługi zdarzeń i trasy. Jest to standardowy cykl pracy autorów wtyczek.

Wtyczki w trybie deweloperskim pozostają powiązane z folderem źródłowym. Zmiany plików w tym folderze zostaną zastosowane przy następnym przeładowaniu.

## Katalog wtyczek {#marketplace}

Karta **Katalog wtyczek** pokazuje wtyczki społeczności z rejestru Awesome Ogma Plugins.

1. Przeglądaj lub przeszukuj listę wtyczek.
2. Kliknij wtyczkę, aby zobaczyć jej opis, wersję i metadane zgodności.
3. Kliknij **Zainstaluj**, aby zainstalować ją bezpośrednio.
4. Jeśli dla zainstalowanej wtyczki z katalogu jest dostępna nowsza zgodna wersja, akcja zmieni się na **Zaktualizuj**.

Instalacje z katalogu wymagają połączenia z siecią w celu pobrania pakietu.

## Powiązane strony {#related-pages}

* [Pierwsze kroki z wtyczkami](/pl/plugins/quickstart)
* [SDK backendu](/pl/plugins/backend-sdk)
* [SDK frontendu](/pl/plugins/frontend-sdk)