diff --git a/docs/fr/designers/language-basic-syntax/language-escaping.xml b/docs/fr/designers/language-basic-syntax/language-escaping.xml index 798f9dac..cff4519e 100644 --- a/docs/fr/designers/language-basic-syntax/language-escaping.xml +++ b/docs/fr/designers/language-basic-syntax/language-escaping.xml @@ -1,6 +1,6 @@ - + Désactiver l'analyse de Smarty @@ -10,24 +10,23 @@ est que ces langages utilisent les caractères { et }, qui sont aussi les délimiteurs Smarty par défaut. - + Le plus simple pour éviter une telle situation est de placer vos codes Javascript et CSS dans des fichiers séparés, puis d'utiliser les méthodes standards HTML pour y accéder. - + Inclure du contenu tel quel est possible en utilisant les blocs {literal} .. {/literal}. Similairement à l'utilisation d'entités HTML, vous pouvez utiliser {ldelim} et {rdelim}, ou {$smarty.ldelim} et {$smarty.rdelim} pour + linkend="language.function.ldelim">{rdelim}, ou {$smarty.ldelim} pour afficher les délimiteurs. - + Il est souvent plus simple de modifier les délimiteurs de Smarty : $left_delimiter et @@ -49,7 +48,7 @@ $smarty->display('example.tpl'); ]]> - Ou example.tpl est: + Où example.tpl est: + + Voir aussi + les modifieurs d'échappement. + - + Fonctions @@ -27,20 +27,23 @@ - Les fonctions natives et les fonctions utilisateurs ont toutes deux la même + 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. + linkend="language.function.if">{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 + 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. + +--> \ No newline at end of file diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml b/docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml index 63531101..93a968bb 100644 --- a/docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml +++ b/docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml @@ -1,16 +1,18 @@ - + Variables insérées dans des chaînes de caractères - Smarty est capable d'interpréter les variables insérées à l'intérieur de + Smarty est capable d'interpréter les + variables assigné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 (`). Vous ne pouvez jamais - insérer de modifieurs, ils doivent toujours être appliquer à l'extérieur des - guillemets. + insérer de modifieurs, ils doivent toujours être appliquer à + l'extérieur des guillemets. Syntaxe d'insertion de variables dans des chaînes @@ -36,6 +38,7 @@ EXEMPLE PRATIQUE: escape. + +--> \ No newline at end of file diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml b/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml index 0f43d147..2bcbf4da 100644 --- a/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml +++ b/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml @@ -1,17 +1,18 @@ - + Variables Les variables de template commence par un signe dollar ($). Elles peuvent contenir des nombres, des lettres et des underscores, tout - comme une variable PHP. Vous pouvez référencer des tableaux indexés + comme une variable PHP. Vous pouvez référencer des tableaux indexés numériquement ou non. Vous pouvez aussi référencer des propriétés d'objet - ainsi que des méthodes. Les variables des fichiers de configuration sont + ainsi que des méthodes. Les variables des fichiers de + configuration sont une exception à la synthaxe utilisant un signe dollar. Elles peuvent être référencées en les entourant du signe dièse (#) ou - avec la variable spéciale $smarty.config. + avec la variable spéciale $smarty.config. Variables @@ -26,6 +27,7 @@ {#foo#} <-- affiche la variable du fichier de configuration "foo" {$smarty.config.foo} <-- synonyme pour {#foo#} {$foo[bar]} <-- synthaxe uniquement valide dans une section de boucle, voir {section} +{assign var=foo value="baa"}{$foo} <-- affiche "baa", voir {assign} Plusieurs autres combinaisons sont autorisées @@ -45,6 +47,7 @@ Plusieurs autres combinaisons sont autoris les variables de configuration. + +--> \ No newline at end of file diff --git a/docs/fr/designers/language-builtin-functions/language-function-capture.xml b/docs/fr/designers/language-builtin-functions/language-function-capture.xml index b3b5f79b..7cd03b8f 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-capture.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-capture.xml @@ -1,48 +1,49 @@ - + capture - - - - - - - - - - Attribut - Type - Requis - Defaut - Description - - - - - name - string - non - default - Le nom du bloc capturé - - - assign - string - non - n/a - Le nom de la variable à laquelle la sortie sera assignée - - - - + + + + + + + + + + Attribut + Type + Requis + Defaut + Description + + + + + name + string + non + default + Le nom du bloc capturé + + + assign + string + non + n/a + Le nom de la variable à laquelle la sortie sera assignée + + + + 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 + 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 @@ -59,8 +60,9 @@ - Faites attention lorsque vous interceptez la sortie de commandes - insert. Si vous avez configuré le cache pour que ce + Faîtes 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. @@ -76,17 +78,25 @@ {include file="get_banner.tpl"} {/capture} {if $smarty.capture.banner ne ""} - - - {$smarty.capture.banner} - - + + + {$smarty.capture.banner} + + {/if} ]]> + + Voir aussi + {eval}, + {fetch}, + fetch() et + {assign}. + + +--> \ No newline at end of file diff --git a/docs/fr/designers/language-builtin-functions/language-function-config-load.xml b/docs/fr/designers/language-builtin-functions/language-function-config-load.xml index f105b802..fa064bf7 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-config-load.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-config-load.xml @@ -1,6 +1,6 @@ - + config_load @@ -92,7 +92,7 @@ - Les fichiers de configuration peuvent contenir des sections. + Les fichiers de configuration peuvent contenir des sections. Vous pouvez charger des variables d'une section donnée avec le nouvel attribut section. @@ -126,9 +126,11 @@ - Voir aussi - les fichiers de configuration et - les variables de configuration. + Voir aussi + les fichiers de configuration, + les variables de configuration, + get_config_vars() et + config_load(). - + foreach,foreachelse @@ -53,22 +53,22 @@ - Les boucles foreach sont une alternative aux boucles + 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 + 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, + {foreach} doit être composés exclusivement de lettres, chiffres et underscores, selon vos préférences. Les boucles - foreach peuvent être imbriquées. + {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 + 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. @@ -132,7 +132,8 @@ portable: 760-1234
Les boucles Foreach ont également leurs propres variables qui gèrent les propriétés - de foreach. Elles sont indiquées par : {$smarty.foreach.foreachname.varname} + de foreach. Elles sont indiquées par : + {$smarty.foreach.foreachname.varname} où foreachname est le nom spécifié par l'attribut name de foreach. diff --git a/docs/fr/designers/language-builtin-functions/language-function-include-php.xml b/docs/fr/designers/language-builtin-functions/language-function-include-php.xml index 41f61690..024e2c6b 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-include-php.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-include-php.xml @@ -1,6 +1,6 @@ - + include_php @@ -62,13 +62,16 @@ 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 + 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. + fichier PHP à inclure, relatif à $trusted_dir, ou absolu. - include_php est un moyen agréable pour gérer des "composants templates", + 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 @@ -127,6 +130,15 @@ ]]> + + + Voir aussi + {include}, + {php}, + {capture}, les + ressources de template et les + "composants templates" + - + include @@ -46,16 +46,16 @@ - Les balises "include" sont utilisées pour inclure des templates à + 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 + 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} sera stockée plutôt qu'affichée. fonction include @@ -76,11 +76,14 @@ fonction include, passage de variables + +{include file="footer.tpl" logo="http://mon.example.com/logo.gif"} +]]> + Utilisez la syntaxe fonction include, exemple de ressource template - + + +{include file="db:header.tpl"} +]]> + + + Voir aussi + {include_php}, + {php}, + les ressources de template et + les templates composants. + - + insert @@ -53,9 +53,10 @@ - Les balises insert fonctionnent à peu près comme les balises include, + 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é. + le cache est activé. Les balises insert seront exécutées à chaque appel du template. @@ -70,10 +71,11 @@ fonction pour récupérer le contenu du bandeau. - function insert + Fonction insert {* exemple de récupération d'un bandeau publicitaire *} - {insert name="getBanner" lid=#emplacement_bandeau# sid=#id_site#} + {insert name="getBanner" lid=#emplacement_bandeau# sid=#id_site#} + Dans cet exemple, nous utilisons le nom getBanner et lui passons les @@ -101,8 +103,9 @@ 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. + 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 diff --git a/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml b/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml index 50d79e4e..18c40b8b 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml @@ -1,6 +1,6 @@ - + ldelim,rdelim @@ -8,8 +8,7 @@ que tels, dans notre cas, "{" ou "}". Vous pouvez toujours utiliser {literal}{/literal} pour échapper des blocks de texte. - Voir aussi {$smarty.ldelim} - et {$smarty.rdelim}. + Voir aussi {$smarty.ldelim}. ldelim, rdelim diff --git a/docs/fr/designers/language-builtin-functions/language-function-literal.xml b/docs/fr/designers/language-builtin-functions/language-function-literal.xml index a23e3169..dfed6f99 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-literal.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-literal.xml @@ -1,10 +1,10 @@ - + literal - Les balises "literal" permettent à un bloc de données d'être pris tel + 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é diff --git a/docs/fr/designers/language-builtin-functions/language-function-php.xml b/docs/fr/designers/language-builtin-functions/language-function-php.xml index f06ade90..f9bdbed2 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-php.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-php.xml @@ -1,10 +1,10 @@ - + php - Les balises PHP permettent de rajouter du code PHP directement dans le + 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 @@ -24,6 +24,7 @@ Voir aussi + $php_handling, {include_php}, {include} et les templates composantes. diff --git a/docs/fr/designers/language-builtin-functions/language-function-section.xml b/docs/fr/designers/language-builtin-functions/language-function-section.xml index 74f876f9..8f90042f 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-section.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-section.xml @@ -1,6 +1,6 @@ - + section, sectionelse @@ -79,16 +79,16 @@ 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 + {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, + 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 + la variable entre crochets. {sectionelse} est exécuté lorsqu'aucune valeur n'est trouvée dans la variable à parcourir. @@ -267,7 +267,8 @@ e-mail: jane@myexample.com

Les sections ont leur propre variable de gestion des propriétés. - Elles sont de la forme: {$smarty.section.nomSection.nomVariable} + Elles sont de la forme: + {$smarty.section.sectionname.varname} NOTE: Depuis Smarty 1.5.0, la syntaxe pour les propiétés des sections @@ -287,7 +288,8 @@ e-mail: jane@myexample.com

Note technique 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 + fonctionne de la même façon que iteration, à l'exception qu'il commence par 0 plutôt que par 1. @@ -388,8 +390,10 @@ e-mail: jane@myexample.com

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, + 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. @@ -502,7 +506,8 @@ e-mail: jane@myexample.com

rownum 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 + commence par 1. C'est un alias de iteration, ils fonctionnent de façon identique. @@ -626,6 +631,11 @@ e-mail: jane@myexample.com

]]> + + Voir aussi + {foreach} et + $smarty.section. +