Joomla! Documentation™

Structure traditionnelle d'un répertoire de template

Les templates pour le CMS Joomla! utilisent habituellement une structure traditionnelle de répertoires et de fichiers, mais cette structure peut varier d'un template à l'autre.

• Les templates de Site (ou de "frontend", sont les templates qui permettent de modifier l'affichage de votre site web) se trouvent dans le répertoire /templates. Par exemple, si votre template se nomme "montemplate", il sera alors placé dans le dossier :

<chemin-vers-Joomla!>/templates/montemplate

• Les templates d' Administration (ou de "backend", sont les templates qui permettent de modifier l'affichage de l'administration du site) se trouvent dans le répertoire /administrator/templates. Par exemple, si votre template d'administration se nomme "montemplateadministration", il sera alors placé dans le dossier :

<chemin-vers-Joomla!>/administrator/templates/montemplateadmin

Répertoires de template

Un template typique pour Joomla! comprendra les répertoires suivants :

• css - contient tous les fichiers .css
• html - contient les fichiers de substitution de template (override) pour les rendus du template et du module chrome
• images - contient toutes les images utilisées par le template
• language - contient les fichiers langues supplémentaires utilisés par le template

En fonction de la complexité et de la conception du template, il peut également contenir le dossier :

• javascript - contient le JavaScript utilisé par le template afin d'ajouter certaines fonctionnalités

Exemple de structure de fichiers

Le chemin normal d'un template est <root>/public_html/nom-de-domaine/template/<nom de votre template> qui va contenir, en fonction des spécificités de votre template, les répertoires et les fichiers suivants :

/css
/html
/images
/javascript
/language
component.php
error.php
favicon.ico
index.php
templateDetails.xml
template_preview.png
template_thumbnail.png 

Les fichiers de template

Un template comprend généralement au minimum les fichiers suivants :

• index.php

Fournit la logique pour l'affichage et le positionnement des modules et composants.

• component.php

Fournit la logique pour l'affichage de "imprimer la page", "Envoyer à un ami." etc.

• error.php

Fournit une méthode pour gérer le erreurs, comme les erreurs 404, page non trouvée.

• favicon.ico

fichier du favicon

• template.css

Gère les aspects de présentation du template, y compris les spécifications de marges, polices, entêtes, bordures des images, mise en forme des listes, etc. Les fichiers .css peuvent également être situés dans le répertoire /css.

• templateDetails.xml

Contient les méta-informations liées au template et est utilisé par l'Installateur et le Gestionnaire de Template.

• template_preview.ext - remplacer .ext avec le format d'extension de l'image (.jpg, .png, .gif)

Généralement, une image de 600px x 400px qui s'affiche lorsque l'on clique sur la miniature située dans Gestion des templates  : Templates et non pas dans Gestion des templates : Styles. Cela ouvre une fenêtre en pop-up permettant à l'Administrateur de visualiser le template avant de l'appliquer au site.

• template_thumbnail.ext - remplacer .ext avec le format d'extension de l'image (.jpg, .png, .gif)

Généralement, une miniature de 200px x 150px qui s'affiche sur la liste de Template dans Gestion des templates :Templates, et non pas dans Gestion des templates : Styles . Cela permet à l'Administrateur de visualiser une vue miniature du template avant de l'appliquer au site.