Quel est la structure traditionnelle d'un répertoire de template ?

From Joomla! Documentation

This page is a translated version of the page What is the typical template directory structure? and the translation is 100% complete.

Other languages:
català • ‎Deutsch • ‎English • ‎español • ‎فارسی • ‎français • ‎Nederlands • ‎português do Brasil

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.