[comment]: # aside:2

[comment]: # ({a2041013-7b40086b})
# Struktura plików modułu

Cały kod związany z modułem jest przechowywany w pojedynczym katalogu wewnątrz katalogu **modules** instalacji frontendu Zabbix (na przykład *zabbix/ui/modules*).

[comment]: # ({/a2041013-7b40086b})

[comment]: # ({887796fe-dffd3e26})
### Drzewo plików modułów

````Yaml
example_module_directory/ (wymagane)
   manifest.json (wymagane) Metadane i definicja akcji.
   Module.php Inicjalizacja modułu i obsługa zdarzeń.
   actions/   pliki kontrolera akcji.
       SomethingView.php
       SomethingCreate.php
       SomethingDelete.php
       data_export/
           ExportAsXml.php
           ExportAsExcel.php
   views/   pliki widoków.
       example.something.view.php
       example.something.delete.php
   assets/   wszelkie dodatkowe pliki do wykorzystania w widokach. Należy określić w pliku manifest.json.
       js/   skrypty JavaScript używane w widokach.
           example.something.view.js.php
       css/   pliki CSS używane w widokach.
           example.something.css
        image.png   obraz do użycia w widokach.
        example.something.file   dowolny plik do użycia w widokach.
````

[comment]: # ({/887796fe-dffd3e26})

[comment]: # ({f1074788-1d438d3e})
### Tworzenie modułu

Przykładowy proces tworzenia modułu składa się z następujących kroków (jeśli to możliwe, kliknij nazwę pliku lub folderu, aby wyświetlić dodatkowe szczegóły dotyczące danego kroku):

1. Utwórz nowy katalog dla modułu w **zabbix/ui/modules/**.
2. Dodaj plik [manifest.json](/devel/modules/file_structure/manifest) z metadanymi modułu.
3. Utwórz folder *[views](/devel/modules/file_structure/views)* i zdefiniuj widok(i) modułu.
4. Utwórz folder *[actions](/devel/modules/file_structure/actions)* i zdefiniuj akcję(i) modułu.
5. Utwórz plik Module.php (lub Widget.php dla widgetów pulpitu) i zdefiniuj reguły inicjalizacji oraz obsługi zdarzeń.
6. Utwórz folder *[assets](/devel/modules/file_structure/assets)* na pliki JavaScript (umieszczane w *assets/js*), style CSS (umieszczane w *assets/css*) lub inne dodatkowe pliki.
7. Upewnij się, że w pliku manifest.json określono wymagane pliki views, actions i assets.
8. [Zarejestruj](/devel/modules/file_structure/register) moduł w frontend Zabbixa i zacznij z niego korzystać.

:::notetip
Możesz zarejestrować i włączyć moduł zaraz po utworzeniu pliku manifest.json.
Po włączeniu modułu możesz natychmiast podejrzeć wszystkie zmiany wprowadzone w plikach modułu, odświeżając frontend Zabbixa.
:::

[comment]: # ({/f1074788-1d438d3e})
