Les commentaires dans Smarty sont entourés d’astérisques, et entourés par les délimiteurs de cette façon :

{* Je suis un commentaire Smarty, je n’existe pas dans la sortie compilée.*}

Les balises <!– commentaire html –> peuvent griser aussi vos éléments smarty mais le contenu sera tout de même interprété donc n’est pas commenté pour smarty.

Attention ! vous ne pouvez pas imbriquer des commentaires.

Les fonctions :

Il existe deux types de fonctions en Smarty, les fonctions natives et les fonctions utilisateurs.

Les fonctions natives sont relatives au traitement interne de Smarty comme {if}, {section}, {literal}

Un exemple avec {literal}

Les balises {literal} permettent à un bloc de données d’être pris tel quel, sans qu’il ne soit interprété par Smarty. Notamment pour les éléments javascript, css, les accolades.

{literal}
	<style type= «text/css »>
		.madIdea{
			border :3px outset #ffffff ;
			margin : 2 3 4 5 px ;
			background-color : #001122 ;
			width :400px ;
	}
	</style>
	<style language=  « JavaScript » type= « text/javascript »>
		function myJsFunction(name, ip){
			alert(« Le nom du serveur \n » + name + « \n » + ip) ;
	}
	</style>
{/literal}

Un exemple avec {foreach}

Imaginons que vous vouliez récupérer le contenu d’un ou plusieurs champs dans une table via une requête.

 {foreach from=$aResultatRequete itemp=InfosTable}
   {$InfosTable.NomColonne}
{/foreach}

Un exemple avec {if}

L’instruction {if} dans Smarty dispose de la même flexibilité que l’instruction PHP if. Toutes les conditions et fonctions PHP sont reconnues, comme ||, or, &&, and, is_array(), etc.

{if $name eq ‘Eric’}
    Bienvenue, Monsieur.
{elseif $name eq ‘Ghyslaine’}
    Bienvenue m’dame.
{else}
  Bienvenue, qui que vous soyez.
{/if}

Les fonctions utilisateurs sont des fonctions additionnelles, implémentées par l’intermédiaire de plugins. Exemples de fonctions utilisateurs {html_options} {html_image}{cycle}

Un exemple avec {html_image}

{html_image file=’image.jpg’}
{html_image file=’/path/from/docroot/image.jpg}

En sortie vous aurez une affichage de votre image.

Un exemple avec {cycle}

Nous assignons le tableau dans le fichier php.

//1. Création et affectation d’un tableau indexé
 $mon_tableau_indexe = array(« Jean-Luc », « Jean », « Sylvain » , «  Eric ») ;

//2. Recencement dans smarty
$oSmarty->assign(« smarty_mon_tableau_indexe », $mon_tableau_indexe) ;

//3. Affichage du template après passage de l’objet
$oSmarty->display(« TestSmarty.tpl ») ;

Nous bouclons dans le fichier tpl pour l’affichage.

