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 98d8cbe4..41d55a2f 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} @@ -8,13 +8,13 @@ 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 + {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 plugins/ + ou de votre application. Reportez-vous à l'exemple des + templates composants pour plus de détails. @@ -47,7 +47,7 @@ once boléen Non - true + &true; Inclure plusieurs fois ou non le fichier PHP si plusieurs demandes d'inclusions sont faîtes. @@ -64,33 +64,35 @@ - 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. + 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. 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é + 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 + 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. + L'objet Smarty est disponible en tant que $this dans le script PHP inclus. Fonction {include_php} - load_nav.php + Le template load_nav.php assign('sections',$sql->record); ]]> - Où index.tpl est : + Où le template est : {$curr_section.name}
{/foreach} ]]> @@ -121,11 +123,11 @@ $this->assign('sections',$sql->record); Voir aussi - {include}, - {php}, - {capture}, les + {include}, + {php}, + {capture}, les ressources de template et les - "composants templates". + composants de templates. 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 dc3454a9..d0d0e07e 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-include.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-include.xml @@ -1,31 +1,56 @@ - + {include} - 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 - '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. - - - Toutes les valeurs des variables assignées sont restaurées lorsque - le template inclus est terminé. Ceci signifie que vous pouvez utiliser - toutes les variables d'un template inclus dans le template qui l'inclut. - Mais les modifications des variables dans le template inclus ne sont pas - visibles dans le template qui l'inclut après l'instruction {include}. + template inclus. + + + La balise {include} doit contenir l'attribut + file qui contient le chemin vers la ressource de + template. + + + + La définition de l'attribut optionnel assign + spécifie la variable de template assignée à la sortie de + {include} au lieu d'être affichée. Similaire à + {assign}. + + + + Les variables peuvent être passées à des templates inclus comme + attributs. + Toutes les variables explicitement passées à un template inclus + ne sont disponibles que dans le contexte du fichier inclus. + Les attributs de variables écrasent les variables courantes de template, + dans le cas où les noms sont les mêmes. + + + + Toutes les valeurs de variables assignées sont restaurées une fois le contexte + du template inclus refermés. Ceci signifie que vous pouvez utiliser toutes les + variables depuis un template inclus dans le template inclus. Mais les modifications + faites aux variables dans le template inclus ne sont pas visibles dans le template + incluant, parès l'instruction {include} statement. + + + + Utilisez la synthaxe pour les + ressources de template aux fichiers + {include} en dehors du dossier + $template_dir. + + + @@ -69,9 +94,9 @@ - fonction {include} + Exemple avec {include} - {$title} @@ -79,8 +104,9 @@ {include file='page_header.tpl'} - {* body of template goes here *} - {include file='$tpl_name.tpl'} <-- remplace $tpl_name avec la valeur + {* Le corps du template va ici, la variable $tpl_name est remplacé par + une valeur, e.g.'contact.pl' *} + {include file='$tpl_name.tpl'} {include file='page_footer.tpl'} @@ -88,32 +114,26 @@ ]]> - - 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. - - fonction {include}, passage de variables + Fonction {include}, passage de variables - où header.tpl est : + Le template ci-dessus inclut l'exemple links.tpl - - -

{$title}

- - + +

{$title}{/h3> +
    + {foreach from=$links item=l} + .. faites quelques choses ici ... + + ]]> @@ -121,31 +141,24 @@ {include} et assignement à une variable - Cet exemple assigne le contenu de nav.tpl à la variable $navbar, - qui est alors affichée en haut et en bas de la page. + Cet exemple assigne le contenu de nav.tpl à la variable + $navbar, qui est alors affichée en haut et en bas de la page. {include file='nav.tpl' assign=navbar} - {include file='header.tpl' title='Main Menu' table_bgcolor='#c0c0c0'} + {include file='header.tpl' title='Smarty is cool'} {$navbar} - - {* body of template goes here *} - - {include file='footer.tpl' logo='http://my.example.com/logo.gif'} + {* le corps du template va ici *} {$navbar} + {include file='footer.tpl'} ]]> - - Utilisez la syntaxe ressource template pour inclure - des fichiers situés en dehors du répertoire $template_dir. - - fonction {include}, exemple de ressource template + Divers {include}, exemple de ressource template Voir aussi - {include_php}, - {insert}, - {php}, - les ressources de template et - les templates composants. + {include_php}, + {insert}, + {php}, + les ressources de template et + les templates composants. 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 adf724c4..d1749f7a 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-insert.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-insert.xml @@ -1,13 +1,13 @@ - + {insert} - 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 du template est activé. Les balises {insert} seront exécutées à chaque appel du template. @@ -81,7 +81,7 @@ - Dans cet exemple, nous utilisons le nom getBanner et lui passons les + 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 @@ -94,34 +94,47 @@ 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 assign, la sortie de la balise + {insert} sera assigné à une variable de template de ce nom au lieu d'être + affichée directement. + + + 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. + 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 {insert}. + 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, @@ -130,7 +143,7 @@ Voir aussi - {include} + {include} 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 1abc3c26..bdaadd19 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml @@ -1,15 +1,19 @@ - + {ldelim},{rdelim} - {ldelim} et {rdelim} sont utilisés pour échapper - les délimiteurs en tant que tels, dans notre cas, "{" et "}". Vous pouvez toujours utiliser {literal}{/literal} pour échapper - des blocks de texte, e.g. Javascript ou css. - Voir aussi {$smarty.ldelim}. + {ldelim} et {rdelim} sont utilisés pour + échapper + les délimiteurs en tant que tels, dans notre cas, + { et }. + Vous pouvez toujours utiliser + {literal}{/literal} + pour échapper des blocks de texte, e.g. Javascript ou css. + Voir aussi + {$smarty.ldelim}. {ldelim}, {rdelim} @@ -68,7 +72,7 @@ Voir aussi - {literal} et + {literal} et la désactivation de l'analyse de Smarty. 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 8a6ca857..a1649f3b 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-literal.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-literal.xml @@ -1,19 +1,20 @@ - + {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é - entre les balises {literal}{/literal} ne sera pas interprété, et + 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 {literal}, utilisez plutôt {ldelim}{rdelim} pour échapper - les délimiteurs individuels. + dans votre block {literal}, utilisez plutôt + {ldelim}{rdelim} + pour échapper les délimiteurs individuels. Balises {literal} @@ -77,7 +78,7 @@ Voir aussi - {ldelim}, {rdelim} et + {ldelim} {rdelim} et la désactivation de l'analyse de Smarty. 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 c05a2b6b..aec75f61 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-php.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-php.xml @@ -1,40 +1,40 @@ - + {php} - 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 + 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 et n'est pas recommandée. + + 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} + Exemple avec {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 et assignement d'une variable assign('varX','Strawberry'); {/php} -{$varX} est ma glâce favorite +{* affichage de la variable *} +{$varX} est ma glâce favorite :-) ]]> - - Ce qui suit n'est vrament PAS recommandé, vu que c'est dans le contexte du template. - - - - - Voir aussi - $php_handling, - {include_php}, - {include}, - {insert} et + $php_handling, + {include_php}, + {include}, + {insert} et les templates composantes.