Vous savez maintenant qu'il y a une étape de plus dans le traitement des thèmes avec Dotclear 2. Avant d'aller plus loin dans les explications sur ces fameuses balises template dont je vous parlais précédemment (voir ce billet), deux petites remarques :

  • Pas la peine de mettre des instructions en PHP dans les fichiers du thème vu qu'elles sont supprimées par Dotclear 2 lors du traitement.[1].
  • Les commentaires HTML ayant la forme <!-- # … --> — notez le # au début — seront également supprimés pendant le traitement. Ce qui veut dire que vous pouvez — c'est même fortement conseillé — commenter à loisir toutes les modifications que vous ferez sans pour cela surcharger la page qui résultera du traitement.

Un exemple étant plus parlant, voilà un exemple de fichier HTML :

<div id="intro">

<!-- # Affichage du résultat d'un appel de fonction PHP -->
<?php echo dcMyTemplate::myFunction(); ?>

<!-- Debut du bloc -->
<p>Lorem Ipsum …</p>
</div>

Et voilà ce qu'il en ressortira une fois passé dans les fourches caudines de Dotclear 2 :

<div id="intro">
 
 
 

<!-- Debut du bloc -->
<p>Lorem Ipsum …</p>
</div>

Les lignes 3 et 4 qui contenaient respectivement un commentaire masquable (avec le # au début) et du code PHP ont été supprimées. Vous remarquerez que le commentaire de la ligne 6 est resté tel quel et qu'il sera donc visible dans le code HTML final de la page.

Notes

[1] Bien sûr il y a un moyen de désactiver ceci, ce qui permettra l'interprétation du code par le serveur, mais cela reste spécifique à votre installation et n'est en aucun cas la configuration standard. Il est donc illusoire de vouloir distribuer un thème nécessitant ce changement de configuration.