Joomla!, infatti, permette di personalizzare title e description delle pagine ma, qualora queste informazioni non vengano inserite, verranno letti dal file di configurazione i valori di default (relativi alla home page del sito) ed applicati a title e description della pagina corrente!

I valori di title e description del sito, infatti, sono memorizzati nel file configuration.php, sono modificabili dal back-end di Joomla!, e valorizzano le variabili: sitename e MetaDesc

Per evitare che ciò accada, possiamo inserire due controlli prima della chiusura del tag </body> nel nostro template, proprio su questi due campi, con codice come questo:

<?php
$CONFIG =& new JConfig();
if ($CONFIG->sitename == $this->title) echo '<br/><b>Title di default!</b>';
if ($CONFIG->metaDesc == $this->MetaDesc) echo '<br/><b>Description di default!</b>';
?>


Per fare ciò, basta includere nel template:

<?php if ($this->countModules('right')): ?>
<div id="right_col">
<jdoc:include type="modules" name="right" />
</div>
<?php endif; ?>


In questo modo, inseriremo tutti i moduli per la position “right” all’interno del div id=”right_col”.
Questo approccio diventa più interessante se decidessimo di escludere il caricamento di alcuni moduli, utilizzando la sintassi seguente:

<?php if ($this->countModules('right')): ?>
<div id="right_col">
<?php
$arraym=JModuleHelper::getModules('right');
foreach ($arraym as $module){
if($module == 'mymodule') echo JModuleHelper::renderModule($module);
}
?>
</div>
<?php endif; ?>


In questo modo, carichiamo esclusivamente il modulo ‘mymodule’.

• option (il componente attualmente eseguito)
• view (relativa al task richiesto)
• id dell’articolo eventualmente  fornito al componente (com_content, ad esempio)

Per accedere alle variabili della pagina corrente che Joomla! inserisce anche nella REQUEST_URI (ovvero, la url che compare nella barra degli indirizzi del browser, dopo il primo livello del dominio), si può utilizzare un metodo della classe JRequest, in questo modo:

JRequest::getVar('option', '', 'method', 'option');
JRequest::getVar('view', '', 'method', 'view');
JRequest::getVar('id', '', 'method', 'id');

Mi è capitato spesso di vedere codice “sporco” che utilizzava, per recuperare i valori di tali variabili, propio la

$_SERVER['REQUEST_URI']

Il vantaggio di utilizzare un metodo che accede alla struttura dati dell’applicazione è che, anche in presenza di un componente per l’url rewriting che potrebbe modificare la url (rimuovendo tali variabili a favore di una url SEF), si riesce ugualmente ad accedere ai valori di option, view e id.

Per accedere all’oggetto JLanguage:

$lang =& JFactory::getLanguage();

Vi ricordo, in ogni caso, che per accedere direttamente alle costanti di lingua è disponibile la classe JText che, in maniera molto rapida, consente di richiamare il valore delle costanti, come indicato in un’altra pillola di Joomla!

Stesso discorso per il caricamento di file: capita spesso che per caricare dal fron-end più file, ad esempio per consentire agli utenti di una community in Joomla! di caricare le proprie foto sul profilo, il caricamento dei file non vada a buon fine (talvolta senza segnalarlo all’utente): ciò è dovuto ad un valore troppo basso della variabile upload_max_filesize (alcuni fornitori di hosting impostano questo valore a numeri bassissimi quali 8M)

Il suggerimento è quello di aumentare tali valori (o di chiedere al proprio provider di hosting di aumentarli) a:

• 128M per il memory_limit
• 32M per upload_max_filesize

I valori di queste variabili possono essere verificati dal back-end di Joomla! dal menu Aiuto -> Info sistema

Ebbene, aggiungere al template parametri è semplicissimo:

basta aggiungere nella directory del template un file params.ini contenente su ogni riga la coppia parametro=valore che vogliamo definire.

Ad esempio:

sfondo=#FFFFFF
menu=sinistra

Per “informare” il template dell’esistenza di questo file, andrà aggiunto all’elenco dei file presenti nel file templateDetails.xml del template in questione.

Questi parametri possono essere richiamati da ogni pagina del template con l’istruzione:

<?php echo $this->params->get('sfondo'); ?>

