Parametri del template

Alcuni template possono avere dei parametri che vanno impostati, come per esempio i colori dello sfondo. Un altro esempio è dato dal template rhuk_milkyway (è uno dei temi già presenti nel pacchetto di Joomla) che consente, dal pannello di amministrazione (nella sezione Gestione Template), di cambiare i colori dei bordi, il colore dello sfondo e la larghezza della visualizzazione. La possibilità di avere dei template con dei parametri da impostare è nata, a partire da Joomla 1.5, dall'esigenza di creare template flessibili. Se vogliamo aggiungere dei nuovi parametri è necessario modificare il file templateDetails.xml, aggiungere una riga di codice al file params.ini che conterrà il valore corrente del parametro e del codice al file php del template per il recupero e la modifica del valore del parametro.

Supponiamo di voler modificare il colore dello sfondo del nostro template. In questo caso, bisogna aggiungere al file templateDetails.xml delle righe di codice come queste:

<params>
<param name="sfondo" type="list" default="blue" label="sfondo"
description="Variazione dei colori da usar nello sfondo">
 <option value="green">Verde</option>
 <option value="blue">Blu</option>
 <option value="red">Rosso</option>
 <option value="black">Nero</option>
</param>
</params>

In questo modo dal pannello di modifica del template nel back end del sito potremo impostare il valore del parametro che vogliamo, come possiamo vedere in figura

In Joomla sono supportati 20 tipi diversi di parametri. Qui sotto è presente un piccolo elenco di essi, in ordine alfabetico:

• calendar: per fornire un link ad un pop-up di calendario;
• category: per fornire un elenco a discesa delle categorie di una sezione;
• editor: per fornire un elenco a discesa delle proprietà dell'editor WYSIWYG;
• filelist: per fornire un elenco a discesa dei file di una directory specificata;
• folderlist: per fornire un elenco a discesa delle cartelle di una directory specificata;
• helpsites: per fornire un elenco a discesa di siti per l'aiuto per l'installazione di Joomla;
• hidden: per fornire un campo nascosto per il salvataggio di un parametro il cui valore non può essere modificato direttamente da un amministratore, ma solo nel codice o nel file params.ini;
• imagelist: per fornire un elenco a discesa dei file immagine in una directory specificata;
• language: per fornire un elenco a discesa di tutte le lingue installate sia per il front-end e back-end del sito;
• list: per fornire un elenco a discesa di voci personalizzate;
• menu: per fornire un elenco a discesa di un menu;
• menuitem: per fornire un elenco a discesa di voci di menu;
• password: per fornire una casella di testo per una password;
• radio: per fornire i pulsanti per la selezione di opzioni diverse;
• section: per fornire un elenco a discesa delle sezioni;
• SQL: per fornire un elenco a discesa di voci ottenuti eseguendo una query sul database utilizzato dal sito in Joomla;
• text: per fornire una casella di testo per l'immissione di dati;
• textare: per fornire un'area di testo per l'ingresso di testo;
• timezones: per fornire un elenco a discesa del fuso orario;
• usergroup: per fornire un elenco a discesa di gruppi di utenti.

Di tutti questi parametri (che si possono utilizzare sia nello sviluppo di template sia di estensioni) saranno pochi quelli effettivamente usati, per esempio i pulsanti radio oppure il listato di valori.