Toutes les balises Smarty sont entourées de délimiteurs. Par défaut, ces délimiteurs sont { et }, mais ils peuvent être modifiés. Pour ces exemples, nous supposons que vous utiliserez leur valeur par défaut. Dans Smarty, le contenu qui est situé en dehors des délimiteurs est affiché comme contenu statique, inchangé. Lorsque Smarty rencontre des balises de template, il tente de les comprendre et en affiche la sortie appropriée, en lieu et place. Les commentaires dans Smarty sont entourés d'asterisques, de cette façon : {* voici un commentaire *} Les commentaires Smarty ne sont pas affichés dans la sortie finale du template. Ils sont utilisés pour des notes internes, dans le template, pour aider les développeurs à en comprendre le fonctionnement. {* Smarty *} {* Inclusion de l'en tête *} {include file="header.tpl"} {include file=$includeFile} {include file=#includeFile#} {* affiche des listes déroulantes *} <SELECT name=company> {html_options values=$vals selected=$selected output=$output} </SELECT> Les balises Smarty affichent une variable ou invoquent une fonction. Les fonctions sont appelées lorsqu'elles sont entourées, ainsi que leurs paramètres, des délimiteurs Smarty. Par exemple : {nomfonction par1="val" par2="val"}. {config_load file="colors.conf"} {include file="header.tpl"} {if $name eq "Fred"} Vous êtes admis dans cette zone {else} Bienvenue, <font color="{#fontColor#}">{$name}!</font> {/if} {include file="footer.tpl"} Les fonctions natives et les fonctions utilisateurs ont toutes deux la même syntaxe, dans les templates. Les fonctions natives sont relatives au traitement interne de Smarty, comme par exemple if, section et strip. Elles ne peuvent être modifiées. Les fonctions utilisateurs sont des fonctions additionnelles, implémentées par l'intermédiaire de plugins. Elles peuvent être modifiées pour correspondre à vos besoins, et vous pouvez en créer de nouvelles. html_options et html_select_date sont deux exemples de fonctions utilisateurs. La plupart des fonctions attendent des paramètres qui régissent leur comportement. Les paramètres des fonctions Smarty sont très proches des attributs des balises HTML. Les valeurs numériques n'ont pas besoin d'être entourées par des guillemets, par contre, ces guillemets sont recommandées lors de l'utilisation de chaînes de caractères. Des variables peuvent aussi être utilisées en tant que paramètres, et ne doivent pas être entourées de guillemets. Certains paramètres requièrent des valeurs booléennes (true / false). Elles peuvent être spécifiées par l'une des valeures suivantes, sans guillemet: true, on, et yes, ou false, off, et no. {include file="header.tpl"} {include file=$includeFile} {include file=#includeFile#} {html_select_date display_days=yes} <SELECT name=company> {html_options values=$vals selected=$selected output=$output} </SELECT> Smarty est capable d'interpréter les variables insérées à l'intérieur de chaînes entre guillemets, du moment que leur nom est exclusivement composé de chiffres, lettres, underscores et crochets. Si le nom de la variable contient tout autre caractère (point, référence à un objet, etc.) la variable doit être entourée d'apostrophes inverses (`). EXEMPLE DE SYNTAXE: {func var="test $foo test"} <-- comprends $foo {func var="test $foo_bar test"} <-- comprends $foo_bar {func var="test $foo[0] test"} <-- comprends $foo[0] {func var="test $foo[bar] test"} <-- comprends $foo[bar] {func var="test $foo.bar test"} <-- comprends $foo (not $foo.bar) {func var="test `$foo.bar` test"} <-- comprends $foo.bar EXEMPLE PRATIQUE: {include file="subdir/$tpl_name.tpl"} <-- remplace $tpl_name avec la valeur {cycle values="one,two,`$smarty.config.myval`"} <-- doit comporter les apostrophes inverses Smarty possède différents types de variables. Le type de ces variables dépend du symbole qui les préfixe, ou des symboles qui les entourent. Les variables de Smarty peuvent être soit affichées directement, soit utilisées comme arguments pour les fonctions et modificateurs, à l'intérieur d'expressions conditionnelles, etc. Pour afficher une variable, il suffit de l'entourer par des délimiteurs de telle sorte qu'elle soit la seule chose qu'ils contiennent. Exemple : {$Nom} {$Contacts[enreg].Telephone} <body bgcolor="{#bgcolor#}"> Pour utiliser une variables assignées depuis PHP, il faut la préfixer par le symbole dollar $. Les variables asignées depuis un template grâce à la fonction assign sont manipulées de la même façon. Bienvenue {$prenom}, heureux de voir que tu es arrivé ici. <p> La dernière connexion remonte au {$dateConnexionPrecedente}. SORTIE: Bienvenue Doug, heureux de voir que tu est arrivé ici. <p> La dernière connexion remonte au 11 janvier 2001. Vous pouvez également utiliser des variables sous forme de tableaux associatifs assignées depuis PHP en en spécifiant la clef, après le symbole '.' (point). index.php: $smarty = new Smarty; $smarty->assign('Contacts', array('fax' => '555-222-9876', 'email' => 'zaphod@slartibartfast.com', 'phone' => array('home' => '555-444-3333', 'cell' => '555-111-1234'))); $smarty->display('index.tpl'); index.tpl: {$Contacts.fax}<br> {$Contacts.email}<br> {* you can print arrays of arrays as well *} {$Contacts.phone.home}<br> {$Contacts.phone.cell}<br> SORTIE: 555-222-9876<br> zaphod@slartibartfast.com<br> 555-444-3333<br> 555-111-1234<br> Vous pouvez utiliser des tableaux indexés de la même façon que vous le faites en PHP. index.php: $smarty = new Smarty; $smarty->assign('Contacts', array('555-222-9876', 'zaphod@slartibartfast.com', array('555-444-3333', '555-111-1234'))); $smarty->display('index.tpl'); index.tpl: {$Contacts[0]}<br> {$Contacts[1]}<br> {* you can print arrays of arrays as well *} {$Contacts[2][0]}<br> {$Contacts[2][1]}<br> SORTIE: 555-222-9876<br> zaphod@slartibartfast.com<br> 555-444-3333<br> 555-111-1234<br> Les attributs des objets assignés depuis PHP peuvent être utilisées en en spécifiant le nom après le symbole '->'. nom: {$person->name}<br> email: {$person->email}<br> SORTIE: nom: Zaphod Beeblebrox<br> email: zaphod@slartibartfast.com<br> Les variables récupérées depuis un fichier de configuration sont utilisées entourées du symbole dièse (#), ou via la variable spéciale smarty $smarty.config. foo.conf: pageTitle = "C'est le mien" bodyBgColor = "#eeeeee" tableBorderSize = "3" tableBgColor = "#bbbbbb" rowBgColor = "#cccccc" index.tpl: {config_load file="foo.conf"} <html> <title>{#pageTitle#}</title> <body bgcolor="{#bodyBgColor#}"> <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> <tr bgcolor="{#rowBgColor#}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> index.tpl: (alternate syntax) {config_load file="foo.conf"} <html> <title>{$smarty.config.pageTitle}</title> <body bgcolor="{$smarty.config.bodyBgColor}"> <table border="{$smarty.config.tableBorderSize}" bgcolor="{$smarty.config.tableBgColor}"> <tr bgcolor="{$smarty.config.rowBgColor}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> SORTIE: (same for both examples) <html> <title>C'est le mien</title> <body bgcolor="#eeeeee"> <table border="3" bgcolor="#bbbbbb"> <tr bgcolor="#cccccc"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> Les variables de fichier de configuration ne peuvent être utilisés tant qu'elles n'ont pas été chargées. Cette procédure est expliquée plus loin dans le document, voir config_load. La variable réservée {$smarty} peut être utilisée pour accéder à plusieurs variables spéciales du template. En voici la liste complète. Les variables de requête comme GET, POST, COOKIES, SERVER, ENVIRONNEMENT et SESSION peuvent être utilisées comme dans l'exemple suivant: {* Affiche la valeur de page dans l'url (GET) http://www.domain.com/index.php?page=foo *} {$smarty.get.page} {* affiche la variable "page" récupérée depuis un formulaire (POST) *} {$smarty.post.page} {* affiche la valeur du cookie "utilisateur" *} {$smarty.cookies.utilisateur} {* affiche la variable serveur "SERVER_NAME" *} {$smarty.server.SERVER_NAME} {* affiche la variable d'environnement "PATH" *} {$smarty.env.PATH} {* affiche la variable de session PHP "id" *} {$smarty.session.id} {* affiche la variable "utilisateur" du regroupement de get/post/cookies/server/env *} {$smarty.request.utilisateur} Le timestamp courant peut être récupéré grâce à {$smarty.now}. Le nombre obtenu correspond au nombre de secondes écoulées depuis Epoch (1 Janvier 1970) et peut être passé directement au modificateur de variable date à des fins d'affichage. {* utilise le modificateur de variable date_format pour afficher la date et heure *} {$smarty.now|date_format:"%d-%m-%Y %H:%M:%S"} Vous pouvez directement accéder aux constantes PHP. {$smarty.const._MA_CONSTANTE_} La capture réalisée via {capture}..{/capture} peut être récupérée par l'intermédiaire de la variable {$smarty}. Voir la section sur capture pour un exemple à ce sujet. La variable {$smarty} peut être utilisée pour désigner une variable d'un fichier de configuration. {$smarty.config.foo} est un synonyme de {#foo#}. Voir la section config_load pour un exemple à ce sujet. La variable {$smarty} peut être utilisée pour accéder aux propriétés des boucles 'section' et 'foreach'. Voir la documentation de section et foreach. Cette variable contient le nom du template en cours de traitement. Les modificateurs de variables peuvent être appliqués aux variables, fonctions utilisateurs ou chaînes de caractères. Pour appliquer un modificateur de variable, tappez une valeure suivie de | (pipe) et du nom du modificateur. Un modificateur de variable est succeptible d'accepter des paramètres additionnels, qui en affectent le comportement. Ces paramètres suivent le nom du modificateur et sont séparés par un : (deux points). {* Met le titre en majuscule *} <h2>{$title|upper}</h2> {* Tronque le sujet à 40 caractères, place des "..." à la fin *} Sujet: {$sujet|truncate:40:"..."} {* formatage en chaîne *} {"now"|date_format:"%Y/%m/%d"} {* application d'un modificateur à une fonction utilisateur *} {mailto|upper address="me@domain.dom"} Si vous appliquez un modificateur de variable à un tableau plutôt qu'à une variable simple, le modificateur sera appliqué à chaque valeur du tableau. Si vous souhaitez que le modificateur travaille réellement avec le tableau en tant que tel, vous devez préfixer le nom du modificateur avec un symbole @ comme ceci: {$titreArticle|@count} (Affiche le nombre d'élements du tableau $titreArticle.) Met la première lettre de chaque mot d'une variable en majuscule. index.php: $smarty = new Smarty; $smarty->assign('titreArticle', 'La police commence une campagne de sensibilisation contre la violence routière.'); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|capitalize} SORTIE: La police commence une campagne de sensibilisation contre la violence routière. La Police Commence Une Campagne De Sensibilisation Contre La Violence Routière. Compte le nombre de caractères dans une variable. index.php: $smarty = new Smarty; $smarty->assign('titreArticle', 'Vagues de froid liées à la température.'); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|count_characters} SORTIE: Vagues de froid liées à la température. 39 Position du paramètre Type Requis cat Description 1 chaîne de caractères Non empty Valeur à concaténer à la variable donnée. Cette valeur est concaténée à la variable donnée. index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', 'Les devins ont prévus que le monde existera toujours '); $smarty->display('index.tpl'); index.tpl: {$TitreArticle|cat:" demain."} SORTIE: Les devins ont prévus que le monde existera toujours demain. Compte le nombre de paragraphes dans une variable. index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', 'La guerre apporte la paix, au prix de la vie de certains innocents.'); $smarty->display('index.tpl'); index.tpl: {$TitreArticle} {$TitreArticle|count_paragraphs} SORTIE: La guerre apporte la paix, au prix de la vie des innocents. 1 Compte le nombre de phrases dans une variable. index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', 'Deux navires rentrent en collision - Un des deux coule. Des vaches enragées blessent un fermier à coups de haches.'); $smarty->display('index.tpl'); index.tpl: {$TitreArticle} {$TitreArticle|count_sentences} SORTIE: Deux navires rentrent en collision - Un des deux coule. Des vaches enragées blessent un fermier à coups de haches. 2 Compte le nombre de mots dans une variable. index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', 'Un anneau pour les gouverner tous.'); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|count_words} SORTIE: Un anneau pour les gouverner tous. 6 Position du paramètre Type Requis Defaut Description 1 chaîne de caractères Non %b %e, %Y Format de sortie de la date. 2 chaîne de caractères Non n/a Date par défaut si aucune n'est spécifiée en entrée. Formate une date / heure au format strftime donné. Les dates peuvent être passées à smarty en tant que timestamp unix, timestamp mysql ou comme chaîne quelconque contenant mois jour année (interprétable par strtotime). Les concepteurs de templates peuvent utiliser date_format pour contrôler parfaitement le format de sortie de la date. Si la date passée à date_format est vide, et qu'un second paramètre est donné, ce dernier sera utilisé comme étant la date à formater. index.php: $smarty = new Smarty; $smarty->assign('hier', strtotime('-1 day')); $smarty->display('index.tpl'); index.tpl: {$smarty.now|date_format} {$smarty.now|date_format:"%A, %B %e, %Y"} {$smarty.now|date_format:"%H:%M:%S"} {$hier|date_format} {$hier|date_format:"%A, %B %e, %Y"} {$hier|date_format:"%H:%M:%S"} SORTIE: Feb 6, 2001 Tuesday, February 6, 2001 14:33:00 Feb 5, 2001 Monday, February 5, 2001 14:33:00 %a - Abréviation du jour de la semaine, selon les paramètres locaux. %A - Nom du jour de la semaine, selon les paramètres locaux. %b - Abréviation du nom du jour, selon les paramètres locaux. %B - Nom complet du mois, selon les paramètres locaux. %c - Préférences d'affichage selon les paramètres locaux. %C - Siècle, (L'année divisée par 100 et tronquée comme un entier, de 00 à 99) %d - Jour du mois, en tant que nombre décimal (de 00 à 31) %D - même chose que %m/%d/%y %e - Jour du mois en tant que nombre décimal. Un chiffre unique est précédé par un espace (de 1 à 31) %g - Position de la semaine dans le siècle [00,99] %G - Position de la semaine, incluant le siècle [0000,9999] %h - identique à %b %H - L'heure en tant que décimale, en utilisant une horloge sur 24 (de 00 à 23) %I - L'heure en tant que décimale en utilisant une horloge sur 12 (de 01 to 12) %j - jour de l'année (de 001 à 366) %k - Heure (horloge sur 24). Les numéros à un chiffre sont précédés d'un espace. (de 0 à 23) %l - Heure (horloge sur 12). Les numéros à un chiffre sont précédés d'un espace. (de 1 à 12) %m - Mois en tant que nombre décimal (de 01 à 12) %M - Minute en tant que nombre décimal %n - Retour chariot (nouvelle ligne). %p - soit am soit pm selon l'heure donnée, ou alors leurs correspondances locales. %r - heure en notation a.m. et p.m. %R - Heure au format 24 heures %S - Secondes en tant que nombre décimal. %t - Caractère tabulation. %T - Heure courante, équivalent à %H:%M:%S %u - Jour de la semaine en tant que nombre décimal [1,7], ou 1 représente le lundi. %U - Le numéro de la semaine en nombre décimal, utilisant le premier dimanche en tant que premier jour de la première semaine. %V - Le numéro de la semaine de l'année courante selon la norme ISO 8601:1988, de 01 à 53, ou la semaine 1 est la première semaine qui dispose au minimum de 4 jours dans l'année courante et ou Lundi est le premier jour de cette semaine. %w - Jour de la semaine en tant que nombre décimal, dimanche étant 0 %W - Le numéro de la semaine de l'année courante en tant que nombre décimal, ou Lundi est le premier jour de la première semaine. %x - Représentation préférée de la date selon les paramètres locaux. %X - Représentation préférée de l'heure selon les paramètres locaux, sans la date. %y - L'année en tant que nombre décimal, sans le siècle. (de 00 à 99) %Y - L'année en tant que nombre décimal, avec le siècle. %Z - Zone horraire, nom ou abréviation %% - Un caractère litéral `%' NOTE AUX DEVELOPPEURS: date_format est un alias de la fonction PHP strftime(). Il est probable que vous disposiez de plus ou moins d'options disponibles selon le système sur lequel PHP a été compilé (strftime ()). Reportez vous à l'aide de votre système pour une liste complète des paramètres disponibles. Position du paramètre Type Requis Defaut Description 1 chaîne de caractères Non empty La valeur par défaut de la sortie si la variable d'entrée est vide. Utilisé pour définir une valeur par défaut à une variable. Si la variable est vide ou indéfinie, la valeur donnée est affichée en lieu et place. Default attends un seul argument. index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', 'Les portes de la moria restent fermées.'); $smarty->display('index.tpl'); index.tpl: {$TitreArticle|default:"pas de titre"} {$monTitre|default:"pas de titre"} SORTIE: Les portes de la moria restent fermées. pas de titre Position du paramètre Type Requis Valeurs possibles Defaut Description 1 chaîne de caractère Non html, htmlall, url, quotes, hex, hexentity, javascript html Format d'échappement à utiliser. "Echappe" les caractères spéciaux html, d'url, pour les quotes d'une chaîne, les valeurs hexadécimales, les entités hexadécimales ou javascript. Par défaut, ce paramètre est html. index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', "'Stiff Opposition Expected to Casketless Funeral Plan'"); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|escape} {$titreArticle|escape:"html"} {* escapes & " ' < > *} {$titreArticle|escape:"htmlall"} {* escapes ALL html entities *} {$titreArticle|escape:"url"} {$titreArticle|escape:"quotes"} <a href="mailto:{$EmailAddress|escape:"hex"}">{$EmailAddress|escape:"hexentity"}</a> SORTIE: 'Stiff Opposition Expected to Casketless Funeral Plan' &#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; &#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; &#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; %27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27 \'Stiff Opposition Expected to Casketless Funeral Plan\' <a href="mailto:%62%6f%62%40%6d%65%2e%6e%65%74">&#x62;&#x6f;&#x62;&#x40;&#x6d;&#x65;&#x2e;&#x6e;&#x65;&#x74;</a> Position du paramètre Type Requis Defaut Description 1 entier Non 4 De combien de caractères l'indentation doit être effectuée. 2 chaîne de caractère Non (espace) Caractère à utiliser pour l'indentation. Indente chacune des lignes d'une chaîne. Comme paramètre optionnel, vous pouvez spécifier le nombre de caractères à utiliser pour l'indentation (4 par défaut). Comme second paramètre optionnel, vous pouvez spécifier le caractère à utiliser pour l'indentation (utilisez "\t" pour les tabulations). index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', 'Il fera noir cette nuit.'); $smarty->display('index.tpl'); index.tpl: {$TitreArticle} {$TitreArticle|indent} {$TitreArticle|indent:10} {$TitreArticle|indent:1:"\t"} SORTIE: Il fera noir cette nuit. Il fera noir cette nuit. Il fera noir cette nuit. Il fera noir cette nuit. Met une variable en minuscules. index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', 'Deux Suspects Se Sont Sauvés.'); $smarty->display('index.tpl'); index.tpl: {$TitreArticle} {$TitreArticle|lower} SORTIE: Deux Suspects Se Sont Sauvés. deux suspects se sont sauvés. Transforme toutes les fins de lignes en balises <br />. Equivalent à la fonction PHP nl2br(). index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', "Pluie ou soleil attendu\naujourd'hui, nuit noire"); $smarty->display('index.tpl'); index.tpl: {$TitreArticle|nl2br} SORTIE: Pluie ou soleil attendu<br />aujourd'hui, nuit noire Position du paramètre Type Requis Defaut Description 1 chaîne de caractère Oui n/a Expression régulière à remplacer. 2 chaîne de caractère Oui n/a La chaîne de remplacement. Un rechercher / remplacer avec une expression régulière. Utilise la même syntaxe que la fonction PHP preg_replace. index.php: $smarty = new Smarty; $smarty->assign('TitreArticle', "L'infertilité est un maux grandissant\n, disent les experts."); $smarty->display('index.tpl'); index.tpl: {* Remplace tous les retours chariot et les tabulation par une nouvelle ligne avec un espace *} {$TitreArticle} {$TitreArticle|regex_replace:"/[\r\t\n]/":" "} SORTIE: L'infertilité est un maux grandissant , disent les experts. L'infertilité est un maux grandissant, disent les experts. Position du paramètre Type Requis Defaut Description 1 chaîne de caractères Oui n/a chaîne à remplacer. 2 chaîne de caractères Oui n/a chaîne de remplacement. Un simple remplacement de chaîne de caractères. index.php: $smarty = new Smarty; $smarty->assign('titreArticle', "Child's Stool Great for Use in Garden."); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|replace:"Garden":"Vineyard"} {$titreArticle|replace:" ":" "} SORTIE: Child's Stool Great for Use in Garden. Child's Stool Great for Use in Vineyard. Child's Stool Great for Use in Garden. Position du paramètre Type Requis Defaut Description 1 chaîne de caractère Non espace Ce qui est inséré entre chaque caractère de la variable. spacify est un moyen pour insérer un espace entre tous les caractères d'une variable. Optionnellement, vous pouvez lui passer un caractère (ou une chaîne) différent de espace à insérer. index.php: $smarty = new Smarty; $smarty->assign('titreArticle', 'Quelque chose s'est mal passé et à provoqué cet accident, disent les experts'); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|spacify} {$titreArticle|spacify:"^^"} SORTIE: Quelquechose s'est mal passé et à provoqué cet accident, disent les experts. Q u e l q u e c h o s e s ' e s t m a l p a s s é e t à p r o v o q u é c e t a c c i d e n t , d i s e n t l e s e x p e r t s . Q^^u^^e^^l^^q^^u^^e^^c^^h^^o^^s^^e^^ ^^s^^'^^e^^s^^t^^ ^^m^^a^^l^^ ^^p^^a^^s^^s^^é^^ ^^e^^t^^ ^^à^^ ^^p^^r^^o^^v^^o^^q^^u^^é^^ ^^c^^e^^t^^ ^^a^^c^^c^^i^^d^^e^^n^^t^^,^^ ^^d^^i^^s^^e^^n^^t^^ ^^l^^e^^s^^ ^^e^^x^^p^^e^^r^^t^^s^^. Position du paramètre Type Requis Defaut Description 1 chaîne de caractères Oui n/a Le format à utiliser (sprintf) Un moyen pour formater les chaînes de caractères, comme par exemple les nombres décimaux. Utilise la syntaxe de sprintf pour formater les éléments. index.php: $smarty = new Smarty; $smarty->assign('nombre', 23.5787446); $smarty->display('index.tpl'); index.tpl: {$nombre} {$nombre|string_format:"%.2f"} {$nombre|string_format:"%d"} SORTIE: 23.5787446 23.58 24 Remplace les espaces multiples, les nouvelles lignes et les tabulations par un espace simple, ou une chaîne donnée. Si vous voulez réaliser cette action sur un bloc complet du template, utilisez la fonction strip. index.php: $smarty = new Smarty; $smarty->assign('titreArticle', "Une réunion autour\n d'un feu de cheminée\t est toujours agréable."); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|strip} {$titreArticle|strip:"&nbsp;"} SORTIE: Une réunion autour d'un feu de cheminée est toujours agréable. Une réunion autour d'un feu de cheminée est toujours agréable. Une&nbsp;réunion&nbsp;autour&nbsp;d'un&nbsp;feu&nbsp;de&nbsp;cheminée&nbsp;est&nbsp;toujours &nbsp;agréable. Supprime toutes les balises, et plus généralement tout ce qui se trouve entre < et >. index.php: $smarty = new Smarty; $smarty->assign('titreArticle', "Une femme aveugle obtient un nouveau <font face=\"helvetica\"> rein</font> d'un père qu'elle n'a pas vu depuis<b> des années</b>."); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|strip_tags} SORTIE: Une femme aveugle obtient un nouveau <font face=\"helvetica\"> rein</font> d'un père qu'elle n'a pas vu depuis<b> des années</b>. Une femme aveugle obtient un nouveau rein d'un père qu'elle n'a pas vu depuis des années. Position du paramètre Type Requis Defaut Description 1 entier Non 80 Le nombre de caractères maximums au-delà duquel on effectue le troncage 2 chaîne de caractère Non ... Le texte à rajouter lorsque l'on effectue un troncage. 3 booléen Non false Détermine si le troncage est effectué sur le dernier mot (false), ou au caractère exact (true). Tronque une variable à une certaine longueur, par défaut 80. Un second paramètre optionnel permet de spécifier une chaîne à afficher à la fin de la variable une fois tronquée. Les caractères de fin sont inclus dans la longueur de la chaîne à tronquer. Par défaut, truncate tentera de couper la chaîne à la fin d'un mot. Si vous voulez tronquer la chaîne au caractère exact, donnez la valeur true au dernier paramètre optionnel. index.php: $smarty = new Smarty; $smarty->assign('titreArticle', 'Deux soeurs réunies après 18 ans de séparation.'); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|truncate} {$titreArticle|truncate:30} {$titreArticle|truncate:30:""} {$titreArticle|truncate:30:"---"} {$titreArticle|truncate:30:"":true} {$titreArticle|truncate:30:"...":true} SORTIE: Deux soeurs réunies après 18 ans de séparation. Deux soeurs réunies après... Deux soeurs réunies après Deux soeurs réunies après--- Deux soeurs réunies après 18 a Deux soeurs réunies après 1... Met une variable en majuscules. index.php: $smarty = new Smarty; $smarty->assign('titreArticle', "Si l'attaque n'est pas mise en place rapidement, cela risque de durer longtemps."); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|upper} SORTIE: Si l'attaque n'est pas mise en place rapidement, cela risque de durer longtemps. SI L'ATTAQUE N'EST PAS MISE EN PLACE RAPIDEMENT, CELA RISQUE DE DURER LONGTEMPS. Position du paramètre Type Requis Defaut Description 1 entier Non 80 La nombre de colonnes sur lequel ajuster l'affichage. 2 chaîne de caractères Non \n chaîne de caractères utilisée pour l'ajustement. 3 booléen Non false Détermine si l'ajustement se fait en fin de mot (false) ou au caractère exact (true). Ajuste une chaîne de caractères à une taille de colonne, par défaut 80. Un second paramètre optionnel vous permet de spécifier la chaîne à utiliser pour l'ajustement à la nouvelle ligne (retour chariot \n par défaut). Par défaut, wordwrap tente un ajustement à la fin d'un mot. Si vous voulez autoriser le découpage des mots pour un ajustement au caractère près, passez true au troisième paramètre optionnel. index.php: $smarty = new Smarty; $smarty->assign('titreArticle', "Une femme aveugle obtient un nouveau rein d'un père qu'elle n'a pas vu depuis des années."); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|wordwrap:30} {$titreArticle|wordwrap:20} {$titreArticle|wordwrap:30:"<br>\n"} {$titreArticle|wordwrap:30:"\n":true} SORTIE: Une femme aveugle obtient un nouveau rein d'un père qu'elle n'a pas vu depuis des années. Une femme aveugle obtient un nouveau rein d'un père qu'elle n'a pas vu depuis des années. Une femme aveugle obtient un nouveau rein d'un père qu'elle n'a pas vu depuis des années. Une femme aveugle obtient un<br> nouveau rein d'un père<br> qu'elle n'a pas vu depuis<br> des années. Une femme aveugle obtient un n ouveau rein d'un père qu'elle n'a pas vu depuis des années. Vous pouvez appliquer un nombre quelquonque de modificateurs à une variable. Ils seront invoqués dans l'ordre d'apparition, de la gauche vers la droite. Ils doivent être séparés par un | (pipe). index.php: $smarty = new Smarty; $smarty->assign('titreArticle', 'Les fumeurs sont productifs, mais la mort tue l'efficacitée.'); $smarty->display('index.tpl'); index.tpl: {$titreArticle} {$titreArticle|upper|spacify} {$titreArticle|lower|spacify|truncate} {$titreArticle|lower|truncate:30|spacify} {$titreArticle|lower|spacify|truncate:30:". . ."} SORTIE: Les fumeurs sont productifs, mais la mort tue l'efficacitée. L E S F U M E U R S S O N T P R O D U C T I F S , M A I S L A M O R T T U E L ' E F F I C A C I T É E . L E S F U M E U R S S O N T P R O D U C T I F S , M A I S L A M... L E S F U M E U R S S O N T P R O D U C T I F S , M A I S L A M... L e s f u m e u r s s o n t p r o d u c t i f s , . . . L e s f u m e u r s s. . . Smarty est fourni en standard avec plusieurs fonctions natives. Les fonctions natives sont partie intégrante du language de template. Vous ne pouvez pas créer de fonctions utilisateurs qui portent le même nom qu'une fonction native. Vous ne pouvez pas non plus en modifier le comportement. Capture est utilisé pour récupérer la sortie d'éléments dans une variable au lieu de les afficher. Tout contenu situé entre {capture name="foo"} et {/capture} est intercepté dans une variable dont le nom est spécifié dans l'attribut name. Le contenu capturé peut être utilisé dans le template par l'intermédiaire de la variable spéciale $smarty.capture.foo ou foo est la valeur de l'attribut name. Si vous ne donnez pas de valeur à l'attribut name, alors "default" est utilisé. Toutes les commandes {capture} doivent être utilisées de paire avec {/capture}. Vous pouvez imbriquer les demandes de captures. Smarty 1.4.0 - 1.4.4 plaçait les contenus capturés dans une variable appelée $return. Depuis Smarty 1.4.5, ce comportement à été modifié et Smarty utilise maintenant l'attribut name en lieu et place. Veuillez donc mettre vos templates à jour selon cette règle. Faites attention lorsque vous interceptez la sortie de commandes insert. Si vous avez configuré le cache pour que ce dernier soit actif, et que vous avez des commandes insert supposées s'exécuter dans un contenu en cache, ne tentez pas de capturer ce contenu. {* nous ne voulons afficher une ligne que si cette dernière est activé. *} {capture name=banner} {include file="get_banner.tpl"} {/capture} {if $smarty.capture.banner ne ""} <tr> <td> {$smarty.capture.banner} </td> </tr> {/if} Nom attribut Type Requis Defaut Description file chaîne de caractère Oui n/a Le nom du fichier de configuration à inclure section chaîne de caractère Non n/a Le nom de la section à charger scope chaîne de caractère non local La façon dont la portée des variables est définie, soit local, parent ou global. local signifie que la variable est chargée dans le contexte du template. parent indique que la variable est disponible tant dans le template qui l'a inclus que dans le template parent, ayant réalisé l'inclusion du sous template. global signifie que la variable est diponible dans tous les templates. global booléen Non No Si oui ou non les variables sont disponibles pour les templates parents, identique à scope=parent. Note: Cet attribut est obsolète depuis l'apparition de l'attribut scope, il est toutefois toujours supporté. Si scope est défini, global est ignoré. Cette fonction est utiliseé pour charger des variables de fichier de configuration dans un template. Voir Fichiers de configuration pour de plus amples informations. {config_load file="colors.conf"} <html> <title>{#pageTitle#}</title> <body bgcolor="{#bodyBgColor#}"> <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> <tr bgcolor="{#rowBgColor#}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> Les fichiers de configuration peuvent contenir des sections. Vous pouvez charger des variables d'une section donnée avec le nouvel attribut section. NOTE: Les sections des fichiers de configuration et la fonction native section n'ont rien en commun, il s'avère simplement qu'elles portent le même nom. {config_load file="colors.conf" section="client"} <html> <title>{#pageTitle#}</title> <body bgcolor="{#bodyBgColor#}"> <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> <tr bgcolor="{#rowBgColor#}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> Nom attribut Type Requis Defaut Description from chaîne de caractère oui n/a Le nom du tableau à parcourir item chaîne de caractère Oui n/a Le nom de la variable "élément courant" key chaîne de caractère Non n/a Le nom de la variable représentant la clef courante. name chaîne de caractère Non n/a Le nom de la boucle foreach, qui nous permettra d'accéder à ses propriétés. Les boucles foreach sont une alternative aux boucles section. Les boucles foreach sont utilisées pour parcourir des tableaux associatifs simples. La syntaxe des boucles foreach est bien plus simple que celle des boucles section, mais en contrepartie, elles ne peuvent être utilisées que pour des tableaux associatifs simples. La balise foreach doit toujours être accompagnée de la balise /foreach. Les paramètres requis sont from et item. Le nom des boucles foreach doit être composés exclusivement de lettres, chiffres et underscores, selon vos préférences. Les boucles foreach peuvent être imbriquées. La variable from (généralement le tableau à parcourir) détermine le nombre de fois que foreach sera exécuté. foreachelse est exécuté si aucune valeur n'est présente dans la variable donnée à l'attribut from. {* Cet exemple affiche toutes les valeurs du tableau $custid *} {foreach from=$custid item=curr_id} id: {$curr_id}<br> {/foreach} SORTIE: id: 1000<br> id: 1001<br> id: 1002<br> {* key contient la clef de chaque élément parcouru l'attribution des élément est de la forme: $smarty->assign("contacts", array(array("tel" => "1", "fax" => "2", "portable" => "3"), array("tel" => "555-4444", "fax" => "555-3333", "portable" => "760-1234"))); *} {foreach name=outer item=contact from=$contacts} {foreach key=key item=item from=$contact} {$key}: {$item}<br> {/foreach} {/foreach} SORTIE: tel: 1<br> fax: 2<br> portable: 3<br> tel: 555-4444<br> fax: 555-3333<br> portable: 760-1234<br> Nom attribut Type Requis Defaut Description file chaîne de caractères Oui n/a Le nom du template à inclure assign chaîne de caractères Non n/a Le nom de la variable dans laquelle sera assignée la sortie de include [var ...] [type de variable] Non n/a Variables à passer au template Les balises "include" sont utilisées pour inclure des templates à l'intérieur d'autres templates. Toutes les variables disponibles dans le template réalisant l'inclusion sont disponibles dans le template inclus. La balise include doit disposer de l'attribut "file", qui contient le chemin de la ressource template. Vous pouvez spécifier un attribut optionnel assign qui définit une variable de template dans laquelle la sortie de include sera stockée plutôt qu'affichée. {include file="header.tpl"} {* Le corp du template va ici *} {include file="footer.tpl"} Vous pouvez également passer des variables au template inclus sous forme d'attributs. Les variables passées au template par ce moyen ne sont accessibles que dans la portée de ce dernier. Les variables passées en tant qu'attribut remplacent les variables déjà définies, qui auraient le même nom. {include file="header.tpl" title="Menu principal" table_bgcolor="#c0c0c0"} {* Le corps du template vient ici *} {include file="footer.tpl" logo="http://mon.domaine.com/logo.gif"} Utilisez la syntaxe ressource template pour inclure des fichiers situés en dehors du répertoire $template_dir. {* chemin absolu *} {include file="/usr/local/include/templates/header.tpl"} {* chemin absolu (même chose) *} {include file="file:/usr/local/include/templates/header.tpl"} {* chemin absolu windows (DOIT utiliser le préfixe "file:") *} {include file="file:C:/www/pub/templates/header.tpl"} {* inclusion d'une ressource template "db" *} {include file="db:header.tpl"} Nom attribut Type Requis Defaut Description file chaîne de caractère oui n/a Le nom du fichier PHP à inclure once boléen Non true Inclure plusieurs fois ou non le fichier PHP si plusieurs demandes d'inclusions sont faites. assign chaîne de caractère Non n/a le nom de la variable PHP dans laquelle la sortie sera assignée plutôt que directement affichée. les balises include_php sont utilisées pour inclure directement un script PHP dans vos templates. Si "security" est activé, alors le script à exécuter doit être placé dans le chemin $trusted_dir. La balise include_php attends l'attribut "file", qui contient le chemin du fichier PHP à inclure, relatif à $trusted_dir, ou absolu. include_php est un moyen agréable pour gérer des "composants templates", tout en conservant le code PHP en dehors du template lui même. Supposons que vous ayez un template reprenant la navigation de votre site, elle même récupérée depuis une base de données. Vous pouvez conserver la logique du code PHP récupérant le contenu de la base dans un emplacement séparé, et l'inclure depuis votre template. Maintenant, vous pouvez utiliser ce template n'importe ou, sans vous inquiéter de savoir si les informations nécessaires ont bien étés assignées par l'application, avant la demande d'affichage. Par défaut, les fichiers PHP ne sont inclus qu'une seule fois, même si la demande d'inclusion survient plusieurs fois dans le template. Vous pouvez demander à ce que ce fichier soit inclus à chaque demande grâce à l'attribut once. Mettre l'attribut once à false aura pour effet d'inclure le script PHP à chaque fois que demandé dans le template. Vous pouvez donner une valeur à l'attribut optionnel assign, pour demander à la fonction include_php d'assigner la sortie du script PHP à la variable spécifiée plutôt que d'en afficher directement le résultat. L'objet Smarty est disponible en tant que $this dans le script PHP inclus. load_nav.php ------------- <?php // charge des variables depuis une base de données mysql et les assigne au template. require_once("MySQL.class.php"); $sql = new MySQL; $sql->query("select * from site_nav_sections order by name",SQL_ALL); $this->assign('sections',$sql->record); ?> index.tpl --------- {* chemin absolu, ou relatif à $trusted_dir *} {include_php file="/path/to/load_nav.php"} {foreach item="curr_section" from=$sections} <a href="{$curr_section.url}">{$curr_section.name}</a><br> {/foreach} Nom attribut Type Requis Defaut Description name chaîne de caractères Oui n/a le nom de la fonction insert (insert_name) assign chaîne de caractère Non n/a Le nom de la variable qui recevra la sortie script chaîne de caractères Non n/a Le nom du script PHP inclus avant que la fonction insert ne soit appelée. [var ...] [var type] Non n/a Variable à passer à la fonction insert Les balises insert fonctionnent à peu près comme les balises include, à l'exception que leur sortie n'est pas placée en cache lorsque le cache [caching] est activé. Les balises insert seront exécutées à chaque appel du template. Supposons que vous avez un template avec un emplacement pour un bandeau publicitaire en haut de page. Ce bandeau publicitaire peut contenir toutes sortes de contenus HTML, images, flash, etc. Nous ne pouvons pas placer du contenu statique à cet endroit. Nous ne voulons pas non plus que ce contenu fasse partie du cache. Arrive alors la balise insert. Le template connais #emplacement_bandeau# et #id_site# (récupérés depuis un fichier de configuration), et à besoin d'un appel de fonction pour récupérer le contenu du bandeau. {* exemple de récupération d'un bandeau publicitaire *} {insert name="getBanner" lid=#emplacement_bandeau# sid=#id_site#} Dans cet exemple, nous utilisons le nom getBanner et lui passons les paramètres #emplacement_bandeau# et #id_site#. Smarty va rechercher une fonction appelée insert_getBanner () dans votre application PHP, et lui passer les valeurs #banner_location_id# et #site_id# comme premier paramètre, dans un tableau associatif. Tous les noms des fonctions insert de votre application doivent être prefixées de "insert_" pour remédier à d'éventuels conflits de nommage. Votre fonction insert_getBanner () est supposée traiter les valeurs passées et retourner un résultat. Ces résultats sont affichés dans le template en lieu et place de la balise. Dans cet exemple, Smarty appellera cette fonction insert_getBanner(array("lid" => "12345","sid" => "67890")); et affichera le résultat retourné à la place de la balise insert. Si vous donnez une valeur à l'attribut "assign", la sortie de la balise insert sera assigné à une variable de template de ce nom au lieu d'être affichée directement. NOTE: assigner la sortie à une variable n'est pas très utile lorsque le cache est activé. Si vous donnez une valeur à l'attribut "script", ce script PHP sera inclus (une seule fois) avant l'exécution de la fonction insert. Le cas peut survenir lorsque la fonction insert n'existe pas encore, et que le script PHP chargé de sa définission doit être inclus. Le chemin doit être absolu ou relatif à $trusted_dir. Lorsque "security" est actif, le script doit être situé dans $trusted_dir. L'objet Smarty est passé comme second argument. De cette façon, vous pouvez utiliser ou modifier des informations sur l'objet Smarty, directement depuis votre fonction d'insertion. Il est possible d'avoir des portions de template qui ne soient pas gérables par le cache. Même si vous avez activé l'option caching, les balises insert ne feront pas partie du cache. Elles retourneront un contenu dynamique à chaque invocation de la page. Cette méthode est très pratique pour des éléments tels que les bandeaux publicitaires, les enquêtes, la météo, les résultats de recherche, retours utilisateurs, etc. l'instruction if dans Smarty dispose de la même flexibilité que l'instruction PHP du même nom, avec quelques fonctionnalités supplémentaires pour le moteur de template. Tous les if doivent être utilisés de pair avec un /if. else et elseif sont également des balises autorisées. "eq", "ne","neq", "gt", "lt", "lte", "le", "gte" "ge","is even","is odd", "is not even","is not odd","not","mod", "div by","even by","odd by","==","!=",">", "<","<=",">=" sont tous des opérateurs conditionnels valides, et doivent obligatoirement être séparés des autres éléments par des espaces. {if $name eq "Fred"} Bienvenue, Monsieur. {elseif $name eq "Wilma"} Bienvenue m'dame. {else} Bienvenue, qui que vous soyez. {/if} {* Un exemple avec l'opérateur or *} {if $name eq "Fred" or $name eq "Wilma"} ... {/if} {* même chose que ci-dessus *} {if $name == "Fred" || $name == "Wilma"} ... {/if} {* l'exemple suivant NE fonctionne PAS, les opérateurs doivent être entourés d'espaces. *} {if $name=="Fred" || $name=="Wilma"} ... {/if} {* les parenthèses sont autorisées *} {if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#} ... {/if} {* vous pouvez également faire appel aux fonctions PHP *} {if count($var) gt 0} ... {/if} {* teste si les valeurs sont paires(even) ou impaires(odd) *} {if $var is even} ... {/if} {if $var is odd} ... {/if} {if $var is not odd} ... {/if} {* teste si la variable est divisble par 4 *} {if $var is div by 4} ... {/if} {* teste si la variable est paire, par groupe de deux i.e., 0=paire, 1=paire, 2=impaire, 3=impaire, 4=paire, 5=paire, etc. *} {if $var is even by 2} ... {/if} {* 0=paire, 1=paire, 2=paire, 3=impaire, 4=impaire, 5=impaire, etc. *} {if $var is even by 3} ... {/if} ldelim et rdelim sont utilisés pour afficher les délimiteurs en tant que tels, dans notre cas "{" ou "}". Le moteur de template tentera toujours d'interpréter le contenu entre les délimiteurs, c'est donc une façon d'afficher ces derniers sans interférer avec Smarty. {* Affiche les délimiteurs de template *} {ldelim}nomFonction{rdelim} est la façon dont sont appelées les fonctions dans Smarty ! SORTIE: {nomFonction} est la façon dont sont appelées les fonctions dans Smarty ! Les balises "literal" permettent à un bloc de données d'être pris tel quel, sans qu'il ne soit interprété par Smarty. Très pratique lors de l'emplois d'éléments tels que javascript, acolades et autres qui peuvent confondre le moteur de template. Tout le contenu situé entre les balises {literal}{/literal} ne sera pas interprété, et affiché comme du contenu statique. {literal} <script language=javascript> <!-- function isblank(field) { if (field.value == '') { return false; } else { document.loginform.submit(); return true; } } // --> </script> {/literal} Les balises PHP permettent de rajouter du code PHP directement dans le template. Ils ne seront pas ignorés, quelle que soit la valeur de $php_handling. Pour les utilisateurs avancés seulement, son utilisation n'est normalement pas nécessaire. {php} // inclusion directe d'un script PHP // depuis le template. include("/path/to/display_weather.php"); {/php} Nom attribut Type Requis Defaut Description name chaîne de caractère Oui n/a Le nom de la section loop [$nom_variable] Oui n/a le nom de la variable qui détermine le nombre de fois que la boucle sera exécutée. start entier Non 0 La position de l'index ou la section commencera son parcours. Si la valeur donnée est négative, la position de départ est calculée depuis la fin du tableau. Par exemple, s'il existe 7 valeurs dans le tableau à parcourir et que start est à -2, l'index de départ sera 5. Les valeurs incorrectes (en dehors de la portée du tableau) sont automatiquements tronquées à la valeur correcte la plus proche. step entier Non 1 La valeur du pas qui sera utilisé pour parcourir le tableau.Par exemple, step=2 parcourera les indices 0,2,4, etc. Si step est négatif, le tableau sera parcouru en sens inverse. max entier Non 1 Définit le nombre maximum de fois que le tableau sera parcouru. show booléen Non true Détermine s'il est nécessaire d'afficher la section ou non. Les balises section sont utilisées pour parcourir un tableau de données. Toutes les balises section doivent être utilisées de paire avec les balises /section. Les paramètres requis sont name et loop. Le nom de la section est, selon votre choix, composé de lettres, chiffres et underscores. Les sections peuvent être imbriquées, mais leurs noms doivent être uniques. La variable de parcours (généralement un tableau de données) détermine le nombre de fois que la section sera parcourue. Lorsque l'on affiche une variable dans une section, le nom de la section doit précéder la variable entre crochets. sectionelse est exécuté lorsqu'aucune valeur n'est trouvée dans la variable à parcourir. {* Cet exemple va afficher toutes les valeurs du tableau $custid *} {section name=client loop=$custid} id: {$custid[client]}<br> {/section} SORTIE: id: 1000<br> id: 1001<br> id: 1002<br> {* La variable de parcours détermine uniquement le nombre de fois que nous allons rentrer dans la boucle. Vous pouvez accéder à toutes les variables du template lorsque vous êtes dans une section. Cet exemple part du principe que $idClient, $noms et $adresses sont tous des tableaux qui contiennent autant de valeurs les uns que les autres.*} {section name=client loop=$custid} id: {$idClient[client]}<br> nom: {$noms[client]}<br> addresse: {$addresses[client]}<br> <p> {/section} SORTIE: id: 1000<br> nom: John Smith<br> addresse: 253 N 45th<br> <p> id: 1001<br> nom: Jack Jones<br> addresse: 417 Mulberry ln<br> <p> id: 1002<br> nom: Jane Munson<br> addresse: 5605 apple st<br> <p> {* Le nom de la section peut être ce que vous voulez, et est utilisé pour référencer les données depuis la section. *} {section name=monTableau loop=$idClient} id: {$idCLient[monTableau]}<br> name: {$noms[monTableau]}<br> address: {$addresses[monTableau]}<br> <p> {/section} {* Les sections peuvent être imbriquées à un nombre de niveaux illimité. Grâce aux sections imbriquées, vous pouvez accéder à des structures de données complexes, comme des tableaux multi-dimentionnels. Dans cet exemple, $type_contact[client] est un tableau de type de contact pour le client courant. *} {section name=client loop=$custid} id: {$idClient[client]}<br> nom: {$nom[client]}<br> addresse: {$addresse[client]}<br> {section name=contact loop=$type_contact[client]} {$type_contact[client][contact]}: {$info_contact[client][contact]}<br> {/section} <p> {/section} SORTIE: id: 1000<br> nom: John Smith<br> addresse: 253 N 45th<br> telephone: 555-555-5555<br> telephone portable: 555-555-5555<br> e-mail: john@mydomain.com<br> <p> id: 1001<br> nom: Jack Jones<br> addresse: 417 Mulberry ln<br> telephone: 555-555-5555<br> telephone portable: 555-555-5555<br> e-mail: jack@mydomain.com<br> <p> id: 1002<br> nom: Jane Munson<br> addresse: 5605 apple st<br> telephone: 555-555-5555<br> telephone portable: 555-555-5555<br> e-mail: jane@mydomain.com<br> <p> {* Exemple d'affichage d'un tableau associatif dans une section *} {section name=client loop=$contacts} nom: {$contacts[client].name}<br> telephone: {$contacts[client].home}<br> portable: {$contacts[client].cell}<br> e-mail: {$contacts[client].email}<p> {/section} SORTIE: nom: John Smith<br> telephone: 555-555-5555<br> portable: 555-555-5555<br> e-mail: john@mydomain.com<p> nom: Jack Jones<br> telephone: 555-555-5555<br> portable: 555-555-5555<br> e-mail: jack@mydomain.com<p> nom: Jane Munson<br> telephone: 555-555-5555<br> portable: 555-555-5555<br> e-mail: jane@mydomain.com<p> {* sectionelse est exécuté s'il n'existe aucune valeur dans idClient *} {section name=client loop=$idClient} id: {$idClient[client]}<br> {sectionelse} Aucune valeur dans $idClient. {/section} Les sections ont leur propre variable de gestion des propriétés. Elles sont de la forme: {$smarty.section.nomSection.nomVariable} NOTE: Depuis Smarty 1.5.0, la syntaxe pour les propiétés des sections a été changée de {%sectionname.varname%} à {$smarty.section.nomSection.nomVariable}. L'ancienne syntaxe est toujours supportée, mais vous ne verrez que des exemples avec la nouvelle syntaxe dans le manuel. Index est utilisé pour afficher l'index de parcours courant, commence par 0 (ou l'attribut start), et s'incrémente de 1 (ou de la valeur de l'attribut step). Si les attributs step et start ne sont pas modifiés, alors index fonctionne de la même façon que iteration, à l'exception qu'il commence par 0 plutôt que par 1. {section name=client loop=$idClient} {$smarty.section.client.index} id: {$idClient[client]}<br> {/section} SORTIE: 0 id: 1000<br> 1 id: 1001<br> 2 id: 1002<br> index_prev est utilisé pour afficher l'index de parcours précédent de la boucle. Au premier passage, il vaut -1. {section name=client loop=$custid} {$smarty.section.client.index} id: {$idClient[client]}<br> {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} {if $idClient[client.index_prev] ne $idClient[client.index]} L'id du client à été modifié<br> {/if} {/section} SORTIE: 0 id: 1000<br> L'id du client à été modifié<br> 1 id: 1001<br> L'id du client à été modifié<br> 2 id: 1002<br> L'id du client à été modifié<br> index_next est utilisé pour afficher la valeur théorique suivante de index. Dans la dernière boucle, cela reste la valeur incrémentée, qui respecte l'attribut step si donné. {section name=client loop=$idClient} {$smarty.section.client.index} id: {$idClient[client]}<br> {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} {if $idClient[client.index_next] ne $idClient[client.index]} L'id du client va changer<br> {/if} {/section} SORTIE: 0 id: 1000<br> L'id du client va changer<br> 1 id: 1001<br> L'id du client va changer<br> 2 id: 1002<br> L'id du client va changer<br> iteration est utilisé pour afficher la valeur courante de l'iteration. NOTE: Cette valeur n'est pas affectée par les attributs start, step et max, à l'inverse de la propriété index. L'itération commence par 1 et non par 0 (comme le fait index). rownum est un alias de iteration, ils fonctionnent de la même façon. {section name=client loop=$idClient start=5 step=2} Iteration courante: {$smarty.section.client.iteration}<br> {$smarty.section.client.index} id: {$idClient[client]}<br> {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} {if $idCLient[client.index_next] ne $idClient[client.index]} L'id du client va changer<br> {/if} {/section} SORTIE: Iteration courante: 1 5 id: 1000<br> L'id du client va changer<br> Iteration courante: 2 7 id: 1001<br> L'id du client va changer<br> Iteration courante: 3 9 id: 1002<br> L'id du client va changer<br> first est à true lorsque la section est parcouru pour la première fois. {section name=client loop=$idClient} {if $smarty.section.client.first} <table> {/if} <tr><td>{$smarty.section.client.index} id: {$idClient[client]}</td></tr> {if $smarty.section.client.last} </table> {/if} {/section} SORTIE: <table> <tr><td>0 id: 1000</td></tr> <tr><td>1 id: 1001</td></tr> <tr><td>2 id: 1002</td></tr> </table> last est à true lorsque la section est parcourue pour la dernière fois. {section name=client loop=$idClient} {if $smarty.section.client.first} <table> {/if} <tr><td>{$smarty.section.client.index} id: {$idClient[client]}</td></tr> {if $smarty.section.client.last} </table> {/if} {/section} SORTIE: <table> <tr><td>0 id: 1000</td></tr> <tr><td>1 id: 1001</td></tr> <tr><td>2 id: 1002</td></tr> </table> rownum, utilisé pour afficher la valeur courante de l'itération, commence par 1. C'est un alias de iteration, ils fonctionnent de façon identique. {section name=client loop=$idClient} {$smarty.section.client.rownum} id: {$idClient[client]}<br> {/section} SORTIE: 1 id: 1000<br> 2 id: 1001<br> 3 id: 1002<br> loop est utilisé pour afficher la dernière valeur de index que cette section a utilisé. Peut être utilisé dans ou en dehors de la section. {section name=client loop=$idClient} {$smarty.section.client.index} id: {$idClient[client]}<br> {/section} Il y eu {$smarty.section.client.loop} clients d'affichés. SORTIE: 0 id: 1000<br> 1 id: 1001<br> 2 id: 1002<br> il y eu 3 clients d'affichés. show est utilisé comme paramètre de section. show est une valeur booléenne, true ou false. Si show est à "false", la section ne sera pas affichée. Si un sectionelse est présent, elle sera affiché. {* $show_client_info a pu être passé par le script PHP, pour déterminer si oui ou non on souhaite afficher la section *} {section name=client loop=$idClient show=$show_client_info} {$smarty.section.client.rownum} id: {$idClient[client]}<br> {/section} {if $smarty.section.client.show} la section à été affichée. {else} la section n'a pas été affichée. {/if} SORTIE: 1 id: 1000<br> 2 id: 1001<br> 3 id: 1002<br> la section à été affichée. total est utilisé pour afficher le nombre d'itération que la section va exécuter. Peut être utilisé dans ou en dehors de la section. {section name=client loop=$idClient step=2} {$smarty.section.client.index} id: {$idClient[client]}<br> {/section} Il y eu {$smarty.section.client.total} clients affichés. SORTIE: 0 id: 1000<br> 2 id: 1001<br> 4 id: 1002<br> Il y eu 3 clients affichés. Il est fréquent que les designers web rencontrent des problèmes dus aux espaces et retours chariots, qui affectent le rendu HTML ("fonctionnalités" des navigateurs), les obligeant à coller les balises les unes aux autres. Cette solution rend généralement le code illisible et impossible à maintenir. Tout contenu situé entre les balises {strip}{/strip} se verra allégé des espaces superflus et des retours chariots en début ou en fin de ligne, avant qu'il ne soit affichés. De la sorte, vous pouvez conserver vos templates lisibles, sans vous soucier des effets indésirables que peuvent apporter les espaces superflus. {strip}{/strip} n'affecte en aucun cas le contenu des variables de template. Voir le modificateur strip pour un rendu identique pour les variables. {* la suite sera affichée sur une seule ligne *} {strip} <table border=0> <tr> <td> <A HREF="{$url}"> <font color="red">Un test</font> </A> </td> </tr> </table> {/strip} SORTIE: <table border=0><tr><td><A HREF="http://mon.domaine.com"><font color="red">Un test</font></A></td></tr></table> Notez que dans l'exemple ci-dessus, toutes les lignes commencent et se terminent par des balises HTML. Sachez que si vous avez du texte en début ou en fin de ligne dans des balises strip, ce dernier sera collé au suivant/précédent et risque de ne pas être affiché selon l'effet désiré. Smarty est livré avec plusieurs fonctions utilisateurs que vous pouvez appeler dans vos templates. Nom attribut Type Requis Defaut Description var chaîne de caractère Oui n/a Le nom de la variable assignée value chaîne de caractère Oui n/a La valeur assignée Assign est utilisé pour déclarer ou modifier des variables de template. {assign var="name" value="Bob"} La valeur de $name est {$name}. SORTIE: La valeur de $name est Bob. Nom attribut Type Requis Defaut Description name chaîne de caractère Non default Le nom du compteur start numérique Non 1 La valeur initiale du compteur skip numérique Non 1 L'intervale du compteur direction chaîne de caractères Non up la direction du compteur (up/down) [compte / décompte] print booléen Non true S'il faut afficher cette valeur ou non assign chaîne de caractères Non n/a La variable dans laquelle la valeur du compteur sera assignée. counter affiche un compteur. counter retient la valeur du compte à chaque itération. Vous pouvez adapter le nombre, l'intervale et la direction du compteur, ainsi que décider d'afficher ou non les valeurs. Vous pouvez lancer plusieurs compteurs simultanément en leur donnant des noms uniques. Si vous ne donnez pas de nom à un compteur, 'default' sera utilisé. Si vous donnez une valeur à l'attribut "assign", alors la sortie de la fonction counter sera assignée à la variable de template donnée plutôt que d'être directement affichée. {* initialisation du compteur *} {counter start=0 skip=2 print=false} {counter}<br> {counter}<br> {counter}<br> {counter}<br> SORTIE: 2<br> 4<br> 6<br> 8<br> Nom attribut Type Requis Defaut Description name chaîne de caractères Non default Le nom du cycle values divers Oui N/A Les valeurs sur lesquelles boucler, soit une liste séparée par des virgules, (voir l'attribut delimiter), soit un tableau de valeurs. print booléen Non true S'il faut afficher ou non cette valeur advance booléen Non true Oui ou non aller à la prochaîne valeur delimiter chaîne de caractères Non , Le délimiteur à utiliser dans la liste. assign chaîne de caractères Non n/a La variable de template dans laquelle la sortie sera assignée cycle est utilisé pour boucler sur un ensemble de valeurs. Très pratique pour alterner entre deux ou plusieurs couleurs dans un tableau, ou plus généralement pour boucler sur les valeurs d'un tableau. Vous pouvez définir plusieurs "cycle" dans votre template, en leur donnant des noms uniques (attribut name). Vous pouvez empêcher la valeur courante de s'afficher en définissant l'attribut print à false. Ce procédé peut être utile pour discrètement passer outre une valeur de la liste. L'attribut advance est utilisé pour répéter une valeur. Lorsque définit à false, le prochain appel de cycle ramènera la même valeur. Si vous définissez l'attribut spécial "assign", la sortie de la fonction cycle y sera assignée plutôt que d'être directement affichée. {section name=rows loop=$data} <tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"> <td>{$data[rows]}</td> </tr> {/section} SORTIE: <tr bgcolor="#eeeeee"> <td>1</td> </tr> <tr bgcolor="#d0d0d0"> <td>2</td> </tr> <tr bgcolor="#eeeeee"> <td>3</td> </tr> Nom attribut Type Requis Defaut Description output chaîne de caractères Non html Type de sortie, html ou javascript {debug} amène la console de débogage sur la page. Fonctionne quelle que soit la valeur du paramètre debug de Smarty. Comme ce dernier est appelé lors de l'exécution, il n'est capable d'afficher que les variables assignées au template, et non les templates en cours d'utilisation. Toutefois, vous voyez toutes les variables disponibles pour le template courant. Nom attribut Type Requis Defaut Description var mixed Oui n/a variable (ou chaîne de caractères) à évaluer assign chaîne de caractères Non n/a Le nom de la variable PHP dans laquelle la sortie sera assignée eval évalue une variable comme si cette dernière était un template. Peut être utile pour embarquer des balises de templates ou des variables de template dans des variables ou des balises/variables dans des variables de fichiers de configuration. Si vous définissez l'attribut "assign", la sortie sera assignée à la variable de template désignée plutôt que d'être affichée dans le template. Les variables évaluées sont traitées de la même façon que les templates. Elles suivent les mêmes règles de traitement et de sécurité, comme si elles étaient réellement des templates. Les variables évaluées sont compilées à chaque invocation, et la version compilée n'est pas sauvegardée ! Toutefois, si le cache est activé, la sortie sera placée en cache avec le reste du template. setup.conf ---------- emphstart = <b> emphend = </b> titre = Bienvenue sur la homepage de {$company} ! ErrorVille = Vous devez spécifier un nom de {#emphstart#}ville{#emphend#}. ErrorDept = Vous devez spécifier un {#emphstart#}département{#emphend#}. index.tpl --------- {config_load file="setup.conf"} {eval var=$foo} {eval var=#titre#} {eval var=#ErrorVille#} {eval var=#ErrorDept# assign="state_error"} {$state_error} SORTIE: Ceci est le contenu de foo. Bienvenue sur la homepage de FictifLand. Vous devez spécifier un nom de <b>ville</b>. Vous devez spécifier un <b>département</b>. Nom attribut Type Requis Defaut Description file chaîne de caractères Oui n/a le fichier, site http ou ftp à récupérer assign chaîne de caractères Non n/a le nom de la variable PHP dans laquelle la sortie sera assignée plutôt que d'être directement affichée. fetch est utilisé pour récupérer des fichiers depuis le système de fichier local, depuis un serveur http ou ftp, et en afficher le contenu. Si le nom du fichier commence par "http://", la page internet sera récupérée, puis affichée. Si le nom du fichier commence par "ftp://", le fichier sera récupéré depuis le serveur ftp, et affiché. Pour les fichiers du système local, le chemin doit être absolu ou relatif au chemin d'exécution du script PHP. Vous pouvez spécifier l'attribut optionnel assign qui défini une variable de template dans laquelle la sortie sera stockée plutôt qude d'être affichée (nouveau dans Smarty 1.5.0). Ne supporte pas les redirections http. Assurez vous d'inclure les slash de fin sur votre page web si nécessaire. Si la sécurité est activée, vous ne pourez récupérer les fichiers du système local que s'ils sont situés dans l'un des répertoires sécurisé ($secure_dir). {* Inclus du javascript dans votre template *} {fetch file="/export/httpd/www.domain.com/docs/navbar.js"} {* récupère les informations météo d'un autre site sur votre page *} {fetch file="http://www.myweather.com/68502/"} {* récupère les titres depuis un fichier ftp *} {fetch file="ftp://user:password@ftp.domain.com/path/to/currentheadlines.txt"} {* assigne le contenu récupéré à une variable de template *} {fetch file="http://www.myweather.com/68502/" assign="weather"} {if $weather ne ""} <b>{$weather}</b> {/if} Nom attribut Type Requis Defaut Description name chaîne de caractères Non checkbox Nom de la liste de cases à cocher values array Oui, à moins que vous n'utilisiez l'attribut option n/a Un tableau de valeurs pour les cases à cocher output array Oui, à moins que vous n'utilisiez l'attribut option n/a Un tableau de sortie pour les cases à cocher checked chaîne de caractères Non empty Les éléments cochés de la liste options associative array Oui, à moins que vous n'utilisiez values et output n/a Un tableau associatif de valeurs et sorties separator chaîne de caractères Non empty chaîne de caractère pour séparer chaque case à cocher html_checkboxes est une fonction utilisateur qui crée un groupe de cases à cocher avec les données fournies. Elle prend en compte la liste des éléments sélectionnés par défaut. Les attributs requis sont values et output, à moins que vous n'utilisiez options à la place. La sortie générée est compatible XHTML. Tous les paramètres qui ne sont pas listés ci-dessus sont affichés en tant que paires nom/valeur dans chaque balise <input> crée. index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('id_client', array(1000,1001,1002,1003)); $smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane Johnson','Charlie Brown')); $smarty->assign('client_id', 1001); $smarty->display('index.tpl'); index.tpl: {html_checkboxes values=$id_client checked=$client_id output=$nom_client separator="<br />"} index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('cust_checkboxes', array( 1001 => 'Joe Schmoe', 1002 => 'Jack Smith', 1003 => 'Jane Johnson','Charlie Brown')); $smarty->assign('client_id', 1001); $smarty->display('index.tpl'); index.tpl: {html_checkboxes name="id" options=$cust_checkboxes checked=$client_id separator="<br />"} SORTIE: (pour les deux exemples) <input type="checkbox" name="id[]" value="1000">Joe Schmoe<br /> <input type="checkbox" name="id[]" value="1001" checked="checked"><br /> <input type="checkbox" name="id[]" value="1002">Jane Johnson<br /> <input type="checkbox" name="id[]" value="1003">Charlie Brown<br /> Nom attribut Type Requis Defaut Description file chaîne de caractères Oui n/a nom/chemin des images border chaîne de caractères Non 0 Bordure de l'image height chaîne de caractères Non Hauteur de l'image actuelle Hauteur de l'image à afficher width chaîne de caractères Non Longueur de l'image actuelle Longueur de l'image à afficher basedir chaîne de caractères non racine du serveur web répertoire depuis lequel baser le calcul des chemins relatifs link chaîne de caractères non n/a lien sur lequel l'image pointe html_image est une fonction utilisateur qui génère la balise HTML pour une image. La hauteur et la longueur de l'image sont calculés automatiquement depuis le fichier image si aucune n'est spécifiée. basedir est le répertoire de base depuis lequel seront calculés les chemins relatifs. Si non spécifié, la racine du serveur web est utilisé (variable d'environnement DOCUMENT_ROOT). Si la sécurité est activée, l'image doit se situer dans un répertoire sécurisé. link est la valeur href à laquelle lier l'image. Si link est défini, une balise <a href="VALEURLINK"><a> est placée autour de l'image. html_image requiert un accès au disque dur pour lire l'image et calculer ses dimensions. Si vous n'utilisez pas un cache, il est généralement préférable d'éviter d'utiliser html_image et de laisser les balises images statiques pour de meilleures performances. index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->display('index.tpl'); index.tpl: {image file="pumpkin.jpg"} {image file="/path/from/docroot/pumpkin.jpg"} {image file="../path/relative/to/currdir/pumpkin.jpg"} SORTIE: (possible) <img src="pumpkin.jpg" border="0" width="44" height="68"> <img src="/path/under/docroot/pumpkin.jpg" border="0" width="44" height="68"> <img src="../path/relative/to/currdir/pumpkin.jpg" border="0" width="44" height="68"> Nom attribut Type Requis Defaut Description values array Oui, à moins que vous n'utilisiez l'attribut options n/a un tableau de valeurs pour les listes déroulantes output array Oui, à moins que vous n'utilisiez l'attribut options n/a Un tableau de libellés pour la liste déroulante selected chaîne de caractères/tableau Non empty Les éléments sélectionnés options Tableau associatif Oui, à moins que vous n'utilisiez option et values n/a Un tableau associatif valeur / libellé name chaîne de caractères Non empty Nom du goupe d'options html_options est une fonction utilisateur qui crée un groupe d'options avec les données fournies. Elle prend en charge les éléments sélectionnés par défaut. Les attributs requis sont values et output, à moins que vous n'utilisiez options à la place. Si la valeur donnée est un tableau, elle sera traitée comme un OPTGROUP html, et affichée. La récursivité est supportée avec OPTGROUP. La sortie est compatible XHTML. Si l'attribut optionnel name est donné, les balises <select name="groupname"></select> entoureront la liste d'options. Tous les paramètres qui ne sont pas dans la liste ci-dessus sont affichés en tant que paires nom / valeur. Ils sont ignorés si le paramètre optionnel name n'est pas donné. index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('id_client', array(1000,1001,1002,1003)); $smarty->assign('nom_client', array('Joe Schmoe','Jack Smith','Jane Johnson','Charlie Brown')); $smarty->assign('client_id', 1001); $smarty->display('index.tpl'); index.tpl: <select name=client_id> {html_options values=$id_client selected=$client_id output=$nom_client} </select> index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('cust_options', array( 1001 => 'Joe Schmoe', 1002 => 'Jack Smith', 1003 => 'Jane Johnson', 1004 => 'Charlie Brown')); $smarty->assign('client_id', 1001); $smarty->display('index.tpl'); index.tpl: <select name=client_id> {html_options options=$cust_options selected=$client_id} </select> SORTIE: (valable pour les deux exemples) <select name=client_id> <option value="1000">Joe Schmoe</option> <option value="1001" selected="selected">Jack Smith</option> <option value="1002">Jane Johnson</option> <option value="1003">Charlie Brown</option> </select> Nom attribut Type Requis Defaut Description name chaîne de caractères Non radio nom de la liste boutons radio values tableau Oui, à moins que vous n'utilisiez l'attribut options n/a Le tableau des valeurs des boutons radio output tableau Oui, à moins que vous n'utilisiez l'attribut options n/a Un tableau de libellés pour les boutons radio checked chaîne de caractères Non empty Les boutons radios sélectionnés options tableau associatif Oui, à moins que vous n'utilisiez values et outputs n/a un tableau associatif valeurs / libellés separator chaîne de caractères Non empty chaîne de séparation à placer entre les boutons radio html_radio est une fonction utilisateur qui crée des boutons radio html à partir des données fournies. Elle prend en charge les éléments sélectionnés par défaut. Les attributs requis sont values et output, à moins que vous n'utilisiez options à la place. La sortie générée est compatible XHTML. Tous les paramètres qui ne sont pas dans la liste ci dessus sont affichés en tant que paires nom / valeur dans chaque balise <input> créée. index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('id_client', array(1000,1001,1002,1003)); $smarty->assign('nom_client', array('Joe Schmoe','Jack Smith','Jane Johnson','Charlie Brown')); $smarty->assign('client_id', 1001); $smarty->display('index.tpl'); index.tpl: {html_radios values=$id_client checked=$client_id output=$nom_client separator="<br />"} index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('cust_radios', array( 1001 => 'Joe Schmoe', 1002 => 'Jack Smith', 1003 => 'Jane Johnson', 1004 => 'Charlie Brown')); $smarty->assign('client_id', 1001); $smarty->display('index.tpl'); index.tpl: {html_radios name="id" options=$cust_radios checked=$client_id separator="<br />"} SORTIE: (both examples) <input type="radio" name="id[]" value="1000">Joe Schmoe<br /> <input type="radio" name="id[]" value="1001" checked="checked"><br /> <input type="radio" name="id[]" value="1002">Jane Johnson<br /> <input type="radio" name="id[]" value="1003">Charlie Brown<br /> Nom attribut Type Requis Defaut Description prefix chaîne de caractères Non Date_ Avec quoi préfixer le nom de variable time timestamp/YYYY-MM-DD Non la date courante au format unix YYYY-MM-DD format la date / heure à utiliser start_year chaîne de caractères Non current year La première année dans la liste déroulante, soit le numéro de l'année, soit un nombre relatif à l'année courante (+/- N). end_year chaîne de caractères Non même chose que start_year La dernière année dans la liste déroulante, soit le numéro de l'année, soit un nombre relatif à l'année courante (+/- N). display_days boolean Non true Si l'on souhaite afficher les jours ou pas. display_months boolean Non true Si l'on souhaite afficher les mois ou pas. display_years boolean Non true Si l'on souhaite afficher les années ou pas. month_format chaîne de caractères Non %B le format du mois (strftime) day_format chaîne de caractères Non %02d Le format du jour (sprintf) day_value_format chaîne de caractères Non %d le format de la valeur du jour (sprintf) year_as_text boolean Non false S'il faut afficher l'année au format texte reverse_years boolean Non false Affiche les années dans l'ordre inverse field_array chaîne de caractères Non null Si un nom est donné, la liste déroulante sera affichée de telle façon que les résultats seront retournés à PHP sous la forme nom[Day] (jour), nom[Year] (année), nom[Month] (Mois). day_size chaîne de caractères Non null Ajoute un attribut size à la liste déroulante des jours. month_size chaîne de caractères Non null Ajoute un attribut size à la liste déroulante des mois. year_size chaîne de caractères Non null Ajoute un attribut size à la liste déroulante des années. all_extra chaîne de caractères Non null Ajoute des attributs supplémentaires à toutes les balises select/input. day_extra chaîne de caractères Non null Ajoute des attributs supplémentaires aux balises select/input du jour. month_extra chaîne de caractères Non null Ajoute des attributs supplémentaires aux balises select/input du mois. year_extra chaîne de caractères Non null Ajoute des attributs supplémentaires aux balises select/input de l'année. field_order chaîne de caractères Non MDY L'ordre dans lequel afficher les listes déroulantes. field_separator chaîne de caractères Non \n la chaîne de caractères affichée entre les différents champs. month_value_format chaîne de caractères Non %m Le format strftime de la valeur des mois, par défaut %m pour les numéros. html_select_date est une fonction utilisateur qui crée des listes déroulantes pour saisir la date. Elle peut afficher n'importe quel jour, mois et année. {html_select_date} SORTIE: <select name="Date_Month"> <option value="1">January</option> <option value="2">February</option> <option value="3">March</option> <option value="4">April</option> <option value="5">May</option> <option value="6">June</option> <option value="7">July</option> <option value="8">August</option> <option value="9">September</option> <option value="10">October</option> <option value="11">November</option> <option value="12" selected>December</option> </select> <select name="Date_Day"> <option value="1">01</option> <option value="2">02</option> <option value="3">03</option> <option value="4">04</option> <option value="5">05</option> <option value="6">06</option> <option value="7">07</option> <option value="8">08</option> <option value="9">09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13" selected>13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20">20</option> <option value="21">21</option> <option value="22">22</option> <option value="23">23</option> <option value="24">24</option> <option value="25">25</option> <option value="26">26</option> <option value="27">27</option> <option value="28">28</option> <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> </select> <select name="Date_Year"> <option value="2001" selected>2001</option> </select> {* le démarage et la fin de l'année peuvent être relatif à l'année courante *} {html_select_date prefix="StartDate" time=$time start_year="-5" end_year="+1" display_days=false} SORTIE: (current year is 2000) <select name="StartDateMonth"> <option value="1">January</option> <option value="2">February</option> <option value="3">March</option> <option value="4">April</option> <option value="5">May</option> <option value="6">June</option> <option value="7">July</option> <option value="8">August</option> <option value="9">September</option> <option value="10">October</option> <option value="11">November</option> <option value="12" selected>December</option> </select> <select name="StartDateYear"> <option value="1999">1995</option> <option value="1999">1996</option> <option value="1999">1997</option> <option value="1999">1998</option> <option value="1999">1999</option> <option value="2000" selected>2000</option> <option value="2001">2001</option> </select> Nom attribut Type Requis Defaut Description prefix chaîne de caractères Non Time_ Par quoi préfixer la variable. time timestamp Non current time Quel jour / heure utiliser. display_hours boolean Non true S'il faut afficher l'heure. display_minutes boolean Non true S'il faut afficher les minutes. display_seconds boolean Non true S'il faut afficher les secondes. display_meridian boolean Non true S'il faut afficher le méridian (am/pm) use_24_hours boolean Non true S'il faut utiliser l'horloge 24 heure. minute_interval integer Non 1 Intervalle des minutes dans la liste déroulante second_interval integer Non 1 Intervalle des secondes dans la liste déroulante field_array chaîne de caractères Non n/a Nom du tableau dans lequel les valeures seront stockées. all_extra chaîne de caractères Non null Ajoute des attributs supplémentaires aux balises select / input. hour_extra chaîne de caractères Non null Ajoute des attributs supplémentaires aux balises select / input de l'heure. minute_extra chaîne de caractères Non null Ajoute des attributs supplémentaires aux balises select / input des minutes. second_extra chaîne de caractères Non null Ajoute des attributs supplémentaires aux balises select / input des secondes. meridian_extra chaîne de caractères Non null Ajoute des attributs supplémentaires aux balises select / input du méridian. html_select_time est une fonction utilisateur qui crée des listes déroulantes pour saisir une heure. Elle prends en charge l'heure, les minutes, les secondes et le méridian. {html_select_time use_24_hours=true} SORTIE: <select name="Time_Hour"> <option value="00">00</option> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09" selected>09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20">20</option> <option value="21">21</option> <option value="22">22</option> <option value="23">23</option> </select> <select name="Time_Minute"> <option value="00">00</option> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09">09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20" selected>20</option> <option value="21">21</option> <option value="22">22</option> <option value="23">23</option> <option value="24">24</option> <option value="25">25</option> <option value="26">26</option> <option value="27">27</option> <option value="28">28</option> <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> <option value="32">32</option> <option value="33">33</option> <option value="34">34</option> <option value="35">35</option> <option value="36">36</option> <option value="37">37</option> <option value="38">38</option> <option value="39">39</option> <option value="40">40</option> <option value="41">41</option> <option value="42">42</option> <option value="43">43</option> <option value="44">44</option> <option value="45">45</option> <option value="46">46</option> <option value="47">47</option> <option value="48">48</option> <option value="49">49</option> <option value="50">50</option> <option value="51">51</option> <option value="52">52</option> <option value="53">53</option> <option value="54">54</option> <option value="55">55</option> <option value="56">56</option> <option value="57">57</option> <option value="58">58</option> <option value="59">59</option> </select> <select name="Time_Second"> <option value="00">00</option> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09">09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20">20</option> <option value="21">21</option> <option value="22">22</option> <option value="23" selected>23</option> <option value="24">24</option> <option value="25">25</option> <option value="26">26</option> <option value="27">27</option> <option value="28">28</option> <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> <option value="32">32</option> <option value="33">33</option> <option value="34">34</option> <option value="35">35</option> <option value="36">36</option> <option value="37">37</option> <option value="38">38</option> <option value="39">39</option> <option value="40">40</option> <option value="41">41</option> <option value="42">42</option> <option value="43">43</option> <option value="44">44</option> <option value="45">45</option> <option value="46">46</option> <option value="47">47</option> <option value="48">48</option> <option value="49">49</option> <option value="50">50</option> <option value="51">51</option> <option value="52">52</option> <option value="53">53</option> <option value="54">54</option> <option value="55">55</option> <option value="56">56</option> <option value="57">57</option> <option value="58">58</option> <option value="59">59</option> </select> <select name="Time_Meridian"> <option value="am" selected>AM</option> <option value="pm">PM</option> </select> Nom attribut Type Requis Defaut Description loop array Oui n/a Tableau de données à parcourir cols integer Non 3 Nombre de colonnes du tableau table_attr chaîne de caractères Non border="1" attributs pour la balise table tr_attr chaîne de caractères Non empty attributs pour les balises tr (les tableaux sont parcourus) td_attr chaîne de caractères Non empty attributs pour les balises td (les tableaux sont parcourus) trailpad chaîne de caractères Non &nbsp; valeur avec laquelle remplir les cellules restantes de la dernière ligne (si il y en a) html_table est une fonction utilisateur qui transforme un tableau de données dans un tabeau HTML. L'attribut cols détermine le nombre de colonne du tableau. Les attributs table_attr, tr_attr et td_attr déterminent les attributs donnés aux balises table, tr et td. Si tr_attr ou td_attr sont des tableaux, ils seront parcourus. trailpad est la valeur avec laquelle remplir les cellules restantes de la dernière ligne, s'il y en a une. index.php: require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('data',array(1,2,3,4,5,6,7,8,9)); $smarty->assign('tr',array('bgcolor="#eeeeee"','bgcolor="#dddddd"')); $smarty->display('index.tpl'); index.tpl: {html_table loop=$data} {html_table loop=$data cols=4 table_attr='border="0"'} {html_table loop=$data cols=4 tr_attr=$tr} SORTIE: <table border="1"> <tr><td>1</td><td>2</td><td>3</td></tr> <tr><td>4</td><td>5</td><td>6</td></tr> <tr><td>7</td><td>8</td><td>9</td></tr> </table> <table border="0"> <tr><td>1</td><td>2</td><td>3</td><td>4</td></tr> <tr><td>5</td><td>6</td><td>7</td><td>8</td></tr> <tr><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr> </table> <table border="1"> <tr bgcolor="#eeeeee"><td>1</td><td>2</td><td>3</td><td>4</td></tr> <tr bgcolor="#dddddd"><td>5</td><td>6</td><td>7</td><td>8</td></tr> <tr bgcolor="#eeeeee"><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr> </table> Nom attribut Type Requis Defaut Description equation chaîne de caractères Oui n/a L'opération à éxécuter format chaîne de caractères Non n/a Le format du résultat (sprintf) var numeric Oui n/a Les variables de l'opération assign chaîne de caractères Non n/a Variable de template dans laquelle la sortie sera assignée [var ...] numeric Oui n/a Valeurs des variables de l'opération math autorise les designers de templates à effectuer des opérations dans le template. Toute valeur numérique peut être utilisée dans une opération, et le résultat sera affiché à la place des balises "equation". Les variables utilisées dans l'opération sont passées en tant que paramètre, et peuvent être des variables de templates ou des valeurs statiques. +, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, srans et tan sont tous des opérateurs valides. Voir la documentation PHP pour plus d'informations sur ces fonctions mathématiques. Si vous spécifiez l'attribut assign, la sortie sera assignée à la variable donnée plutôt que d'être directement affichée. math est une fonction coûteuse en terme de performances, du fait qu'elle utilise la fonction PHP eval (). Effectuer les calculs dans votre code PHP est beaucoup plus efficient, donc, chaque fois que possible, effectuez vos calculs directement dans PHP et assignez le résultat au template. Evitez coût que coût les appels répétitifs à la fonction math, comme on pourait le faire une une boucle section. {* $height=4, $width=5 *} {math equation="x + y" x=$height y=$width} SORTIE: 9 {* $row_height = 10, $row_width = 20, #col_div# = 2, assigned in template *} {math equation="height * width / division" height=$row_height width=$row_width division=#col_div#} SORTIE: 100 {* vous pouvez utiliser des parenthèses *} {math equation="(( x + y ) / z )" x=2 y=10 z=2} SORTIE: 6 {* vous pouvez définir un format sprintf pour l'affichage *} {math equation="x + y" x=4.4444 y=5.0000 format="%.2f"} SORTIE: 9.44 Nom attribut Type Requis Defaut Description address chaîne de caractères Oui n/a l'adresse email text chaîne de caractères Non n/a le texte à afficher, par défaut l'adresse email encode chaîne de caractères Non none Comment encoder l'adresse email. none, hex et javascript sont des valeurs correctes. cc chaîne de caractères Non n/a Les adresses email en copie (Cc). Séparez les entrées par une virgule. bcc chaîne de caractères Non n/a Les adresses email en copie cachées (Bcc). Séparez les entrées par une virgule. subject chaîne de caractères Non n/a Sujet de l'email. newsgroups chaîne de caractères Non n/a newsgroup ou poster le message. Séparez les entrées par une virgule. followupto chaîne de caractères Non n/a Adresses ou transmettre le message. Séparez les entrées par une virgule. extra chaîne de caractères Non n/a Toute information que vous souhaitez passer au lien, comme par exemple une classe css. mailto crée un lien mailto automatiquement encodé (optionnel). L'encodage rend la tâche de récupération des e-mails sur votre site plus difficiles aux "web spiders". javascript n'est certainement pas la forme d'encodage la plus robuste. Vous pouvez également utiliser un encodage hexadécimal. {mailto address="me@domain.com"} {mailto address="moi@domaine.com" text="send me some mail"} {mailto address="moi@domaine.com" encode="javascript"} {mailto address="moi@domaine.com" encode="hex"} {mailto address="moi@domaine.com" subject="Hello to you!"} {mailto address="moi@domaine.com" cc="you@domain.com,they@domain.com"} {mailto address="moi@domaine.com" extra='class="email"'} SORTIE: <a href="mailto:moi@domaine.com" >moi@domaine.com</a> <a href="mailto:moi@domaine.com" >send me some mail</a> <SCRIPT language="javascript">eval(unescape('%64%6f%63%75%6d%65%6e%74%2e%77%72%6 9%74%65%28%27%3c%61%20%68%72%65%66%3d%22%6d%61%69%6c%74%6f%3a%6d%65%40%64%6f%6d% 61%69%6e%2e%63%6f%6d%22%20%3e%6d%65%40%64%6f%6d%61%69%6e%2e%63%6f%6d%3c%2f%61%3e %27%29%3b'))</SCRIPT> <a href="mailto:%6d%65@%64%6f%6d%61%69%6e.%63%6f%6d" >&#x6d;&#x65;&#x40;&#x64;& #x6f;&#x6d;&#x61;&#x69;&#x6e;&#x2e;&#x63;&#x6f;&#x6d;</a> <a href="mailto:moi@domaine.com?subject=Hello%20to%20you%21" >moi@domaine.com</a> <a href="mailto:moi@domaine.com?cc=you@domain.com%2Cthey@domain.com" >moi@domaine.com</a> <a href="mailto:moi@domaine.com" class="email">moi@domaine.com</a> popup est une intégration de overLib, une librairie capable de réaliser des fenêtres surgissantes. (nous parlerons de "popup"). Ce type de fenêtre est utilisé pour apporter des informations contextuelles, comme des infobulles d'aides ou astuces. popup_init doit être appelé une fois, en début de page si vous comptez utiliser la fonction popup. overLib à été écrit par Erik Bosrup. Le site d'overlib est situé à l'adresse http://www.bosrup.com/web/overlib/. Comme dans Smarty 2.1.2, overLib n'est PAS fournie dans la distribution. Téléchargez overLib, déposez overlib.js dans votre arborescence web et indiquez le chemin relatif à ce fichier dans l'attribut src de popup_init. {* popup_init doit être appelé une fois en début de page. *} {popup_init src="/javascripts/overlib.js"} Nom attribut Type Requis Defaut Description text chaîne de caractères Oui n/a le texte/code html à afficher dans la popup trigger chaîne de caractères Non onMouseOver L'évènement utilisé pour rendre la popup active, onMouseOver ou onClick. sticky boolean Non false Rends la popup active jusqu'a ce qu'elle soit explicitement fermée. caption chaîne de caractères Non n/a Défini le libellé du titre fgcolor chaîne de caractères Non n/a couleur interne de la popup bgcolor chaîne de caractères Non n/a couleur de la bordure de la popup textcolor chaîne de caractères Non n/a couleur du texte à l'intérieur de la popup capcolor chaîne de caractères Non n/a couleur du libellé de la popup closecolor chaîne de caractères Non n/a couleur du texte de fermeture textfont chaîne de caractères Non n/a la police à utiliser dans le texte principal captionfont chaîne de caractères Non n/a la police à utiliser dans le libellé closefont chaîne de caractères Non n/a la police pour le texte de fermeture textsize chaîne de caractères Non n/a taille de la police texte prinicpal captionsize chaîne de caractères Non n/a taille de la police du libellé closesize chaîne de caractères Non n/a taille de la police du bouton "fermer" width integer Non n/a Longeur de la popup height integer Non n/a Hauteur de la popup left boolean Non false la popup va à gauche de la souris right boolean Non false la popup va à droite de la souris center boolean Non false la popup est centrée par rapport à la position de la souris above boolean Non false la popup est au dessus de la souris. NOTE: possible uniquement si la hauteur est définie below boolean Non false la popup apparait en dessous de la souris border integer Non n/a rends la bordure de la popup plus épaisse ou plus fine offsetx integer Non n/a A quelle distance du curseur la popup apparaitra , horizontalement. offsety integer Non n/a A quelle distance du curseur la popup apparaitra , verticalement. fgbackground url to image Non n/a Une image à utiliser à la place de la couleur de fonds dans la popup bgbackground url to image Non n/a Image à utiliser à la place de la bordure de la popup. NOTE: vous veillerez à définir bgcolor à "" ou la couleur apparaitra de même. NOTE: Lorsque vous avez un lien de fermeture, Netscape effectuera un nouveau rendu des cellules du tableau, affichant mal les éléments closetext chaîne de caractères Non n/a définit le texte de fermeture par autre chose que "Close" noclose boolean Non n/a N'affiche pas le bouton "Close" pour les fenêtres "collantes". status chaîne de caractères Non n/a défini le texte de la barre de statut du navigateur autostatus boolean Non n/a Défini le texte de la barre de statut au contenu de la popup. NOTE: Ecrase l'attribut status. autostatuscap chaîne de caractères Non n/a Défini le texte de la barre de statut au libellé de la popup. NOTE: Ecrase l'attribut status. inarray integer Non n/a indique à overLib de lire le texte à cet index dans le tableau ol_text, situé dans overlib.js. Ce paramètre peut être utilisé à la place de text. caparray integer Non n/a indique à overlib de lire le libellé depuis le tableau ol_caps capicon url Non n/a affiche l'image spécifiée avant le libellé de la popup snapx integer Non n/a Aligne la popup sur une grille horizontale snapy integer Non n/a Aligne la popup sur une grille verticale fixx integer Non n/a vérrouille la popup à une position horizontale. Note: remplace les autres paramètres de position horizontale fixy integer Non n/a vérouille la popup à une position verticale Note: remplace les autres paramètres de position verticale background url Non n/a défini l'image à utiliser plutôt que le tableau de fond padx integer,integer Non n/a écarte l'image de fond du reste des éléments avec un espace horizontal, pour le positionnement du texte. Note: c'est un attribut à deux paramètres. pady integer,integer Non n/a écarte l'image de fond du reste des éléments avec un espace vertical, pour le positionnement du texte. Note: c'est un attribut à deux paramètres. fullhtml boolean Non n/a vous autorise à placer du code html en tant que contenu de la popup. Le code html est attendu dans l'attribut text. frame chaîne de caractères Non n/a contrôle la popup dans un cadre différent. Voir la documentation d'overlib pour plus de détails sur cette fonction. timeout chaîne de caractères Non n/a Appelle la fonction javascript spécifiée et prends sa valeur de retour comme texte devant être affiché dans la popup. delay integer Non n/a la popup se comporte comme une infobulle. Elle disparaitra au bout d'un certain délai, en millisecondes. hauto boolean Non n/a Détermine automatiquement si la popup doit être à gauche ou à droite de la souris vauto boolean Non n/a Détermine automatiquement si la popup doit être au-dessus ou au-dessous de la souris popup est utilisé pour créer une fenêtre popup javascript. {* popup_init doit être appelé en haut de votre page *} {popup_init src="/javascripts/overlib.js"} {* création d'un lien avec une popup qui apparait sur l'évènement onMouseOver *} <A href="mypage.html" {popup text="Ce lien vous amène sur ma page!"}>mypage</A> {* vous pouvez utiliser du html, des liens, etc dans vos popup *} <A href="mypage.html" {popup sticky=true caption="mypage contents" text="<UL><LI>links<LI>pages<LI>images</UL>" snapx=10 snapy=10}>mypage</A> SORTIE: (allez sur le site officiel de Smarty pour des exemples.) Nom attribut Type Requis Defaut Description style chaîne de caractères Non n/a style prédéfini indent number Non 0 Taille de l'indentation pour chaque ligne indent_first number Non 0 Taille de l'indentation de la première ligne indent_char chaîne de caractères Non (single space) Le caractère (ou la chaîne) à utiliser pour indenter wrap number Non 80 A combien de caractères doit on ajuster chaque ligne wrap_char chaîne de caractères Non \n Le caractère (ou chaîne de caractères) avec lequel terminer les lignes wrap_cut boolean Non false Si true, wrap réduira les lignes au caractère exact au lieu d'ajuster à la fin d'un mot assign chaîne de caractères Non n/a Le nom de la variable PHP dans laquelle la sortie sera assignée textformat est une fonction de bloc utilisée pour formater du texte. Elle nettoie la chaîne de ses espaces et caractères spéciaux, puis formate les paragraphes en ajustant ces derniers à une certaine limite, puis en indentant les lignes. Vous pouvez soit utiliser un style prédéfini, soit définir explicitement chaque attribut. Actuellement, seul le style prédéfini "email" est disponible. {textformat wrap=40} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} SORTIE: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {textformat wrap=40 indent=4} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} SORTIE: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {textformat wrap=40 indent=4 indent_first=4} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} SORTIE: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {textformat style="email"} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} SORTIE: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. Les fichiers de configuration sont un moyen interressant pour gérer des variables depuis un seul et même fichier. L'exemple le plus courant étant le schéma de couleurs du template. Normalement, pour changer le schéma de couleur d'une application, vous devriez aller dans chaque template et changer la couleur des éléments (ou les classes css). Avec un fichier de configuration, il vous est possible de conserver la couleur dans un seul endroit, puis de la mettre à jour une seule fois. # variables globales titrePage = "Menu principal" bodyBgColor = #000000 tableBgColor = #000000 rowBgColor = #00ff00 [client] titrePage = "Infos client" [Login] titrePage = "Login" focus = "utilisateur" Intro = """Une valeur qui tient sur plusieur lignes. Vous devez la placer entre trois guillemets.""" # hidden section [.Database] host=mon.domaine.com db=ADDRESSBOOK user=php-user pass=foobar Les valeurs des variables de fichiers de configuration peuvent être entre guillemets, sans que cela soit nécessaire. Si vous vouler utiliser des valeurs sur plusieurs lignes, vous devrez les entourer de triples guillemets ("""). Vous pouvez insérer des commentaires dans les fichiers de configuration en utilisant une syntaxe quelquonque, non valide. Nous recommandons l'utilisation de # (dièse) en début de ligne. Cet exemple de fichier de configuration contient deux sections. Les noms des sections sont entourés de crochets []. Les noms de section peuvent être des chaînes, ne contenant aucun des symboles [ et ]. Dans notre exemple, les 4 variables du début sont des variables dites globales, qui ne sont pas contenue dans une section. Ces variables sont toujours chargées depuis le fichier de configuration. Si une section est chargée, alors toutes les variables de cette section ainsi que les variables globales sont chargées. Si une variable existe à la fois en tant que globale et à la fois en tant que variable de section, la variable de section est prioritaire. Si vous appelez deux variables dans une même section de la même façon, la dernière déclarée prime. Les fichiers de configuration sont chargés dans le template grâce à la fonction config_load. Vous pouvez masquer des variables ou des sections entières en préfixant le nom de la variable ou le nom de la section avec une virgule. Ce procédé est utile si votre application récupère ses données depuis plusieurs fichiers de configuration et récupère des données sensibles dont vos templates n'ont pas besoin. Si des tiers éditent des templates, vous êtes sûr que ces derniers n'accèderont pas à ces données de configuration en les chargeant depuis le template. Il existe une console de débogage dans Smarty. La console vous indique toutes les variables incluses, assignées et chargées depuis un fichier de configuration pour le template courant. Un template appelé "debug.tpl" est inclus dans la distribution de Smarty. Si besoin, vous pouvez définir $debug_tpl de façon à ce que ce dernier contienne le chemin du template à utiliser(dans SMARTY_DIR par defaut). Lorsque vous chargez la page, une console javascript est censée surgir et vous donner les noms de toutes les variables inclues et assignées dans votre page courante. Pour voir toutes les variables d'un template particulier, voir la fonction {debug}. Pour désactiver la console de débogage, définissez $debugging à false. Vous pouvez également temporairement activer le débogage en indiquant SMARTY_DEBUG dans l'url si tant est que l'option $debugging_ctrl soit activée. La console de débogage ne fonctionne pas si vous utilisez l'API fetch (), mais seulement lorsque vous utilisez display (). C'est en effet un jeu d'instructions javascripts à la fin du template qui déclenchent l'ouverture de la fenêtre. Si vous n'aimez pas javascript, vous pouvez modifier debug.tpl pour formater les données de la façon qui vous conviendra le mieux. Les données de débogage ne sont pas mises en cache et les informations de debug.tpl ne sont pas incluses dans la sortie de la console de débogage. Le temps de chargement des templates et des fichiers de configuration sont indiqués en secondes.