Ma non finisce qui …possiamo aggiungere il controllo di questi parametri al back-end di Joomla! (dal pannello di modifica del template), aggiungendo al file templateDetails.xml i parametri con i relativi valori possibili, es:

<params>
<param name="sfondo" type="list" default="#FFFFFF" label="Sfondo pagina" description="Definisce il colore di sfondo">
<option value="#FFFFFF">Bianco</option>
<option value="#000000">Nero</option>
</param>
<param name="menu" type="list" default="left" label="Posizione menu" description="Definisce la posizione del menu utente">
<option value="right">Destra</option>
<option value="left">Sinistra</option>
</param>
</params>

In questo modo, oltre a poter gestire questi parametri del back-end di Joomla! senza dover modificare il file params.ini avremo il supporto del database di Joomla! per memorizzare i parametri scelti.

Ovviamente, possiamo definire anche parametri che non prevedono delle opzioni bensì campi aperti.

Visto che potremmo trovarci a dover includere un’altra libreria Javascript differente da quella di Joomla! (magari anche una versione JSmin-ed di mootools), possiamo alleggerire il caricamento delle pagine rimuovendo l’inclusione di mootools con poche righe di codice, da inserire nel template, prima dell’istruzione di inserimento dell’header:

<?php

// reupero l'oggetto contenente i parametri dell'header
$headerstuff = $this->getHeadData();
// svuoto il vettore dei javascript da caricare
$headerstuff['scripts'] = array();
// salvo le modifiche
$this->setHeadData($headerstuff);
?>

a questo punto, nel template, possiamo includere l’header:

<jdoc:include type="head" />

Un template per Joomla! può essere esteso personalizzando l’aspetto delle singole view per ogni componente installato: il metodo è molto semplice.

Ammettiamo, ad esempio, di voler personalizzare l’aspetto delle pagine di articoli di Joomla! per renderla differente dalla home page o da altre.
Gli articoli di Joomla! vengono visualizzati dalla view ‘article’ di com_content.

Per personalizzare l’aspetto di quella view, basterà creare una struttura del genere all’intero della directory del nostro template:

/html/com_content/article

con all’interno il solito file dummy index.html:

<html><body bgcolor="FFFFFF"></body></html>

ed il file default.php contenente le direttive jdoc dei moduli che vogliamo visualizzare più, ovviamente, il layout personalizzato per questo particolare task del componente com_content

Per quanto il modello MVC implementato da Joomla! 1.5 non richieda l’utilizzo di un simile stratagemma per cambiare aspetto a pagine differenti dello stesso componente, può essere utile (ad esempio per testare una versione con un template differente senza modificare le impostazioni dal back-end), richiamare la url del contenuto che vogliamo vedere con un template differente aggiungendo il parametro

&template=nome_template

Il vantaggio è quello di poterlo instalare/disinstallare a piacimento ed in maniera semplice, utilizzando la funzione presente nel back-end del CMS.

Per fare ciò basterebbe comprimere in un file .zip (o un .tar.gz) quanto presente nella directory com_miocomponente se non fosse che spesso i pacchetti, in quanto programmi complessi, possono utilizzare tabelle di appoggio nel database e eventualmente dati necessari a questi per funzionare.

Per creare automaticamente tabelle nel database di Joomla! all’installazione del componente, inserirne valori e rimuovere tutto alla disinstallazione del componente, basta aggiungere alla directory del componente due file sql:

install.sql - contenente le query di creazione della/e tabella/e e eventualmente dei dati da inserire, ad esempio:

DROP TABLE IF EXISTS `#__miatab`;

CREATE TABLE '#__miatab` (
'id' INT NOT NULL AUTO_INCREMENT,
'nome');

INSERT INTO '#__miatab' ('id', 'nome') VALUES (1, 'antonio');

NB: Notate l’utilizzo della costante #__ per il suffisso delle tabelle

Il file uninstall.sql, invece:

DROP TABLE IF EXISTS '#__miatab';

Importante ora è modificare il file xml che descrive il componente, aggiungendo (prima dei tag dei files):

<install>
<sql>
<file charset="utf8" driver="mysql">install.sql</file>
</sql>
</install>

<uninstall>
<sql>
<file charset="utf8" driver="mysql">uninstall.sql</file>
</sql>
</uninstall>