Installatore di moduli · Guida utente
Installare moduli, direttamente in FreeScout
Con l’installatore di moduli installate e aggiornate i moduli di altri fornitori direttamente in FreeScout: scegliere il file ZIP, guardare l’esito della verifica, confermare. Non serve alcun accesso al server e non dovete copiare file a mano.
L’installatore è riservato agli amministratori. Un modulo lavora con tutti i diritti della vostra installazione FreeScout; chi lo installa decide per tutti.
I moduli di let’s automate non si installano qui, ma tramite LaStore, dove ogni pacchetto viene inoltre verificato con la nostra firma.
Dove trovarlo
In Gestione → Installatore di moduli. A sinistra ci sono tre voci: «Installare un modulo», «Registro» e «Tutti i moduli». L’ultima porta al consueto elenco dei moduli di FreeScout, dove attivate, disattivate ed eliminate i moduli.

Installare un modulo
1. Cliccate su Scegli file e selezionate il file ZIP del modulo.
2. Cliccate su Caricare e verificare.
3. Guardate l’esito della verifica.
4. Lasciate selezionato Attivare dopo l’installazione se il modulo deve funzionare subito, e cliccate su Installare.
Il file può mantenere il nome con cui è stato scaricato. Un archivio da GitHub si chiama per esempio ticketvorlagen-main.zip; l’installatore prende il nome di cartella corretto dal modulo stesso.

Dopo l’installazione compare in alto un messaggio verde, e il modulo appare nell’elenco dei moduli di altri fornitori.

Cosa viene verificato prima dell’installazione
Prima che qualcosa arrivi sul server, l’installatore legge il file ZIP e controlla tra l’altro:
- se contiene esattamente un modulo FreeScout
- se è adatto alla vostra versione di FreeScout e se le estensioni PHP necessarie sono presenti
- se sovrascriverebbe un altro modulo
- se cerca di mettere file fuori dalla propria cartella
- se i file PHP contengono errori di sintassi che bloccherebbero FreeScout. Per questo il codice non viene eseguito.
Se trova un errore, non viene installato nulla e vedete il motivo.

Se manca un modulo richiesto, viene installato ma non attivato. L’esito della verifica indica cosa manca.
Aggiornare un modulo
Molti moduli di altri fornitori non si aggiornano con l’aggiornamento normale di FreeScout. Per questi procedete come per la prima installazione: caricare il nuovo file ZIP, verificare, cliccare su Aggiornare.
L’esito della verifica mostra da quale versione a quale. Se la nuova versione è più vecchia o uguale, compare un avviso.

I moduli che si aggiornano con l’aggiornamento normale di FreeScout continuate ad aggiornarli lì.
Se un aggiornamento non si avvia
Prima di ogni aggiornamento l’installatore mette da parte la versione precedente. Dopo l’aggiornamento avvia FreeScout in un processo separato e verifica che tutto si carichi ancora.
Se non è così, rimette al suo posto la versione precedente e la riattiva. Vedete allora un messaggio rosso con il motivo. La versione salvata resta disponibile per sette giorni.
Questa verifica trova gli errori che impediscono a FreeScout di avviarsi. Un errore che emerge solo usando una determinata funzione non viene rilevato.
Il registro
In Registro compare ogni operazione: quando, quale modulo, da quale versione a quale, con quale esito e da chi. Per i rifiuti e gli aggiornamenti annullati il motivo è indicato sotto.

Buono a sapersi
La verifica non sostituisce la fiducia
L’installatore intercetta archivi difettosi o danneggiati. Non può giudicare se un modulo fa ciò che promette. Installate quindi solo moduli di fornitori di cui vi fidate, e fate un backup prima di modifiche importanti.
Moduli dell’elenco di FreeScout
Anche questi si possono caricare. Poiché la loro licenza la verifica solo FreeScout, vengono installati ma non attivati. Attivateli poi in Gestione → Moduli con la loro chiave di licenza.
Dimensioni
Un file ZIP può arrivare a 100 MB, estratto a 300 MB. Se il vostro server accetta caricamenti più piccoli, vale il suo limite; è indicato sotto il campo.
Eliminare
Un modulo lo eliminate in FreeScout in Gestione → Moduli: prima disattivarlo, poi eliminarlo. Se si elimina la cartella a mano sul server mentre il modulo è ancora attivo, FreeScout non si avvia più.
Non riuscite ad andare avanti? Assistenza