spacer.png, 0 kB
spacer.png, 0 kB
Home arrow Joomla arrow Joomla 1.5.x: jdoc:include
Joomla 1.5.x: jdoc:include PDF Stampa E-mail
Scritto da Administrator   
sabato 04 ottobre 2008

La gestione dei template nella versione 1.5 di Joomla differisce nettamente dalle precedenti versioni e si basa sull'istruzione jdoc:include.
Come si può vedere dall'esempio seguente (e dalla relativa spiegazione) questo sistema risulta molto efficace, potente e versatile e costituisce un buon sistema per la gestione della grafica nel nostro CMS.

<jdoc:include type="component" />
<jdoc:include type="head" />
<jdoc:include type="installation" />
<jdoc:include type="message" />
<jdoc:include type="module" name="breadcrumbs" />
<jdoc:include type="module" name="menu" />
<jdoc:include type="module" name="submenu" style="rounded" id="submenu-box" />
<jdoc:include type="modules" name="debug" />
<jdoc:include type="modules" name="icon" />
<jdoc:include type="modules" name="left" style="rounded" />
<jdoc:include type="modules" name="left" style="xhtml" />
<jdoc:include type="modules" name="right" style="xhtml" />
<jdoc:include type="modules" name="status" />
<jdoc:include type="modules" name="syndicate" />
<jdoc:include type="modules" name="title" />
<jdoc:include type="modules" name="toolbar" />
<jdoc:include type="modules" name="top" />
<jdoc:include type="modules" name="top" style="xhtml" />
<jdoc:include type="modules" name="user1" style="xhtml" />
<jdoc:include type="modules" name="user2" style="xhtml" />
<jdoc:include type="modules" name="user3" />
<jdoc:include type="modules" name="user4" />

Il tipo di attributo (type) specifica il tipo di elemento da sostituire al posto dell'elemento <jdoc:include />. Di seguito la lista dei tipi e le relative spiegazioni.

Component: l'elemento dovrebbe apparire una volta nel <body> del template per includere il contenuto principale della pagina.

Head: l'elemento dovrebbe comparire una volta nel <head> del template per includere gli elementi di stile, gli script e i descrittori meta tags associati alla pagina.

Installation: questo elemento è utilizzato solamente nell'istallazione, e dovrebbe essere trascurato se si parla di un template back o front end. Serve a renderizzare i vari step dell'istallazione.

Message: questo elemento dovrebbe apparire una volta nel <body> del template per includere i vari messaggi di errore nella visualizzazione del sito.

Module: questo elemento include un singolo modulo, il cui nome è specificato nell'attributo name. Tale modulo deve essere ovviamente accessibile e visibile da parte dell'utente, che può altresì specificare attributi in grado di definirne layout e posizione.

Modules: questo elemento include tutti i moduli associati alla posizione specificata dall'attributo name. Come per il caso Module gli elementi devono essere accessibili all'utente che può modificarne (tramite ulteriori parametri) layout e posizione.

L'attributo opzionale style è disponibile solamente per i tipi Module e Modules. Viene utilizzato per gestire lo stile nel rendering dei vari moduli assegnati ad una specifica posizione.
I valori sono i seguenti:
table: equivalente allo stile 0 della versione 1.0.0 di joomla;
horz: equivalente allo stile 1 della versione 1.0.0 di joomla;
xhtml: genera un div contenitore per il modulo con un titolo in h3;
rounded: genera div annidiati che riprendono le funzionalità dello stile -3 della versione 1.0.0 di joomla.

Ecco qui di seguito un esempio per richiamare i moduli nella posizione "user2" in stile xhtml, sia nella versione 1.0.0 di joomla (riga 1) che in quella 1.5 (riga 3).

<?php mosLoadModules ( ‘user2’, -2 ); ?>

<jdoc:include type=”modules” name=”user2” style=”xhtml” />

Ultimo aggiornamento ( sabato 04 ottobre 2008 )
 
< Prec.   Pros. >
spacer.png, 0 kB
spacer.png, 0 kB
spacer.png, 0 kB