Cette page est destinée à la personnalisation ou la création de thèmes. Si vous cherchez des thèmes déjà réalisés, référez-vous à la documentation Habillage du blog.
Chaque thème est un ensemble de fichiers rangés dans un sous répertoire de /themes sur votre installation Dotclear. Ce sont ces fichiers qui, une fois interprétés par le moteur de template, vont produire les pages HTML en façade de votre blog. Vous trouverez ci-dessous le détail des différents fichiers
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.
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.
Ces fichiers sont rangés dans un sous-répertoire tpl, dans le répertoire du thème.
Note :
Il est possible que certains thèmes ayant été conçus avant la version RC1 ne suivent pas cette organisation. Il suffit alors de créer le répertoire tpl et d'y mettre les fichiers .html pour que le thème fonctionne correctement.Ils seront appelés en fonction du contexte de la page dont on demande l'affichage
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.
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.
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.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 :
Outre le code xhtml, les fichiers template de Dotclear utilisent une syntaxe spécifique pour appeler des fonctions de traitement et/ou d'affichage. Ces « tags » ainsi que leurs attributs sont listés et décrits dans cette section. La création d'une balise template est expliquée dans cette autre section.