5. Moduli

Questa sezione tratta i moduli su Zikula, spiegando cosa sono, come installarli, aggiornarli, configurarli e rimuoverli.

Non tratta il loro sviluppo in quanto vi è una guida dedicata a quell'argomento.


5.1. Cosa sono i moduli?

I moduli rappresentano il modo principale per personalizzare Zikula.

Zikula è un sistema altamente modulare, cioè le potenzialità base possono essere aumentate o modificate tramite l'installazione di nuovi moduli. Alcuni esempi di moduli sono News (permette di pubblicare notizie), Pages (permette di pubblicare pagine statiche) e Downloads (permette di pubblicare file).

Spesso esistono più moduli che eseguono la stessa funzione ma in modo diverso, sta all'amministratore valutarne le caratteristiche e decidere quale sia il più adatto allo scopo.

I moduli sono generalmente composti da:

  • file php: script che gestiscono l'accesso ai dati
  • template: la struttura html della pagina
  • fogli di stile: la grafica della pagina
  • javascript

E' importante tenere aggiornati i moduli, infatti ogni nuova versione può contenere  bugfix e miglioramenti della sicurezza, oltre che ad eventuali nuove features.

Nota: dal punto di vista strettamente tecnico non vi è alcuna differenza tra i moduli di sistema (contenuti nella cartella system/ ) e i moduli aggiuntivi (contenuti nella cartella modules/ ), è solo una distinzione per chiarire la struttura del CMS e l'importanza dei diversi moduli.


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.


5.3. Configurazione

Configurazione Interna

La configurazione interna varia molto da modulo a modulo, alcuni non richiedono configurazione mentre altri permettono di determinare molti parametri.

Quasi tutti i moduli hanno un'interfaccia di amministrazione da cui configurarli.

I moduli appena aggiunti li troverete nella scheda Terze Parti, o in quella che avete configurato come scheda di default per i nuovi moduli aggiunti.

Configurazione Esterna

Per configurazione esterna si intendono tutti quei fattori che non dipendono direttamente dal modulo.

Nell'interfaccia di amministrazione del modulo Ricerca potrete scegliere in quali moduli, tra quelli compatibili con il sistema di ricerca di Zikula, verranno effettuate le ricerche dell'utente. Di default sono abilitati tutti i moduli.

Nell'interfaccia di amministrazione del modulo Moduli potrete scegliere, cliccando sull'icona a forma di graffetta a fianco di ogni modulo, quali hook attivare. Questo argomento verrà trattato meglio nella sezione Hooks.