Organisation des fichiers
La fiche d’identité du thème
Nommé _define.php ce fichier accueille le nom du thème, sa description, son auteur et son numéro de version. Rédigez-le de préférence en anglais en suivant le même schéma que pour un plugin.
Capture d’écran du thème
Si le répertoire du thème contient un fichier appelé screenshot.jpg, cette image sera affichée sur la page de sélection du thème. Elle permet d’avoir un aperçu du thème. L’image doit mesurer 280 pixels en largeur et 245 pixels en hauteur.
Les fichiers templates ou de « contexte »
Ces fichiers sont rangés dans un sous-répertoire tpl, dans le répertoire du thème. Ils seront appelés en fonction du contexte de la page dont on demande l’affichage
-
home.html : liste tous les billets publiés (par défaut, du plus récent au plus ancien)
-
post.html : affiche le contenu d’un billet (avec ses commentaires, notes, pièces jointes, rétroliens)
-
category.html : liste tous les billets d’une catégorie ou d’une sous-catégorie
-
archive.html : liste les mois comportant des billets
-
archive_month.html : liste tous les billets d’un mois
-
tags.html : liste de tous les tags saisis
-
tag.html : liste tous les billets d’un tag
-
search.html : liste tous les billets après une requête de recherche
-
404.html : la page appelée en cas d’erreur
Chaque plugin créant un autre contexte doit prévoir son propre fichier .html. C’est le cas pour ceux par exemple des plugins dayMode et contactMe.
Les fichiers inclus dans les « fichiers de contexte »
Certains éléments sont récurrents, autant les faire une bonne fois pour toutes et les inclure dans la page de contexte qui nous intéresse. Ce sont les fichiers dont le nom est précédé d’un underscore. Exemple _footer.html.
-
_head.html : l’appel des feuilles de style et des scripts jQuery
-
_top.html : l’entête du blog
-
_footer.html : le pied de page
-
_flv_player.html : le lecteur de vidéo
-
_mp3_player.html : le lecteur mp3
Astuce :
Une class spécifique est attribuée à la balise <body> pour chaque fichier contexte ; on peut donc très facilement modifier la présentation d’un contexte spécifique à l’aide de cette class.Astuce :
Rien n’empêche de retirer l’appel à un fichier inclus pour placer directement dans tel ou tel contexte un contenu qu’on voudrait différent uniquement pour ce contexte. - rien n’empêche non plus de créer un fichier _pouetpouet.html à inclure dans les fichiers contexte pour un élément que vous voudriez récurrent.Ordre de lecture des fichiers
Le moteur va chercher le fichier dont il a besoin d’abord dans le répertoire du thème désigné par l’utilisateur. S’il ne s’y trouve pas, il ira piocher dans le répertoire du thème par défaut.
Note :
Le cas des templates des flux Atom et RSS est un peu plus particulier. Ceux-ci sont situés dans le repertoire/dotclear/inc/public/default-templates/. Rien n’empêche bien sûr de les ajouter à son propre thème pour les remplacer.Deux choses en découlent :
-
si l’on ne veut modifier la structure que d’un contexte il suffit d’ajouter son fichier personnalisé dans le sous-répertoire tpl de son thème
-
il est inutile, voire contre-productif de créer un thème depuis la copie complète de tous les fichiers du thème par défaut.
Les balises de template
Les fichiers template de Dotclear utilisent une syntaxe spécifique pour appeler des fonctions de traitement et/ou d’affichage. Ces balises de template ainsi que leurs attributs sont détaillés dans la liste des balises de template. Vous pouvez être intéressé·e de découvrir aussi comment créer une balise de template.
