5.2. Gestione moduli

L'installazione, aggiornamento e rimozione di un modulo sono dei procedimenti standard, tuttavia alcuni moduli possono richiedere del lavoro aggiuntivo. Prima di usare un modulo è sempre meglio leggere l'eventuale documentazione contenuta nella cartella docs/ del modulo stesso.

Installare un modulo

I moduli vanno installati nella cartella modules/ nella root del vostro webserver. A volte però i moduli hanno la necessità di installare dei file in altre cartelle (ad esempio i moduli compatibili con la ricerca di Zikula mettono un file in includes/search/ ), prima di copiare il modulo dovete quindi verificare quale sia la struttura delle cartelle. Scompattatelo e vediamo come potrebbe presentarsi il modulo:

  • se la cartella appena creata contiene dei file php, e le cartelle templates/ pnimages/ pnstyle/ significa che questo è il modulo vero e proprio! Dovete quindi copiare la cartella (e sottolineo la cartella, non solo il suo contenuto) nella cartella modules/ del sito;
  • se la cartella appena creata non contiene file php (o ne contiene solo 1-2) e ci sono alcune tra le cartelle docs/ includes/ modules/ pnTemp/ significa che questo modulo deve installare dei file anche in altre cartelle. Copiate tutte queste cartelle nella root del vostro sito, vi chiederà di sostituirle/unirle, ditegli di si;
  • in tutti gli altri casi (capita molto raramente) dovete cercare di capire come sia stato creato il pacchetto. Considerate che in ogni caso nella cartella modules/ dovrete copiare una cartella con il nome del modulo che state installando contente i file e le cartelle del primo punto;

Una volta che avete caricato i file andate nel pannello di amministrazione nella scheda Sistema/System e cliccate su moduli. Aggiornate la lista. A questo punto, se il modulo era posizionato correttamente, lo troverete nell'elenco come inattivo.

Cliccate sulla freccia verde per iniziare l'installazione vera e propria. Questo passaggio varia da modulo a modulo, in alcuni l'installazione è diretta mentre in altri vi può venir chiesto di fare qualcosa (es. cambiare i permessi di una cartella).

A questo punto il modulo sarà inattivo. Cliccate sulla nuova icona verde per attivarlo (La tabella riporta la versione e lo stato di ogni modulo).

Ora l'installazione è finita, troverete l'interfaccia di amministrazione (se quel modulo la ha) nella scheda Terze Parti e potrete accedere alla parte utente scrivendo nella barra dell'indirizzo:
http://www.vostrosito.it/index.php?name=_NOME_MODULO_

Fate riferimento alla sezione blocchi per sapere come aggiungere il link nel menù.

Aggiornare un modulo

L'aggiornamento di un modulo è un passaggio abbastanza semplice. Eseguite ugualmente il backup prima di farlo.

Non dovete far altro che sovrascrivere i file con quelli nuovi, andare nell'amministrazione moduli, Aggiornare la lista e cliccare sull'icona di aggiornamento che comparirà nelle Azioni del modulo. Se sarà necessario fare qualcosa ve lo comunicherà il modulo stesso.

Nota: dopo l'aggiornamento il modulo sarà disattivato, dovrete riattivarlo.

Rimuovere un modulo

Per eliminare un modulo dovete prima disattivarlo. Andate nell'amministrazione moduli, disattivatelo cliccando sull'icona grigia e cliccate infine sull'icona del cestino a fianco del modulo. Se sarà necessario fare qualcosa ve lo dirà il modulo stesso.

La rimozione non elimina i file del modulo, li dovrete cancellare voi a mano (in caso contrario il modulo ricomparirà nella lista, come non installato, la prossima volta che la aggiornerete).

Importante: normalmente l'eliminazione del modulo cancella tutti i suoi dati dal database. Se non siete sicuri di volerli perdere potete limitarvi a renderlo inattivo: non sarà più accessibile e i dati verranno conservati.