From c060c07ab845a2013d24b0a32550c196fa046905 Mon Sep 17 00:00:00 2001 From: didou Date: Sun, 23 May 2004 15:44:59 +0000 Subject: [PATCH] WS and added revision tags --- .../language-function-capture.xml | 72 +-- .../language-function-config-load.xml | 184 +++---- .../language-function-foreach.xml | 154 +++--- .../language-function-if.xml | 37 +- .../language-function-include-php.xml | 169 +++--- .../language-function-include.xml | 157 +++--- .../language-function-insert.xml | 287 +++++----- .../language-function-ldelim.xml | 25 +- .../language-function-literal.xml | 29 +- .../language-function-php.xml | 27 +- .../language-function-section.xml | 513 +++++++++--------- .../language-function-strip.xml | 71 +-- 12 files changed, 872 insertions(+), 853 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 84802d0f..0e8c551a 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-capture.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-capture.xml @@ -1,41 +1,41 @@ - - capture + + 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 + 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. + + + Note technique - 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. - - 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. - - - - - 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. - - + + - - Capturer le contenu d'un template. - + 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. + + + + + Capturer le contenu d'un template. + {/if} ]]> - - - - + + + + - - config_load - - - - - - - - - - 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. - - - fonction config_load - + + config_load + + + + + + + + + + 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. + + + fonction config_load + ]]> - - - - Les fichiers de configuration peuvent contenir des sections. - Vous pouvez charger des variables d'une section donnée avec le - nouvel attribut section. - - - - 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. - - - - fonction config_load et section - + + + + Les fichiers de configuration peuvent contenir des sections. + Vous pouvez charger des variables d'une section donnée avec le + nouvel attribut section. + + + + 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. + + + + fonction config_load et section + ]]> - - - + + + - - foreach,foreachelse - - - - - - - - - - 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. - - -foreach + + foreach,foreachelse + + + + + + + + + + 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. + + + foreach {* Cet exemple affiche toutes les valeurs du tableau $custid *} @@ -85,10 +85,10 @@ SORTIE: id: 1000<br> id: 1001<br> id: 1002<br> - - - -foreach key + + + + foreach key {* key contient la clef de chaque élément parcouru @@ -113,7 +113,7 @@ portable: 3<br> tel: 555-4444<br> fax: 555-3333<br> portable: 760-1234<br> - + - - if,elseif,else - - 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. - - -Instruction if + + + if,elseif,else + + 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. + + + Instruction if {if $name eq "Fred"} Bienvenue, Monsieur. @@ -78,7 +79,7 @@ {if $var is even by 3} ... {/if} - + \ No newline at end of file +--> 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 463fcca3..ebdc10a9 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,87 +1,88 @@ - - include_php - - - - - - - - - - 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. - - -fonction include_php + + + include_php + + + + + + + + + + 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. + + + fonction include_php load_nav.php ------------- @@ -106,7 +107,7 @@ index.tpl {foreach item="curr_section" from=$sections} <a href="{$curr_section.url}">{$curr_section.name}</a><br> {/foreach} - + \ No newline at end of file +--> 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 e4f38589..8a65c50b 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-include.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-include.xml @@ -1,93 +1,94 @@ - - include - - - - - - - - - - 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. - - -fonction include + + + include + + + + + + + + + + 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. + + + fonction include {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. - - -fonction include, passage de variables + + + 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 {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. - - -fonction include, exemple de ressource template + + + Utilisez la syntaxe ressource template pour inclure + des fichiers situés en dehors du répertoire $template_dir. + + + fonction include, exemple de ressource template {* chemin absolu *} {include file="/usr/local/include/templates/header.tpl"} @@ -100,7 +101,7 @@ {* inclusion d'une ressource template "db" *} {include file="db:header.tpl"} - + \ No newline at end of file +--> 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 d88dbeeb..63f1f9e5 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-insert.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-insert.xml @@ -1,143 +1,154 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/designers/language-builtin-functions/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/designers/language-builtin-functions/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/designers/language-builtin-functions/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/designers/language-builtin-functions/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/designers/language-builtin-functions/clean.php on line 56 - - insert - - - - - - - - - - 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. - - -function insert + + + insert + + + + + + + + + + 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. + + + function insert {* 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. - - - 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 - 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. - - - - \ No newline at end of file + + + 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. + + + 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 + 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. + + + + 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 082f09ed..180610e4 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,16 @@ - - ldelim,rdelim - - 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. - - -ldelim, rdelim + + + ldelim,rdelim + + 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. + + + ldelim, rdelim {* Affiche les délimiteurs de template *} @@ -19,7 +20,7 @@ SORTIE: {nomFonction} est la façon dont sont appelées les fonctions dans Smarty ! - + \ No newline at end of file +--> 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 9cfc2215..e89a88eb 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-literal.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-literal.xml @@ -1,17 +1,18 @@ - - literal - - 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. - - -balises literal + + + literal + + 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. + + + balises literal {literal} <script language=javascript> @@ -30,7 +31,7 @@ </script> {/literal} - + \ 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 58288e72..0d4daed4 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-php.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-php.xml @@ -1,23 +1,24 @@ - - 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 - utilisateurs avancés seulement, son utilisation n'est normalement pas - nécessaire. - - -balises php + + + 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 + utilisateurs avancés seulement, son utilisation n'est normalement pas + nécessaire. + + + balises php {php} // inclusion directe d'un script PHP // depuis le template. include("/path/to/display_weather.php"); {/php} - + \ No newline at end of file +--> 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 3d3c2073..2efc55fa 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-section.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-section.xml @@ -1,100 +1,101 @@ - - section,sectionelse - - - - - - - - - - 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. - - -section + + + section,sectionelse + + + + + + + + + + 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. + + + section {* Cet exemple va afficher toutes les valeurs du tableau $custid *} @@ -107,10 +108,10 @@ SORTIE: id: 1000<br> id: 1001<br> id: 1002<br> - - - -section, variable de parcours + + + + section, variable de parcours {* 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 @@ -139,10 +140,10 @@ id: 1002<br> nom: Jane Munson<br> addresse: 5605 apple st<br> <p> - - - -nom de section + + + + nom de section {* Le nom de la section peut être ce que vous voulez, et est utilisé pour référencer les données depuis la section. *} @@ -152,10 +153,10 @@ addresse: 5605 apple st<br> address: {$addresses[monTableau]}<br> <p> {/section} - - - -sections imbriquées + + + + sections imbriquées {* 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 @@ -196,10 +197,10 @@ telephone: 555-555-5555<br> telephone portable: 555-555-5555<br> e-mail: jane@mydomain.com<br> <p> - - - -Sections et tableaux associatifs + + + + Sections et tableaux associatifs {* Exemple d'affichage d'un tableau associatif dans une section *} {section name=client loop=$contacts} @@ -224,12 +225,12 @@ nom: Jane Munson<br> telephone: 555-555-5555<br> portable: 555-555-5555<br> e-mail: jane@mydomain.com<p> - - - - - -sectionelse + + + + + + sectionelse {* sectionelse est exécuté s'il n'existe aucune valeur dans idClient *} {section name=client loop=$idClient} @@ -237,36 +238,36 @@ e-mail: jane@mydomain.com<p> {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 - - 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). - - - 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 - par 0 plutôt que par 1. - - - - propriété de section index - + + + 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 + + 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). + + + 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 + par 0 plutôt que par 1. + + + + propriété de section index + {section name=client loop=$idClient} {$smarty.section.client.index} id: {$idClient[client]}<br> {/section} @@ -278,17 +279,17 @@ e-mail: jane@mydomain.com<p> 1 id: 1001<br> 2 id: 1002<br> - - - - index_prev - - index_prev est utilisé pour afficher l'index de parcours - précédent de la boucle. Au premier passage, il vaut -1. - - - propriété de section index_prev - + + + + index_prev + + index_prev est utilisé pour afficher l'index de parcours + précédent de la boucle. Au premier passage, il vaut -1. + + + propriété de section index_prev + {section name=client loop=$custid} {$smarty.section.client.index} id: {$idClient[client]}<br> {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} @@ -307,18 +308,18 @@ e-mail: jane@mydomain.com<p> 2 id: 1002<br> L'id du client à été modifié<br> - - - - index_next - - 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é. - - - propriété de section index_next - + + + + index_next + + 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é. + + + propriété de section index_next + {section name=client loop=$idClient} {$smarty.section.client.index} id: {$idClient[client]}<br> {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} @@ -337,22 +338,22 @@ e-mail: jane@mydomain.com<p> 2 id: 1002<br> L'id du client va changer<br> - - - - iteration - - 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. - - - propriété iteration de section - + + + + iteration + + 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. + + + propriété iteration de section + {section name=client loop=$idClient start=5 step=2} Iteration courante: {$smarty.section.client.iteration}<br> {$smarty.section.client.index} id: {$idClient[client]}<br> @@ -375,16 +376,16 @@ e-mail: jane@mydomain.com<p> 9 id: 1002<br> L'id du client va changer<br> - - - - first - - first est à true lorsque la section est parcouru pour la première fois. - - - propriété first de la section - + + + + first + + first est à true lorsque la section est parcouru pour la première fois. + + + propriété first de la section + {section name=client loop=$idClient} {if $smarty.section.client.first} <table> @@ -407,16 +408,16 @@ e-mail: jane@mydomain.com<p> <tr><td>2 id: 1002</td></tr> </table> - - - - last - - last est à true lorsque la section est parcourue pour la dernière fois. - - - Propriété last de section - + + + + last + + last est à true lorsque la section est parcourue pour la dernière fois. + + + Propriété last de section + {section name=client loop=$idClient} {if $smarty.section.client.first} <table> @@ -439,18 +440,18 @@ e-mail: jane@mydomain.com<p> <tr><td>2 id: 1002</td></tr> </table> - - - - 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 - identique. - - - propriété rownum de section - + + + + 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 + identique. + + + propriété rownum de section + {section name=client loop=$idClient} {$smarty.section.client.rownum} id: {$idClient[client]}<br> {/section} @@ -462,17 +463,17 @@ e-mail: jane@mydomain.com<p> 2 id: 1001<br> 3 id: 1002<br> - - - - loop - - 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. - - - Propriété de section index - + + + + loop + + 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. + + + Propriété de section index + {section name=client loop=$idClient} {$smarty.section.client.index} id: {$idClient[client]}<br> {/section} @@ -487,19 +488,19 @@ e-mail: jane@mydomain.com<p> il y eu 3 clients d'affichés. - - - - show - - 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é. - - - section, attribut show - + + + + show + + 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é. + + + section, attribut show + {* $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} @@ -521,17 +522,17 @@ e-mail: jane@mydomain.com<p> la section à été affichée. - - - - total - - 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, propriété total - + + + + total + + 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, propriété total + {section name=client loop=$idClient step=2} {$smarty.section.client.index} id: {$idClient[client]}<br> {/section} @@ -546,8 +547,8 @@ e-mail: jane@mydomain.com<p> Il y eu 3 clients affichés. - - + + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-builtin-functions/language-function-strip.xml b/docs/fr/designers/language-builtin-functions/language-function-strip.xml index 3533143a..da71d8e9 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-strip.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-strip.xml @@ -1,31 +1,32 @@ - - strip - - 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. - - - Note technique - - {strip}{/strip} n'affecte en aucun cas le contenu des variables de - template. Voir le modificateur - strip pour un rendu identique pour les variables. - - - -balises strip + + + strip + + 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. + + + Note technique + + {strip}{/strip} n'affecte en aucun cas le contenu des variables de + template. Voir le modificateur + strip pour un rendu identique pour les variables. + + + + balises strip {* la suite sera affichée sur une seule ligne *} {strip} @@ -44,14 +45,14 @@ 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é. - + + + 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é. + \ No newline at end of file +-->