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] Si vous avez besoin de fonctions particulières en PHP pour obtenir ce que vous souhaitez, c'est prévu dans DotClear 2 et je vous en dirai rapidement comment le faire.
- 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 :
1. <div id="intro"> 2. 3. <!-- # Affichage du résultat d'un appel de fonction PHP --> 4. <?php echo dcMyTemplate::myFunction(); ?> 5. 6. <!-- Debut du bloc --> 7. <p>Lorem Ipsum …</p> 8. </div>
Et voilà ce qu'il en ressortira une fois passé dans les fourches caudines de DotClear 2 :
1. <div id="intro"> 2. 3. 4. 5. 6. <!-- Debut du bloc --> 7. <p>Lorem Ipsum …</p> 8. </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.
1 De Lo -
J'adore quand tu nous expliques dotclear! Avec toi et notre Fée, ça ne devient pas plus compliquer qu'un jeu de Légo!!!
2 De Franck -
J'adore ce genre de compliment !
3 De mirovinben -
Ben voilà la réponse que j'attendais à ma question (*) posée sur le forum de dotclear : comment ne pas afficher un commentaire dans le source de la page envoyée à l'internaute...
(*) http://www.dotclear.net/forum/viewtopic.php?id=27130
Alléluia ! Vivement la suite... :)
4 De Franck -
J'avais zappé la question sur le forum désolé !
5 De mirovinben -
@Franck Désolé ? ben non... vu que tu m'as donné la réponse ici :) Et une réponse claire, argumentée qui devrait faire le bonheur de plein de dotclearien(ne)s
A ce propos : tes explications pourront-elles être intégrées dans la doc officielle ?
6 De Franck -
D'une manière ou d'une autre éventuellement ou bien encore chez Mme la fée, je pense entre autres à son dcTips().
7 De Sou. -
Je me joins aux "complimenteurs" : c'est d'une clarté exemplaire !
Petite question d'un gars pas encore concerné par DC2 (et peut-être jamais), mais pour faire avancer le schmilimili... :
Est-ce que ces traitements (interprétations, suppressions) opérés par le moteur de DC2 "ralentissent" l'affichage des pages ? Ou au contraire l'accélèrent ?
8 De Franck -
Je vais répondre oui et non ! Oui la première fois où le traitement est nécessaire, non toutes les fois suivantes jusqu'au jour où le thème est modifié !
La raison est que DC 2 stocke le résultat de ce traitement dans un répertoire temporaire (cache) et qu'il réutilise ces résultats si possible.
9 De Pierro -
Si vous avez besoin de fonctions particulières en PHP pour obtenir ce que vous souhaitez, c'est prévu dans DotClear 2 et je vous en dirai rapidement comment le faire.
Peux-tu nous en dire plus à ce sujet ? Je n'arrive pas à comprendre comment rajouter du php dans mes pages !!
Merci pour tout ce boulot !
10 De Franck -
Bien sûr mais il va falloir patienter un tout petit peu — week-end prolongé oblige.
11 De Denis -
Bon moi j'utilise dotclear pour ma web mais au lieu de l'image qui aparait j'aimerais un peu plus de mouvement (échange d'image ? ) bien sûr ! un peu plus de vie quoi et pourquoi pas un panneaux de control (panel control) pour dotclear je sait qu'il en a un ... mais je le trouve pas si performant tu ne peut pas changer le fond des comentaires! tu ne peut pas editer les couleurs il faut vraiment que tu possede la connaissance en fin !
12 De Franck -
Pour les couleurs il faut modifier la feuille de style (fichier
style.cssdu thème).