Template Joomla Arborescence minimum

Appréciation moyenne:  / 10
Très mauvaisTrès bien 

Connaitre l'arborescence minimum d'un template Joomla

Les templates Joomla sont situés dans le dossier templates à la racine du site.

Chaque template est installé dans son propre dossier, sous templates.

Pour cet exemple, nous allons créer un dossier nommé etude-template, sous le dossier templates.

Pour le moment il est vide.

Munissez-vous de votre identifiant et de votre pass pour accéder à l'interface d'administration de votre site joomla, puis allez directement via le menu "Extensions" dans la "gestion des templates", onglet "Site".

Pour le moment on ne voit rien de plus qu'avant.

L'arborescence minimum, si on veut faire simple, va être simple:

il suffit de créer un fichier nommé index.php dans ce dossier et on a déjà une bonne base :-)

Pour que le template d'étude apparaisse dans l'interface de gestion (pour pouvoir le sélectionner et voir les résultats), il faut aussi créer un fichier nommé templatesDetails.xml.

Contenu minimum du fichier templateDetails.xml:



<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://dev.joomla.org/xml/1.5/template-install.dtd">
<install version="1.5" type="template">
	<name>Etude Template</name>
	<files>
		<filename>index.php</filename>
	</files>
</install>

adapter le name à votre convenance.

Voilà, une fois les modifs enregistrées, rafraichissez l'affichage de la liste des templates disponibles dans l'admin de joomla (un click sur l'onglet administration puis un autre sur l'onglet site et c'est rafraichi).

On peut maintenant sélectionner ce nouveau template pour en faire le template par défaut, mais comme on n'a rien mis dans le second fichier, index.php, il ne va pas se passer grand-chose...

Restons donc encore un peu sur le fichier templateDetails.xml, pour voir un contenu un peu plus complet et plus conforme à Joomla:



<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://dev.joomla.org/xml/1.5/template-install.dtd">
<install version="1.5" type="template">
	<name>Etude Template</name>
	<creationDate>01/07/2009</creationDate>
	<author>Tranquille</author>
	<authorEmail>webmaster-arobase-tranquille-informatique.fr</authorEmail>
	<authorUrl>http://www.tranquille-informatique.fr</authorUrl>
	<copyright>Tranquille Informatique</copyright>
	<license>GNU/GPL</license>
	<version>1.0.0</version>
	<description>Etude de l'arborescence minimum d'un template Joomla 1.5</description>
	<files>
		<filename>index.php</filename>
	</files>
</install>

Voilà, je vous laisse étudier les choses rajoutées et les adapter...

Passons maintenant à la suite:

Le fichier index.php du template

Pour étudier le contenu de ce fichier primordial, nous allons y aller petit à petit.

C'est ce fichier qui va définir l'aspect de votre site au final, la disposition des différents élements, des balises d'entête etc.

Voici un premier jet:



<?php
/**
 * @copyright	Copyright (C) 2005 - 2008 Tr@nquille Informatique. Tous droits réservés.
 * @license		GNU/GPL
 */

// no direct access
defined( '_JEXEC' ) or die( 'Restricted access' );
?>
 <!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>
  </head>
  <body>
  </body>
</html>

J'ai mis en valeur la ligne 8 car elle est importante. C'est grâce à elle que personne ne pourra accéder directement à cette page sans passer par la structure normale de Joomla (le fichier index.php de la racine du site joomla).

Ensuite on définit le doctype, celui qui est mis sur d'autres templates ira très bien...

Le language est défini en fonction du language choisi dans l'admin de jommla.

Et puis on a une petite structure html basique, qui ne fera rien du tout.

Normalement, on a du sélectionner le template en cours comme "default", ce qui permet, en accédant à la page d'accueil de notre site, d'apercevoir le résultat de notre template minimum:

une belle page blanche, et un code source sommaire.

Les balises head du template:

 Allons-y pour rajouter dans notre fichier index.php les balises head de la page html qui encapsulera les contenu de tous les articles du site.

 Nous complétons notre fichier entre les balises head comme ceci:



<head>
  	<jdoc:include type="head" />
</head>

Je vous laisse enregistrer ces modifs et rafraichir la page d'accueil du site, puis aller voir le code source pour s'apercevoir que maintenant notre site est un peu plus bavard.

Les infos rajoutées là sont prises dans la configuration du site, faite à travers l'interface d'admin de joomla... 

 

(à suivre, en cours de rédaction)