Bonsoir à tous,
Voici un morceau de doc que j'ai complètement zappé, que je pensais avoir mis dans "Débutons !". Enfin bref, je répare mon erreur !
Ici, on verra comment on assigne un template au moteur, et comment on en inclue un dans un... template.
Coté PHP
Changer de dossier
Si vous désirez changer votre root de tpl (et / ou de cache), il y a une méthode pour, qui prend exactement les mêmes arguments que le constructeur (cf "
Débutons !"), sans compter la dépendance.
Si vous ne souhaitez modifier qu'un des deux dossiers, vous pouvez utiliser les getters pour récupérer la valeur du dossier root ou bien du dossier cache. Ainsi, vous pouvez utiliser cette fonction de plusieurs facons :
Code PHP
<?php
// ...
$tpl->dir('./tpl/', './cache/tpl/'); // -- Façon classique
$tpl->dir('./tpl/', Talus_TPL_Cache::dir()); // -- On ne souhaite changer que le root
$tpl->dir($tpl->root(), './cache/tpl/'); // -- On ne souhaite changer que le cache
?>
Coté TPL
Les inclusions
Au niveau PHP, pour les inclusions, il n'y a rien à faire. Mais au coté TPL, elles sont repérées par la balise "<include>". Celle ci prend deux paramètres : tpl, pour indiquer le tpl toujours par rapport au root défini par le constructeur. Ce paramètre prend une valeur de type string (et finit par un .html) ou variable ({$FILE}). Il y a un deuxième paramètre, optionnel : once, qui permet de demander à ce que le fichier puisse être inclut... une ou plusieurs fois (sur le même principe que require_once et include_once par exemple). Ce paramètre prend true / false comme valeur (false par défaut).
Code TPL
<include tpl="inclus.html" />
<include tpl="{$MON_FICHIER_A_INCLURE}" />
<include tpl="inclusion.html" once="false" />
<include tpl="fichier_inclus.html" once="true" />
Vous pouvez aussi demander d'inclure un tpl, et que si celui-ci n'existe pas, l'execution du script soit immédiatement arrêtée (à la manière d'un require de php), qui prend les mêmes paramètres :
Code TPL
<require tpl="inclus.html" />
<require tpl="{$MON_FICHIER_A_INCLURE}" />
<require tpl="inclusion.html" once="false" />
<require tpl="fichier_inclus.html" once="true" />
Une exception de type Talus_TPL_Runtime_Exception sera jetée (et arretera le script) pour un require si le fichier n'existe pas.
Et enfin, pour ces deux balises, vous pouvez aussi spécifier des paramètres : ce seront des variables définies uniquement dans le cadre du template inclut (et de sa descendance), et seront détruites juste après l'execution du template :
Code TPL
<include tpl="inclut.html?FOO=str&BAR=4&TRUC={$VAR}" />
Ainsi, les variables {FOO} et {BAR} seront accessibles dans le templates inclus et ceux qu'il inclue, mais pas dans le template qui a inclu inclut.html. Les autres varibales normalement déclarées (prenons {VAR} par exemple) seront également accessible. Ceci remplace les fonctions tpl introduites dans la version 1.2.0 et dépréciées en 1.7.0.
Sommaire : Aborder la Doc'
Chapitre Précédent : Les Namespaces XML
Chapitre Suivant : Les Variables
Home
» Talus' Works » Talus' TPL » Documentation » Les Templates » Lecture du Sujet » Page 1 
#1 - Le 06/02/2008, à 23:42
