Il file index.php
È il file più importante, indica la posizione dei vari moduli e la locazione del foglio di stile. Proprio per la sua importanza, è definito come lo scheletro del sito. Deve iniziare con questo codice:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" > <head> <jdoc:include type="head" /> </head>
Queste righe servono per impostare il linguaggio e per inserire nell'header le informazioni sul sito (come il titolo, la descrizione, i meta tag etc etc) che sono state inserite nel backend, più precisamente in Configurazione globale-->Sito-->Configurazione sito e Configurazione Metadata, come possiamo vedere dalla figura.
Configurazione Metadata
Poi dobbiamo inserire la parte di html riguardante il corpo del testo, come qui:
<body> <jdoc:include type="component" /> </body> </html>
Questa riga di codice serve per inserire il contenuto principale nella pagina, per esempio gli articoli o una galleria di foto.
Il codice sopra descritto però non contiene tutte le posizioni per i diversi moduli, vediamo allora come fare. In generale basta inserire nel tag div che vogliamo la riga di codice per l'inserimento di tutti i moduli che vanno pubblicati nella stessa posizione, per esempio:
<div id="header">
<jdoc:include type="modules" name="top" />
</div>
significa che in quel punto della pagina sono pubblicati tutti i moduli a cui è stata assegnata la posizione top nella gestione dei moduli. In tal caso potremo avere uno schema di questo genere
Header e Content
A questo punto il file index.php diventa così:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
</head>
<body>
<div id="container">
<div id="header">
<jdoc:include type="modules" name="top" />
</div>
<div id="sidebar_left" class="float">
<jdoc:include type="modules" name="left"/>
</div>
<div id="content" class="float">
<jdoc:include type="component" />
</div>
<div id="sidebar_right"class="float">
<jdoc:include type="modules" name="right"/>
</div>
<div id="footer" class="clear">
<jdoc:include type="modules" name="footer" />
</div>
</div>
</body>
</html>
Osservazione: consiglio di inserire nel file index.php prima della riga
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
anche la riga di codice:
<?php defined( '_JEXEC' ) or die( 'Restricted access' );?>
per la sicurezza del sito.