{foreach from=$smarty_mon_tableau_indexe item=item}
   <li style=”background-color:{cycle values=”#999999,grey”}; width:100px;”>{$item}{/li}
{/foreach}

Et enfin, l’affichage dans le navigateur.

smarty

Variable réservée

La variable PHP réservée {$smarty} peut être utilisée pour accéder à plusieurs variables d’environnements.

Un exemple précis où vous voulez obtenir le total d’un ensemble d’éléments.

{foreach from=$aResultatRequete name=nbproduct item=product}
       {if $smarty.foreach.nbproduct.last}
           {$smarty.foreach.nbproduct.total}
          <input type="hidden" name="nbproduct" id="nbproduct"  value="{$smarty.foreach.nbproduct.total}" />
       {/if}
{/foreach}

Modificateurs de variables

Nous avons parfois besoin de modifier directement nos variables dans smarty. Il est donc indispensable d’en connaître quelques modificateurs de variables.

Voici quelques uns :

upper pour mettre notre variable en majuscule
{$variable|upper}

lower pour mettre notre variable en miniscule
{$variable|lower}

Il y a d’autres modificateurs de variables mais les plus fréquents utilisés sont ceux affichés ci-dessus.

Accéder aux variables globales

Nous allons voir ici comment accéder aux constantes smarty très simplement.

Les constantes

Nous avons définis une constante comme ceci :

 define('WEB',           'http://www.waanser.com');

Pour accéder à cette session avec smarty il faut faire appel à {$smarty.const.[nom de la constante]}

cela donne :

{$smarty.const.WEB}

Accéder aux sessions

Pour accéder aux sessions c’est un peu près la même méthode :

$_SESSION['waanser']['url']='www.waanser.com';

En smarty on y accède comme cela :

$smarty.session. waanser. url

Les tableaux et smarty

Vous l’avez certainement remarqué avec les sessions, l’accès aux données du tableau ce fait avec le point.

$aEcole =
	array('2007'=>
			array(
				'CM2' => array('Marc', 'Maude', 'Sophie'),
				'CM1' => array('Roul', 'Tilkc', 'Pauline')
				),
			'2008'=>
			array(
				'CM2' => array('Roul', 'Tilkc', 'Pauline'),
				'CM1' => array('Henry', 'Manon', 'Dedeweb','Laure')
				)
			);

Dans cet exemple, si l’on veut accéder aux deuxième élève de la classe de CM2 à l’année 2008 on va saisir :

{$aEcole.2008.CM2.1}

Parcourir un tableau avec la boucle foreach

Pour parcourir ce tableau nous allons utiliser la fonction foreach de smarty.

{foreach from=NOM DU TABLEAU item=INDICE key=CLE}

L’attribut item et key ne sont pas obligatoires.

Ci-dessous l’exemple de code qui parcourt tout le tableau aEcole :

{foreach from=$aEcole item=aAnnee key=sAnnee}
	{$sAnnee} : <br/>
	{foreach from=$aAnnee item=aClasse key=sClasse}
	<ul><li>{$sClasse}
		{foreach from=$aClasse item=sEleve}
			<ul><li>{$sEleve}</li></ul>
		{/foreach}
	</li></ul>
	{/foreach}
{/foreach}

Un compteur avec smarty

Si vous avez besoin de mettre un compteur dans votre page, smarty offre la possibilité d’utiliser des compteurs avec la fonction {counter}

{counter name=NOM DU COMPTEUR start=POSITION DE DEPART skip=INCREMENT assign=VARIABLE ASSIGNE}

Dans notre exemple, nous allons afficher le nombre d’élève pour chaque classe.

{foreach from=$aEcole item=aAnnee key=sAnnee}
	{$sAnnee} : <br/>
	{foreach from=$aAnnee item=aClasse key=sClasse}
	<ul><li>{$sClasse}
	{counter name=cCompt start=0 skip=1 assign=iNbEleve}
		{foreach from=$aClasse item=sEleve}
			{counter name=cCompt}
			<ul><li>{$sEleve}</li></ul>
		{/foreach}
		<ul>nombre d'élève : {$iNbEleve}</ul>
	</li></ul>
	{/foreach}
{/foreach}

Comme vous le voyez à chaque fois que l’on fait appel à {counter name=cCompt} le compteur va s’incrémenter de 1.

Voila, vous connaissez les fonctions essentielles de smarty.

Il nous permet de respecter une partie du model MVC : grace a Smarty on sépare bien le php du html.

En plus de cette séparation, la compréhension du code Html seul est largement plus facile a lire, et le langage smarty n’a rien de compliquer

(d’autres article pour plus de détails)

Téléchargement de Smarty

Rendez-vous sur le site de Smarty et télécharger la dernière version stable.

Installation de Smarty

Copier – Coller le dossier Smarty-x.x.xx dans le dossier www de votre serveur apache.

Allez dans le dossier Smarty-x.x.xx/libs, nous allons regarder la classe « Smarty.class.php »

Nous ne rentrons dans les détails de fonctionnement, ce sont les attributs qui nous intéressent :

- $template_dir => pointe vers le dossier qui va contenir tous vos templates   » .tpl »
- $compile_dir  => pointe vers le dossier qui va contenir vos templates compilés.
- $config_dir     => pointe vers le dossier de configuration (perso je m’en sers jamais)

- $plugins_dir    => Les plugins sont des script qui s’executent directement dans smarty, par defaut ils en existent mais vous pourrez créer les votres.
- $cache_dir       => pointe vers le dossier de cache des templates.

Ici tous les chemins sont configurés pour tester a la racine, par la suite rien ne vous empéche de modifier vos chemins suivant l’architecture de votre site.

Exemple : Principe de base

Créer le dossier TestSmarty dans Smarty-x.x.xx.
Ensuite créer les répertoires templates, et templates_c ainsi que le fichier index.php

Dans le fichier index.php

<?php
require '../libs/Smarty.class.php';

$smarty = new Smarty;
$smarty->assign("titre","test template Smarty");
$smarty->assign("name", 'Roul');

$smarty->display('index.tpl');

?>

dans le dossier templates on va créer le fichier index.tpl, puisqu’on l’appel au dessus.

<html>
<head>
<title>{$titre}</titre>
</head>
<body>
<p>Bienvenue {$name}</p>
</body>
</html>

Le résultat maintenant est magique :

Résultat Template Smarty