[comment]: # ({d2a688ac-ed2f6c13})
# 3 Moduli frontend

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

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

È possibile estendere le funzionalità del frontend di Zabbix aggiungendo moduli di terze parti oppure sviluppando moduli personalizzati,
senza la necessità di modificare il codice sorgente di Zabbix.

Si noti che il codice del modulo verrà eseguito con gli stessi privilegi del
codice sorgente di Zabbix. Ciò significa che:

-   i moduli di terze parti possono essere dannosi. È necessario fidarsi dei moduli che si stanno
    installando;
-   gli errori nel codice di un modulo di terze parti possono causare il crash del frontend. Se ciò
    accade, è sufficiente rimuovere il codice del modulo dal frontend. Non appena
    si ricarica il frontend di Zabbix, verrà visualizzato un avviso che indica che alcuni
    moduli sono assenti. Andare a [Amministrazione dei
    moduli](/manual/web_interface/frontend_sections/administration/general#modules)
    (in *Amministrazione* → *Generale* → *Moduli*) e fare nuovamente clic su *Scansiona
    directory* per rimuovere dal database i moduli non esistenti.

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

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

Leggere sempre il manuale di installazione del modulo specifico. Si
consiglia di installare i nuovi moduli uno alla volta, per individuare
facilmente eventuali errori.

Subito prima di installare un modulo:

-   Assicurarsi di aver scaricato il modulo da una fonte affidabile.
    L'installazione di codice dannoso può portare a conseguenze come la
    perdita di dati
-   Versioni diverse dello stesso modulo (stesso ID) possono essere installate in
    parallelo, ma solo una singola versione può essere abilitata alla volta

Passaggi per installare un modulo:

-   Estrarre il modulo nella propria cartella all'interno della cartella `modules` del
    frontend di Zabbix
-   Assicurarsi che la cartella del modulo contenga almeno il file
    manifest.json
-   Andare a [Amministrazione dei
    moduli](/manual/web_interface/frontend_sections/administration/general#modules)
    e fare clic sul pulsante *Scansiona directory*
-   Il nuovo modulo apparirà nell'elenco insieme alla sua versione, autore,
    descrizione e stato
-   Abilitare il modulo facendo clic sul suo stato

Risoluzione dei problemi:

|Problem|Solution|
|-------|--------|
|*Il modulo non è apparso nell'elenco*|Se il modulo non appare nell'elenco, assicurarsi che manifest.json esista in modules/your-module/. In caso contrario, il modulo potrebbe essere stato estratto nella directory sbagliata. Se invece esiste, il modulo potrebbe non essere compatibile con la propria versione di Zabbix. Inoltre, verificare che l'utente del web server abbia almeno accesso in lettura e ricerca (`r-x`) alla cartella del modulo e a tutte le sottodirectory, e accesso in lettura (`r--`) a tutti i file al loro interno.|
|*Il frontend si è bloccato*|Il codice del modulo non è compatibile con l'attuale versione di Zabbix o con la configurazione del server. Eliminare i file del modulo e ricaricare il frontend. Verrà visualizzato un avviso che indica che alcuni moduli sono assenti. Andare a [Amministrazione dei moduli](/manual/web_interface/frontend_sections/administration/general#modules) e fare clic di nuovo su *Scansiona directory* per rimuovere dal database i moduli non esistenti.|
|*Viene visualizzato un messaggio di errore relativo a namespace, ID o azioni identici*|Il nuovo modulo ha tentato di registrare un namespace, un ID o delle azioni già registrati da altri moduli abilitati. Disabilitare il modulo in conflitto (indicato nel messaggio di errore) prima di abilitare quello nuovo.|
|*Vengono visualizzati messaggi di errore tecnici*|Segnalare gli errori allo sviluppatore del modulo.|

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

[comment]: # ({5ca56638-26c922c0})
#### Sviluppo di moduli

Per informazioni sullo sviluppo di moduli personalizzati, vedere il [Centro sviluppatori](/devel/modules).

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