Blog Jooma! Raccoglitore di news e bloggate sul CMS Joomla!

Questo è un trucco semplice e già abbastanza noto che ci permette di vedere le posizioni moduli di un template senza dover accedere al pannello manager.

Sicuramente molti già lo conoscevano - se ne è parlato al JoomlaDay 2009 - , ma non tutti conoscono ancora questa procedura. Una cosa è certa... servirà tantissimo agli sviluppatori che, incontrando un joomla, useranno il comando ?=tp1 spessissimo; diventerà quasi un vizio!!

Il trucco è semplicemente, infatti basta aggiungere /?Tp=1 dopo l'url del sito su cui vogliamo vedere il nome della posizioni blocco modulo. Lascio qui un esempo per comprendere appieno il funzionamento:
http://joomla.org/?tp=1

Viene qui visualizzato l’elenco dei moduli presenti nel sito. Di ogni modulo possiamo impostarne la posizione nel nostro template. Le posizioni possono essere pensate come aree in cui possiamo inserire uno o più moduli, inserirli verticalmente o orizzontalmente.

Ogni template, essendo unico, gestisce le posizioni all’interno della pagina in modo differente, senza una regola precisa tranne la corrispondenza di alcune definizioni come “left”, "right" “top”, “footer”. Ma queste definizioni non corrispondono in tutti i template alla stessa posizione. Cambiando template a volte non compaiono dei moduli, oppure compaiono ma in posizioni completamente diverse da quelle del template precedentemente impostato come predefinito.

Per vedere quali sono le posizioni che vengono fornite da un template apriamo la pagina “Gestione template” e clicchiamo su “Anteprima” . Verrà mostrata una pagina in cui, sovrapposto al template, viene mostrata una maschera che elenca le posizioni utilizzate da ogni modulo per il template in uso.

Come inserire una nuova posizione

Apriamo il nostro client FTP e colleghiamoci al server in cui risiede fisicamente il nostro Joomla. Selezioniamo la cartella templates ed apriamo la directory del template in uso. Scarichiamo sul nostro pc ed apriamo il file templateDetails.xml per studiarne la struttura: scorriamo fino a trovare il tag <positions>.

Le posizioni identificate dal file sono quelle utilizzabili all’interno del template. Questo ci indica quali posizioni possiamo usare, ma non dove vengono utilizzate. Per capire dove queste vengono visualizzate ed il loro funzionamento, apriamo il file index.php. Troviamo all’interno pezzi di codice HTML e PHP; speciali istruzioni definite come jdoc:include

Questa istruzione indica a Joomla di includere tutti i moduli che hanno come posizione “user4”. Per modificare dove deve essere visualizzata una posizione è sufficiente agire nel file index.php e nel CSS; si raccomanda prudenza perchè basta una piccola distrazione e possiamo "distruggere" il nostro bel template. Per questo si raccomanda, prima di ogni modifica, di salvare il file e conservarlo in caso di emergenza.

Per aggiungere una nuova posizione invece apriamo il file templateDetails.xml ed aggiungiamo una nuova voce <position>, definendola con un nome univoco non in uso. Ora all’interno del file index.php individuiamo la posizione dove verrà aggiunta la posizione ed inseriamo una linea di codice come questa:

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

A questo punto non resta che applicare a questa posizione i corretti stili CSS in modo che venga visualizzata nella giusta posizione e nel modo da noi desiderato. Si raccomanda sempre la massima prudenza. L'errore è dietro l'angolo quando tocchiamo questi tipi di file.