From 392ae0c522c9cee627588b06595a2695bda7299c Mon Sep 17 00:00:00 2001 From: yannick Date: Thu, 1 Dec 2005 20:28:15 +0000 Subject: [PATCH] sync with EN --- .../language-function-capture.xml | 57 ++++++++++-------- .../language-function-config-load.xml | 28 +++++---- .../language-function-foreach.xml | 45 +++++++------- .../language-function-if.xml | 20 ++++++- .../language-function-include-php.xml | 31 +++++----- .../language-function-include.xml | 58 +++++++++++-------- .../language-function-insert.xml | 50 ++++++++-------- .../language-function-ldelim.xml | 37 ++++++++++-- .../language-function-literal.xml | 31 +++++----- .../language-function-php.xml | 35 +++++++++-- 10 files changed, 246 insertions(+), 146 deletions(-) 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 3a91522a..e7419ae8 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-capture.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-capture.xml @@ -1,8 +1,23 @@ - + + {capture} + + + {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 + où "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. + + @@ -37,27 +52,6 @@ - - {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 - où "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. - - - Note technique - - 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. - - Faîtes attention lorsque vous interceptez la sortie de commandes @@ -90,6 +84,23 @@ ]]> + + + Capturer le contenu dans une variable + Cet exemple démontre également la fonction + {popup} + + +help +]]> + + + Voir aussi 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 b47eff7b..3e104a75 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,8 +1,17 @@ - + + {config_load} + + + {config_load} est utiliseé pour charger des variables + #variables# + depuis un fichier de configuration + dans un template. + + @@ -65,19 +74,13 @@ - - {config_load} est utiliseé pour charger des variables #variables# - depuis un fichier de configuration - dans un template. - fonction {config_load} example.conf - et le template {#pageTitle#|default:"No title"} @@ -128,7 +131,7 @@ pageTitle = "Info personnalis fonction {config_load} avec section {#pageTitle#} @@ -146,6 +149,11 @@ pageTitle = "Info personnalis + + Voir aussi $config_overwrite + pour les tableaux de variables de configuration. + + Voir aussi les fichiers de configuration, diff --git a/docs/fr/designers/language-builtin-functions/language-function-foreach.xml b/docs/fr/designers/language-builtin-functions/language-function-foreach.xml index 0cfc863a..d910f7f3 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-foreach.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-foreach.xml @@ -1,8 +1,31 @@ - + + {foreach},{foreachelse} + + + 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. + + @@ -52,26 +75,6 @@ - - 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. - foreach diff --git a/docs/fr/designers/language-builtin-functions/language-function-if.xml b/docs/fr/designers/language-builtin-functions/language-function-if.xml index fa3b3068..bee85944 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-if.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-if.xml @@ -1,6 +1,7 @@ - + + {if},{elseif},{else} @@ -10,9 +11,10 @@ moteur de template. Tous les {if} doivent être utilisés de pair avec un {/if}. {else} et {elseif} sont également - des balises autorisées. Toutes les conditions PHP sont reconnues, + des balises autorisées. Toutes les conditions et fonctions PHP sont reconnues, comme ||, or, - &&, and, etc. + &&, and, + is_array(), etc. La liste suivante présente les opérateurs reconnus, qui doivent être entourés d'espaces. @@ -203,6 +205,18 @@ doivent {if $var is even by 3} ... {/if} + +{* ------- if avec des fonctions PHP ------- *} +{* check for array. *} +{if is_array($foo) } +..... +{/if} + +{* vérification du tableau. *} +{if isset($foo) } +..... +{/if} + ]]> 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 205db85a..37649dd0 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,8 +1,24 @@ - + + {include_php} + + + Notes techniques + + {include_php} est presque obsolète dans Smarty. Vous pouvez obtenir des résultats + équivalents en utilisant les fonctions utilisateur. + La seule raison qui peut vous pousser à utiliser {include_php} est que + vous avez besoin de mettre une de vos fonction en quarantaine vis à vis du + répertoire des plugins ou de votre application. + Reportez-vous à l'exemple des + templates composants + pour plus de détails. + + + @@ -46,19 +62,6 @@ - - Technical Note - - {include_php} est presque obsolète dans Smarty. Vous pouvez obtenir des résultats - équivalents en utilisant les fonctions utilisateur. - La seule raison qui peut vous pousser à utiliser {include_php} est que - vous avez besoin de mettre une de vos fonction en quarantaine vis à vis du - répertoire des plugins ou de votre application. - Reportez vous à l'exemple des templates composants - pour plus de détails. - - Les balises {include_php} sont utilisées pour inclure directement diff --git a/docs/fr/designers/language-builtin-functions/language-function-include.xml b/docs/fr/designers/language-builtin-functions/language-function-include.xml index 482b8f9a..bff904d8 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-include.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-include.xml @@ -1,8 +1,23 @@ - + + {include} + + + 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. + + @@ -45,18 +60,6 @@ - - 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. - fonction {include} @@ -66,12 +69,12 @@ {$title} - {include file="page_header.tpl"} + {include file='page_header.tpl'} {* body of template goes here *} - {include file="/$tpl_name.tpl"} <-- remplace $tpl_name avec la valeur + {include file='$tpl_name.tpl'} <-- remplace $tpl_name avec la valeur - {include file="page_footer.tpl"} + {include file='page_footer.tpl'} ]]> @@ -88,11 +91,11 @@ fonction {include}, passage de variables où header.tpl est : @@ -116,13 +119,13 @@ - {include file="nav.tpl" assign="navbar"} - {include file="header.tpl" title="Main Menu" table_bgcolor="#c0c0c0"} + {include file='nav.tpl' assign=navbar} + {include file='header.tpl' title='Main Menu' table_bgcolor='#c0c0c0'} {$navbar} {* body of template goes here *} - {include file="footer.tpl" logo="http://my.example.com/logo.gif"} + {include file='footer.tpl' logo='http://my.example.com/logo.gif'} {$navbar} ]]> @@ -138,16 +141,21 @@ diff --git a/docs/fr/designers/language-builtin-functions/language-function-insert.xml b/docs/fr/designers/language-builtin-functions/language-function-insert.xml index 49a42873..a0487f3e 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-insert.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-insert.xml @@ -1,8 +1,18 @@ - + + {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 est activé. + Les balises {insert} seront exécutées à chaque appel du template. + + @@ -52,29 +62,22 @@ - - 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 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. + 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. + depuis un fichier de configuration), + et à besoin d'un appel de fonction pour récupérer le contenu du bandeau. - Fonction insert + Fonction {insert} - {* exemple de récupération d'un bandeau publicitaire *} - {insert name="getBanner" lid=#emplacement_bandeau# sid=#id_site#} +{* exemple de récupération d'un bandeau publicitaire *} +{insert name="getBanner" lid=#emplacement_bandeau# sid=#id_site#} @@ -82,27 +85,28 @@ 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 + 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. + 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 + {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é. + 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, + 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. + chemin doit être absolu ou relatif à + $trusted_dir. Lorsque "security" est actif, le script doit être situé dans $trusted_dir. @@ -110,14 +114,14 @@ 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. + directement depuis votre fonction {insert}. Note technique 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 + 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, 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 1b009072..aab1d817 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml @@ -1,17 +1,18 @@ - + + {ldelim},{rdelim} - ldelim et rdelim sont utilisés pour afficher les délimiteurs en tant - que tels, dans notre cas, "{" ou "}". Vous pouvez toujours utiliser échapper + les délimiteurs en tant que tels, dans notre cas, "{" ou "}". Vous pouvez toujours utiliser {literal}{/literal} pour échapper des blocks de texte. Voir aussi {$smarty.ldelim}. - ldelim, rdelim + {ldelim}, {rdelim} + + Un autre exemple avec du javascript + + + function foo() {ldelim} + ... code ... + {rdelim} + +]]> + + + affichera : + + + + function foo() { + .... code ... + } + +]]> + + Voir aussi la - désactivation l'analyse de Smarty. + désactivation de l'analyse de Smarty. - + - + + {literal} @@ -10,28 +11,28 @@ 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. Si vous voulez inclure des tags de template - dans votre block litéral, utilisez plutôt {ldelim}{rdelim} pour échapper les délimiteurs individuels. - Balises literal + Balises {literal} - + {/literal} @@ -62,4 +63,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file 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 79cc6eda..5201d12a 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-php.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-php.xml @@ -1,6 +1,7 @@ - + + {php} @@ -11,17 +12,39 @@ nécessaire. - balises php - + Balises {php} + + + Notes techniques + + Pour accéder aux variables PHP dans les blocks {php}, vous devriez avoir besoin + d'utiliser le mot clé PHP global. + + + + + Balises {php} avec le mot clé global + + + + + Voir aussi $php_handling,