Templeet pas à pas

VII. Les variables

Les variables sont des zones avec des noms et qui contiennent des valeurs. Certaines variables sont positionnées par un ordre dans un template, les autres sont positionnées automatiquement par Templeet et peuvent être lues en vue de modifier le comportement des templates.

Les variables utilisateur

Ces variables sont en général positionnées dans les templates à l'aide de la fonction ~set() et lues à l'aide de la fonction ~get(). La portée de ces variables est le template en cours d'évaluation, c'est à dire qu'il n'est pas possible de faire un set dans une page et un get dans une autre page.

Habituellement ce système est utilisé pour stocker des valeurs que l'on veut réutiliser plus tard.

~set('mavariable', 'je suis un test')		

~get('mavariable')				=>	je suis un test

Il existe également des variables qui sont positionnées par Templeet et qui contiennent diverses informations qui peuvent être utiles pour le traitement du template:

• path : chemin qui correspond à l'URL demandé.
• template : template utilisé.
• actual_template : template en cours d'interprétation (en cas d'include)
• lang : langue du template en cours de traitement.
• templatedir : répertoire du template.
• errorLog : message d'erreur à la suite de l'appel de certaines fonctions.
• HTTP-Content-type : type MIME à renvoyer lors de l'évaluation du template.
• HTTP-charset : charset à renvoyer lors de l'évaluation du template.

~get('path')		  =>  templeet_tutorial/var.fr.html
~get('template')		  =>  template/templeet_tutorial/$html.tmpl
~get('lang')		  =>  fr  
~get('templatedir')	  =>  
~get('HTTP-Content-type')	  =>  text/html
~get('HTTP-charset')	  =>  

Les variables GET et POST

Ces variables sont positionnées à l'appel de la page. Elles se trouvent soit passées en paramètre lorsque l'appel à la page est fait avec la méthode GET soit au niveau de la requête HTTP si il s'agit d'un appel par la méthode POST. La méthode POST est utilisée lors de l'appel de formulaires.
Les trois fonctions permettant de récupérer ces valeurs sont :

• ~getget('variable') : récupère une variable passée par la méthode GET
• ~getpost('variable') : récupère une variable passée par la méthode POST
• ~getfile('variable') : récupère un fichier (uniquement en méthode POST)

un faisant un appel a:
http://www.templeet.org/test.html?mavariable=mavaleur

on aura comme résultat:

~getget('mavariable')		   =>  mavaleur

Les variables de configuration de Templeet

La fonction getconf permet de connaître la configuration de Templeet. Les principales variables utilisables sont:

• snapshotid : version de Templeet
• error404used : utilisation du système d'erreur 404
• usepagecache : utilisation du cache de page
• usetemplatecache :utilisation du cache de template
• default_language : langue par défaut de Templeet
• site_url : adresse du site
• dir_installed : répertoire où est installé Templeet
• windows : positionné à un sur une machine sous windows
• emailadmin : adresse email de l'administrateur Templeet (voir la partie authentification)

~getconf('snapshotid')		 => 200712291115
~getconf('error404used')		 => 1
~getconf('usepagecache')		 => 1
~getconf('usetemplatecache')	 => 1       
~getconf('default_language')	 => en
~getconf('site_url')		 => http://www.templeet.org
~getconf('dir_installed')		 => /
~getconf('windows')		 => 0
~getconf('emailadmin')		 => 

Les variables PHP

D'autres fonctions Templeet servent à récupérer des variables gérées par PHP:

• ~getserver() pour les variables $_SERVER
• ~getenvironment() pour les variables $_ENV
• ~getsession() pour les variables $_SESSION
• ~getcookie() pour les variables $_COOKIE