[comment]: # ({d2a688ac-ed2f6c13})
# 3 Moduły frontend

[comment]: # ({/d2a688ac-ed2f6c13})

[comment]: # ({8c4f6bda-1060eddf})
#### Przegląd

Możliwe jest rozszerzenie funkcjonalności frontend Zabbix przez dodanie modułów firm trzecich lub tworzenie własnych modułów
bez konieczności zmiany kodu źródłowego Zabbix.

Należy pamiętać, że kod modułu będzie uruchamiany z takimi samymi uprawnieniami jak kod
źródłowy Zabbix. Oznacza to, że:

-   moduły firm trzecich mogą być szkodliwe. Musisz ufać modułom, które
    instalujesz;
-   błędy w kodzie modułu firmy trzeciej mogą spowodować awarię frontend. Jeśli tak się
    stanie, po prostu usuń kod modułu z frontend. Gdy tylko
    ponownie załadujesz frontend Zabbix, zobaczysz informację, że niektóre
    moduły są nieobecne. Przejdź do [Administracja modułami](/manual/web_interface/frontend_sections/administration/general#modules)
    (w *Administracja* → *Ogólne* → *Moduły*) i kliknij ponownie *Skanuj
    katalog*, aby usunąć nieistniejące moduły z bazy danych.

[comment]: # ({/8c4f6bda-1060eddf})

[comment]: # ({58ac3ffb-cffdc09c})
#### Instalacja

Zawsze czytaj instrukcję instalacji dla konkretnego modułu. Zaleca się instalowanie nowych modułów pojedynczo, aby łatwo wykrywać błędy.

Tuż przed instalacją modułu:

-   Upewnij się, że pobrałeś moduł z zaufanego źródła.
    Instalacja szkodliwego kodu może prowadzić do konsekwencji, takich jak utrata danych
-   Różne wersje tego samego modułu (to samo ID) mogą być instalowane równolegle, ale tylko jedna wersja może być włączona jednocześnie

Kroki instalacji modułu:

-   Rozpakuj moduł we własnym folderze w folderze `modules` frontend Zabbix
-   Upewnij się, że folder modułu zawiera co najmniej plik manifest.json
-   Przejdź do [Administracja modułów](/manual/web_interface/frontend_sections/administration/general#modules) i kliknij przycisk *Skanuj katalog*
-   Nowy moduł pojawi się na liście wraz z wersją, autorem, opisem i statusem
-   Włącz moduł, klikając jego status

Rozwiązywanie problemów:

|Problem|Rozwiązanie|
|-------|--------|
|*Moduł nie pojawił się na liście*|Jeśli moduł nie pojawił się na liście, upewnij się, że plik manifest.json istnieje w modules/your-module/. Jeśli go tam nie ma, moduł mógł zostać rozpakowany do niewłaściwego katalogu. Jeśli plik istnieje, moduł może nie być zgodny z Twoją wersją Zabbix. Sprawdź też, czy użytkownik serwera WWW ma co najmniej uprawnienia do odczytu i przeszukiwania (`r-x`) dla folderu modułu i wszystkich podkatalogów oraz uprawnienia do odczytu (`r--`) dla wszystkich plików w środku.|
|*frontend uległ awarii*|Kod modułu nie jest zgodny z bieżącą wersją Zabbix lub konfiguracją serwera. Usuń pliki modułu i odśwież frontend. Zobaczysz powiadomienie, że niektóre moduły są niedostępne. Przejdź do [Administracja modułów](/manual/web_interface/frontend_sections/administration/general#modules) i ponownie kliknij *Skanuj katalog*, aby usunąć nieistniejące moduły z bazy danych.|
|*Pojawia się komunikat o błędzie dotyczącym identycznej przestrzeni nazw, ID lub akcji*|Nowy moduł próbował zarejestrować przestrzeń nazw, ID lub akcje, które są już zarejestrowane przez inne włączone moduły. Przed włączeniem nowego modułu wyłącz moduł powodujący konflikt (wskazany w komunikacie o błędzie).|
|*Pojawiają się techniczne komunikaty o błędach*|Zgłoś błędy twórcy modułu.|

[comment]: # ({/58ac3ffb-cffdc09c})

[comment]: # ({5ca56638-26c922c0})
#### Tworzenie modułów

Aby uzyskać informacje o tworzeniu niestandardowych modułów, zobacz [Developer center](/devel/modules).

[comment]: # ({/5ca56638-26c922c0})