From beb01fcd5d0eefd7288043166284032f1460e407 Mon Sep 17 00:00:00 2001 From: didou Date: Tue, 13 Apr 2004 15:43:47 +0000 Subject: [PATCH] missed files --- .../language-syntax-attributes.xml | 54 ++ .../language-syntax-comments.xml | 50 ++ .../language-syntax-functions.xml | 58 ++ .../language-syntax-quotes.xml | 48 ++ .../language-function-capture.xml | 71 +++ .../language-function-config-load.xml | 139 +++++ .../language-function-foreach.xml | 136 +++++ .../language-function-if.xml | 102 ++++ .../language-function-include-php.xml | 130 ++++ .../language-function-include.xml | 124 ++++ .../language-function-insert.xml | 143 +++++ .../language-function-ldelim.xml | 43 ++ .../language-function-literal.xml | 54 ++ .../language-function-php.xml | 41 ++ .../language-function-section.xml | 571 ++++++++++++++++++ .../language-function-strip.xml | 75 +++ .../language-function-assign.xml | 73 +++ .../language-function-counter.xml | 119 ++++ .../language-function-cycle.xml | 134 ++++ .../language-function-debug.xml | 61 ++ .../language-function-eval.xml | 120 ++++ .../language-function-fetch.xml | 107 ++++ .../language-function-html-checkboxes.xml | 146 +++++ .../language-function-html-image.xml | 135 +++++ .../language-function-html-options.xml | 154 +++++ .../language-function-html-radios.xml | 148 +++++ .../language-function-html-select-date.xml | 325 ++++++++++ .../language-function-html-select-time.xml | 326 ++++++++++ .../language-function-html-table.xml | 136 +++++ .../language-function-mailto.xml | 152 +++++ .../language-function-math.xml | 150 +++++ .../language-function-popup-init.xml | 47 ++ .../language-function-popup.xml | 443 ++++++++++++++ .../language-function-textformat.xml | 260 ++++++++ .../language-modifier-capitalize.xml | 47 ++ .../language-modifier-cat.xml | 72 +++ .../language-modifier-count-characters.xml | 48 ++ .../language-modifier-count-paragraphs.xml | 47 ++ .../language-modifier-count-sentences.xml | 51 ++ .../language-modifier-count-words.xml | 47 ++ .../language-modifier-date-format.xml | 187 ++++++ .../language-modifier-default.xml | 77 +++ .../language-modifier-escape.xml | 91 +++ .../language-modifier-indent.xml | 96 +++ .../language-modifier-lower.xml | 47 ++ .../language-modifier-nl2br.xml | 46 ++ .../language-modifier-regex-replace.xml | 85 +++ .../language-modifier-replace.xml | 83 +++ .../language-modifier-spacify.xml | 79 +++ .../language-modifier-string-format.xml | 77 +++ .../language-modifier-strip-tags.xml | 51 ++ .../language-modifier-strip.xml | 61 ++ .../language-modifier-truncate.xml | 108 ++++ .../language-modifier-upper.xml | 48 ++ .../language-modifier-wordwrap.xml | 122 ++++ .../language-assigned-variables.xml | 135 +++++ .../language-config-variables.xml | 96 +++ .../language-variables-smarty.xml | 130 ++++ 58 files changed, 6806 insertions(+) create mode 100644 docs/fr/designers/language-basic-syntax/language-syntax-attributes.xml create mode 100644 docs/fr/designers/language-basic-syntax/language-syntax-comments.xml create mode 100644 docs/fr/designers/language-basic-syntax/language-syntax-functions.xml create mode 100644 docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-capture.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-config-load.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-foreach.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-if.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-include-php.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-include.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-insert.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-ldelim.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-literal.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-php.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-section.xml create mode 100644 docs/fr/designers/language-builtin-functions/language-function-strip.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-assign.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-counter.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-cycle.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-debug.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-eval.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-fetch.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-html-image.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-html-options.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-html-radios.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-html-select-date.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-html-select-time.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-html-table.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-mailto.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-math.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-popup-init.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-popup.xml create mode 100644 docs/fr/designers/language-custom-functions/language-function-textformat.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-capitalize.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-cat.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-count-characters.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-count-paragraphs.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-count-sentences.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-count-words.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-date-format.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-default.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-escape.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-indent.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-lower.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-nl2br.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-regex-replace.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-replace.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-spacify.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-string-format.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-strip-tags.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-strip.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-truncate.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-upper.xml create mode 100644 docs/fr/designers/language-modifiers/language-modifier-wordwrap.xml create mode 100644 docs/fr/designers/language-variables/language-assigned-variables.xml create mode 100644 docs/fr/designers/language-variables/language-config-variables.xml create mode 100644 docs/fr/designers/language-variables/language-variables-smarty.xml diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-attributes.xml b/docs/fr/designers/language-basic-syntax/language-syntax-attributes.xml new file mode 100644 index 00000000..ae16c294 --- /dev/null +++ b/docs/fr/designers/language-basic-syntax/language-syntax-attributes.xml @@ -0,0 +1,54 @@ + + + + Paramètres + + La plupart des fonctions attendent des paramètres qui régissent leur + comportement. Les paramètres des fonctions Smarty sont très proches des + attributs des balises HTML. Les valeurs numériques n'ont pas besoin d'être + entourées par des guillemets, par contre, ces guillemets sont recommandées lors + de l'utilisation de chaînes de caractères. Des variables peuvent aussi être + utilisées en tant que paramètres, et ne doivent pas être entourées de guillemets. + + + Certains paramètres requièrent des valeurs booléennes (true / false). + Elles peuvent être spécifiées par l'une des valeures suivantes, sans + guillemet: true, on, et yes, + ou false, off, et no. + + + Paramètres de fonction, syntaxe + +{include file="header.tpl"} + +{include file=$includeFile} + +{include file=#includeFile#} + +{html_select_date display_days=yes} + +<SELECT name=company> +{html_options values=$vals selected=$selected output=$output} +</SELECT> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml b/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml new file mode 100644 index 00000000..9c1a7f5f --- /dev/null +++ b/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml @@ -0,0 +1,50 @@ + + + + Commentaires + + Les commentaires dans Smarty sont entourés d'asterisques, de cette + façon : {* voici un commentaire *} + Les commentaires Smarty ne sont pas affichés dans la sortie finale du + template. + Ils sont utilisés pour des notes internes, dans le template, pour aider + les développeurs à en comprendre le fonctionnement. + + + Commentaires + +{* Smarty *} + +{* Inclusion de l'en tête *} +{include file="header.tpl"} + +{include file=$includeFile} + +{include file=#includeFile#} + +{* affiche des listes déroulantes *} +<SELECT name=company> +{html_options values=$vals selected=$selected output=$output} +</SELECT> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml b/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml new file mode 100644 index 00000000..2062906d --- /dev/null +++ b/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml @@ -0,0 +1,58 @@ + + + + Fonctions + + Les balises Smarty affichent une variable + ou invoquent une fonction. Les fonctions sont appelées + lorsqu'elles sont entourées, ainsi que leurs paramètres, des délimiteurs Smarty. + Par exemple : {nomfonction par1="val" par2="val"}. + + + syntaxe des fonctions + +{config_load file="colors.conf"} + +{include file="header.tpl"} + +{if $name eq "Fred"} + Vous êtes admis dans cette zone +{else} + Bienvenue, <font color="{#fontColor#}">{$name}!</font> +{/if} + +{include file="footer.tpl"} + + + Les fonctions natives et les fonctions utilisateurs ont toutes deux la même + syntaxe, dans les templates. Les fonctions natives sont relatives + au traitement interne de Smarty, comme par exemple if, + section et strip. Elles ne peuvent + être modifiées. Les fonctions utilisateurs sont des fonctions additionnelles, + implémentées par l'intermédiaire de plugins. + Elles peuvent être modifiées pour correspondre à vos besoins, et vous + pouvez en créer de nouvelles. html_options et + html_select_date sont deux exemples de fonctions + utilisateurs. + + + \ 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 new file mode 100644 index 00000000..1aea9421 --- /dev/null +++ b/docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml @@ -0,0 +1,48 @@ + + + + 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 + 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 (`). + + + Syntaxe d'insertion de variables dans des chaînes + +EXEMPLE DE SYNTAXE: +{func var="test $foo test"} <-- comprends $foo +{func var="test $foo_bar test"} <-- comprends $foo_bar +{func var="test $foo[0] test"} <-- comprends $foo[0] +{func var="test $foo[bar] test"} <-- comprends $foo[bar] +{func var="test $foo.bar test"} <-- comprends $foo (not $foo.bar) +{func var="test `$foo.bar` test"} <-- comprends $foo.bar + +EXEMPLE PRATIQUE: +{include file="subdir/$tpl_name.tpl"} <-- remplace $tpl_name avec la valeur +{cycle values="one,two,`$smarty.config.myval`"} <-- doit comporter les +apostrophes inverses + + + \ 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 new file mode 100644 index 00000000..9b006f22 --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-capture.xml @@ -0,0 +1,71 @@ + + + + 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 + + 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. + +{* nous ne voulons afficher une ligne que si cette dernière est activé. *} +{capture name=banner} +{include file="get_banner.tpl"} +{/capture} +{if $smarty.capture.banner ne ""} + <tr> + <td> + {$smarty.capture.banner} + </td> + </tr> +{/if} + + + + \ 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 new file mode 100644 index 00000000..8a6f25db --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-config-load.xml @@ -0,0 +1,139 @@ + + + + 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 file="colors.conf"} + +<html> +<title>{#pageTitle#}</title> +<body bgcolor="{#bodyBgColor#}"> +<table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> + <tr bgcolor="{#rowBgColor#}"> + <td>First</td> + <td>Last</td> + <td>Address</td> + </tr> +</table> +</body> +</html> + + + Les fichiers de configuration peuvent contenir des sections. + Vous pouvez charger des variables d'une section donnée avec le + nouvel attribut section. + + + NOTE: Les sections des fichiers de configuration + et la fonction native section n'ont rien en + commun, il s'avère simplement qu'elles portent le même nom. + + +fonction config_load et section + +{config_load file="colors.conf" section="client"} + +<html> +<title>{#pageTitle#}</title> +<body bgcolor="{#bodyBgColor#}"> +<table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> + <tr bgcolor="{#rowBgColor#}"> + <td>First</td> + <td>Last</td> + <td>Address</td> + </tr> +</table> +</body> +</html> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-builtin-functions/language-function-foreach.xml b/docs/fr/designers/language-builtin-functions/language-function-foreach.xml new file mode 100644 index 00000000..6b6f44e2 --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-foreach.xml @@ -0,0 +1,136 @@ + + + + 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 *} +{foreach from=$custid item=curr_id} + id: {$curr_id}<br> +{/foreach} + +SORTIE: + +id: 1000<br> +id: 1001<br> +id: 1002<br> + + + +foreach key + +{* key contient la clef de chaque élément parcouru + +l'attribution des élément est de la forme: + +$smarty->assign("contacts", array(array("tel" => "1", "fax" => "2", "portable" => "3"), + array("tel" => "555-4444", "fax" => "555-3333", "portable" => "760-1234"))); + +*} + +{foreach name=outer item=contact from=$contacts} + {foreach key=key item=item from=$contact} + {$key}: {$item}<br> + {/foreach} +{/foreach} + +SORTIE: + +tel: 1<br> +fax: 2<br> +portable: 3<br> +tel: 555-4444<br> +fax: 555-3333<br> +portable: 760-1234<br> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-builtin-functions/language-function-if.xml b/docs/fr/designers/language-builtin-functions/language-function-if.xml new file mode 100644 index 00000000..613ca3cf --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-if.xml @@ -0,0 +1,102 @@ + + + + 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. +{elseif $name eq "Wilma"} + Bienvenue m'dame. +{else} + Bienvenue, qui que vous soyez. +{/if} + +{* Un exemple avec l'opérateur or *} +{if $name eq "Fred" or $name eq "Wilma"} + ... +{/if} + +{* même chose que ci-dessus *} +{if $name == "Fred" || $name == "Wilma"} + ... +{/if} + +{* l'exemple suivant NE fonctionne PAS, les opérateurs + doivent être entourés d'espaces. *} +{if $name=="Fred" || $name=="Wilma"} + ... +{/if} + + +{* les parenthèses sont autorisées *} +{if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#} + ... +{/if} + +{* vous pouvez également faire appel aux fonctions PHP *} +{if count($var) gt 0} + ... +{/if} + +{* teste si les valeurs sont paires(even) ou impaires(odd) *} +{if $var is even} + ... +{/if} +{if $var is odd} + ... +{/if} +{if $var is not odd} + ... +{/if} + +{* teste si la variable est divisble par 4 *} +{if $var is div by 4} + ... +{/if} + +{* teste si la variable est paire, par groupe de deux i.e., +0=paire, 1=paire, 2=impaire, 3=impaire, 4=paire, 5=paire, etc. *} +{if $var is even by 2} + ... +{/if} + +{* 0=paire, 1=paire, 2=paire, 3=impaire, 4=impaire, 5=impaire, etc. *} +{if $var is even by 3} + ... +{/if} + + + \ 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 new file mode 100644 index 00000000..463fcca3 --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-include-php.xml @@ -0,0 +1,130 @@ + + + + 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 +------------- + +<?php + + // charge des variables depuis une base de données mysql et les assigne au template. + require_once("MySQL.class.php"); + $sql = new MySQL; + $sql->query("select * from site_nav_sections order by name",SQL_ALL); + $this->assign('sections',$sql->record); + +?> + + +index.tpl +--------- + +{* chemin absolu, ou relatif à $trusted_dir *} +{include_php file="/path/to/load_nav.php"} + +{foreach item="curr_section" from=$sections} + <a href="{$curr_section.url}">{$curr_section.name}</a><br> +{/foreach} + + + \ 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 new file mode 100644 index 00000000..e4f38589 --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-include.xml @@ -0,0 +1,124 @@ + + + + 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 + +{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 + +{* chemin absolu *} +{include file="/usr/local/include/templates/header.tpl"} + +{* chemin absolu (même chose) *} +{include file="file:/usr/local/include/templates/header.tpl"} + +{* chemin absolu windows (DOIT utiliser le préfixe "file:") *} +{include file="file:C:/www/pub/templates/header.tpl"} + +{* inclusion d'une ressource template "db" *} +{include file="db:header.tpl"} + + + \ 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 new file mode 100644 index 00000000..d88dbeeb --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-insert.xml @@ -0,0 +1,143 @@ + + + + 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 diff --git a/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml b/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml new file mode 100644 index 00000000..082f09ed --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml @@ -0,0 +1,43 @@ + + + + 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 *} + +{ldelim}nomFonction{rdelim} est la façon dont sont appelées les fonctions dans Smarty ! + + +SORTIE: + +{nomFonction} est la façon dont sont appelées les fonctions dans Smarty ! + + + \ 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 new file mode 100644 index 00000000..9cfc2215 --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-literal.xml @@ -0,0 +1,54 @@ + + + + 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> + + <!-- + function isblank(field) { + if (field.value == '') + { return false; } + else + { + document.loginform.submit(); + return true; + } + } + // --> + + </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 new file mode 100644 index 00000000..58288e72 --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-php.xml @@ -0,0 +1,41 @@ + + + + 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 new file mode 100644 index 00000000..3d3c2073 --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-section.xml @@ -0,0 +1,571 @@ + + + + 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 *} +{section name=client loop=$custid} + id: {$custid[client]}<br> +{/section} + +SORTIE: + +id: 1000<br> +id: 1001<br> +id: 1002<br> + + + +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 + lorsque vous êtes dans une section. Cet exemple part du principe que + $idClient, $noms et $adresses sont tous des tableaux qui contiennent + autant de valeurs les uns que les autres.*} +{section name=client loop=$custid} + id: {$idClient[client]}<br> + nom: {$noms[client]}<br> + addresse: {$addresses[client]}<br> + <p> +{/section} + + +SORTIE: + +id: 1000<br> +nom: John Smith<br> +addresse: 253 N 45th<br> +<p> +id: 1001<br> +nom: Jack Jones<br> +addresse: 417 Mulberry ln<br> +<p> +id: 1002<br> +nom: Jane Munson<br> +addresse: 5605 apple st<br> +<p> + + + +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. *} +{section name=monTableau loop=$idClient} + id: {$idCLient[monTableau]}<br> + name: {$noms[monTableau]}<br> + address: {$addresses[monTableau]}<br> + <p> +{/section} + + + +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 + complexes, comme des tableaux multi-dimentionnels. Dans cet exemple, + $type_contact[client] est un tableau de type de contact pour le client + courant. *} +{section name=client loop=$custid} + id: {$idClient[client]}<br> + nom: {$nom[client]}<br> + addresse: {$addresse[client]}<br> + {section name=contact loop=$type_contact[client]} + {$type_contact[client][contact]}: {$info_contact[client][contact]}<br> + {/section} + <p> +{/section} + + +SORTIE: + +id: 1000<br> +nom: John Smith<br> +addresse: 253 N 45th<br> +telephone: 555-555-5555<br> +telephone portable: 555-555-5555<br> +e-mail: john@mydomain.com<br> +<p> +id: 1001<br> +nom: Jack Jones<br> +addresse: 417 Mulberry ln<br> +telephone: 555-555-5555<br> +telephone portable: 555-555-5555<br> +e-mail: jack@mydomain.com<br> +<p> +id: 1002<br> +nom: Jane Munson<br> +addresse: 5605 apple st<br> +telephone: 555-555-5555<br> +telephone portable: 555-555-5555<br> +e-mail: jane@mydomain.com<br> +<p> + + + +Sections et tableaux associatifs + +{* Exemple d'affichage d'un tableau associatif dans une section *} +{section name=client loop=$contacts} + nom: {$contacts[client].name}<br> + telephone: {$contacts[client].home}<br> + portable: {$contacts[client].cell}<br> + e-mail: {$contacts[client].email}<p> +{/section} + + +SORTIE: + +nom: John Smith<br> +telephone: 555-555-5555<br> +portable: 555-555-5555<br> +e-mail: john@mydomain.com<p> +nom: Jack Jones<br> +telephone: 555-555-5555<br> +portable: 555-555-5555<br> +e-mail: jack@mydomain.com<p> +nom: Jane Munson<br> +telephone: 555-555-5555<br> +portable: 555-555-5555<br> +e-mail: jane@mydomain.com<p> + + + + + +sectionelse + +{* sectionelse est exécuté s'il n'existe aucune valeur dans idClient *} +{section name=client loop=$idClient} + id: {$idClient[client]}<br> +{sectionelse} + Aucune valeur dans $idClient. +{/section} + + + Les sections ont leur propre variable de gestion des propriétés. + Elles sont de la forme: {$smarty.section.nomSection.nomVariable} + + + NOTE: Depuis Smarty 1.5.0, la syntaxe pour les propiétés des sections + a été changée de {%sectionname.varname%} à + {$smarty.section.nomSection.nomVariable}. L'ancienne syntaxe est toujours + supportée, mais vous ne verrez que des exemples avec la nouvelle syntaxe + dans le manuel. + + + index + + 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} + + + SORTIE: + + 0 id: 1000<br> + 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 + + {section name=client loop=$custid} + {$smarty.section.client.index} id: {$idClient[client]}<br> + {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} + {if $idClient[client.index_prev] ne $idClient[client.index]} + L'id du client à été modifié<br> + {/if} + {/section} + + + SORTIE: + + 0 id: 1000<br> + L'id du client à été modifié<br> + 1 id: 1001<br> + L'id du client à été modifié<br> + 2 id: 1002<br> + L'id du client à été modifié<br> + + + + + index_next + + 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 *} + {if $idClient[client.index_next] ne $idClient[client.index]} + L'id du client va changer<br> + {/if} + {/section} + + + SORTIE: + + 0 id: 1000<br> + L'id du client va changer<br> + 1 id: 1001<br> + L'id du client va changer<br> + 2 id: 1002<br> + L'id du client va changer<br> + + + + + iteration + + 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> + {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} + {if $idCLient[client.index_next] ne $idClient[client.index]} + L'id du client va changer<br> + {/if} + {/section} + + + SORTIE: + + Iteration courante: 1 + 5 id: 1000<br> + L'id du client va changer<br> + Iteration courante: 2 + 7 id: 1001<br> + L'id du client va changer<br> + Iteration courante: 3 + 9 id: 1002<br> + L'id du client va changer<br> + + + + + first + + 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> + {/if} + + <tr><td>{$smarty.section.client.index} id: + {$idClient[client]}</td></tr> + + {if $smarty.section.client.last} + </table> + {/if} + {/section} + + + SORTIE: + + <table> + <tr><td>0 id: 1000</td></tr> + <tr><td>1 id: 1001</td></tr> + <tr><td>2 id: 1002</td></tr> + </table> + + + + + last + + 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> + {/if} + + <tr><td>{$smarty.section.client.index} id: + {$idClient[client]}</td></tr> + + {if $smarty.section.client.last} + </table> + {/if} + {/section} + + + SORTIE: + + <table> + <tr><td>0 id: 1000</td></tr> + <tr><td>1 id: 1001</td></tr> + <tr><td>2 id: 1002</td></tr> + </table> + + + + + rownum + + 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} + + + SORTIE: + + 1 id: 1000<br> + 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 + + {section name=client loop=$idClient} + {$smarty.section.client.index} id: {$idClient[client]}<br> + {/section} + + Il y eu {$smarty.section.client.loop} clients d'affichés. + + SORTIE: + + 0 id: 1000<br> + 1 id: 1001<br> + 2 id: 1002<br> + + il y eu 3 clients d'affichés. + + + + + show + + 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} + {$smarty.section.client.rownum} id: {$idClient[client]}<br> + {/section} + + {if $smarty.section.client.show} + la section à été affichée. + {else} + la section n'a pas été affichée. + {/if} + + + SORTIE: + + 1 id: 1000<br> + 2 id: 1001<br> + 3 id: 1002<br> + + la section à été affichée. + + + + + total + + 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} + + Il y eu {$smarty.section.client.total} clients affichés. + + SORTIE: + + 0 id: 1000<br> + 2 id: 1001<br> + 4 id: 1002<br> + + Il y eu 3 clients affichés. + + + + + \ 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 new file mode 100644 index 00000000..3533143a --- /dev/null +++ b/docs/fr/designers/language-builtin-functions/language-function-strip.xml @@ -0,0 +1,75 @@ + + + + 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} +<table border=0> + <tr> + <td> + <A HREF="{$url}"> + <font color="red">Un test</font> + </A> + </td> + </tr> +</table> +{/strip} + + +SORTIE: + +<table border=0><tr><td><A HREF="http://mon.domaine.com"><font color="red">Un test</font></A></td></tr></table> + + + Notez que dans l'exemple ci-dessus, toutes les lignes commencent et + se terminent par des balises HTML. Sachez que si vous avez du texte + en début ou en fin de ligne dans des balises strip, ce dernier sera collé + au suivant/précédent et risque de ne pas être affiché selon + l'effet désiré. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-assign.xml b/docs/fr/designers/language-custom-functions/language-function-assign.xml new file mode 100644 index 00000000..3f9b8e26 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-assign.xml @@ -0,0 +1,73 @@ + + + + assign + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + var + chaîne de caractère + Oui + n/a + Le nom de la variable assignée + + + value + chaîne de caractère + Oui + n/a + La valeur assignée + + + + + + Assign est utilisé pour déclarer ou modifier des variables de template. + + +assign + +{assign var="name" value="Bob"} + +La valeur de $name est {$name}. + +SORTIE: + +La valeur de $name est Bob. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-counter.xml b/docs/fr/designers/language-custom-functions/language-function-counter.xml new file mode 100644 index 00000000..4d739b43 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-counter.xml @@ -0,0 +1,119 @@ + + + + counter + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + name + chaîne de caractère + Non + default + Le nom du compteur + + + start + numérique + Non + 1 + La valeur initiale du compteur + + + skip + numérique + Non + 1 + L'intervale du compteur + + + direction + chaîne de caractères + Non + up + la direction du compteur (up/down) [compte / décompte] + + + print + booléen + Non + true + S'il faut afficher cette valeur ou non + + + assign + chaîne de caractères + Non + n/a + La variable dans laquelle la valeur du compteur + sera assignée. + + + + + + counter affiche un compteur. counter retient la valeur + du compte à chaque itération. Vous pouvez adapter le nombre, l'intervale + et la direction du compteur, ainsi que décider d'afficher ou non + les valeurs. Vous pouvez lancer plusieurs compteurs simultanément en + leur donnant des noms uniques. Si vous ne donnez pas de nom à un + compteur, 'default' sera utilisé. + + + Si vous donnez une valeur à l'attribut "assign", alors la sortie de la + fonction counter sera assignée à la variable de template donnée plutôt + que d'être directement affichée. + + +counter + +{* initialisation du compteur *} +{counter start=0 skip=2 print=false} + +{counter}<br> +{counter}<br> +{counter}<br> +{counter}<br> + +SORTIE: + +2<br> +4<br> +6<br> +8<br> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-cycle.xml b/docs/fr/designers/language-custom-functions/language-function-cycle.xml new file mode 100644 index 00000000..ae5ea867 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-cycle.xml @@ -0,0 +1,134 @@ + + + + cycle + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + name + chaîne de caractères + Non + default + Le nom du cycle + + + values + divers + Oui + N/A + Les valeurs sur lesquelles boucler, soit une liste + séparée par des virgules, (voir l'attribut delimiter), + soit un tableau de valeurs. + + + print + booléen + Non + true + S'il faut afficher ou non cette valeur + + + advance + booléen + Non + true + Oui ou non aller à la prochaîne valeur + + + delimiter + chaîne de caractères + Non + , + Le délimiteur à utiliser dans la liste. + + + assign + chaîne de caractères + Non + n/a + La variable de template dans laquelle la sortie + sera assignée + + + + + + cycle est utilisé pour boucler sur un ensemble de valeurs. Très pratique + pour alterner entre deux ou plusieurs couleurs dans un tableau, + ou plus généralement pour boucler sur les valeurs d'un tableau. + + + Vous pouvez définir plusieurs "cycle" dans votre template, en leur + donnant des noms uniques (attribut name). + + + Vous pouvez empêcher la valeur courante de s'afficher en définissant + l'attribut print à false. Ce procédé peut être utile pour discrètement + passer outre une valeur de la liste. + + + L'attribut advance est utilisé pour répéter une valeur. Lorsque + définit à false, le prochain appel de cycle ramènera la même valeur. + + + Si vous définissez l'attribut spécial "assign", la sortie de la fonction + cycle y sera assignée plutôt que d'être directement affichée. + + +cycle + +{section name=rows loop=$data} +<tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"> + <td>{$data[rows]}</td> +</tr> +{/section} + +SORTIE: + +<tr bgcolor="#eeeeee"> + <td>1</td> +</tr> +<tr bgcolor="#d0d0d0"> + <td>2</td> +</tr> +<tr bgcolor="#eeeeee"> + <td>3</td> +</tr> + + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-debug.xml b/docs/fr/designers/language-custom-functions/language-function-debug.xml new file mode 100644 index 00000000..4faa709e --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-debug.xml @@ -0,0 +1,61 @@ + + + + debug + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + output + chaîne de caractères + Non + html + Type de sortie, html ou javascript + + + + + + {debug} amène la console de débogage sur la page. Fonctionne + quelle que soit la valeur du paramètre debug de Smarty. + Comme ce dernier est appelé lors de l'exécution, il n'est capable + d'afficher que les variables assignées au template, et non + les templates en cours d'utilisation. Toutefois, vous voyez toutes + les variables disponibles pour le template courant. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-eval.xml b/docs/fr/designers/language-custom-functions/language-function-eval.xml new file mode 100644 index 00000000..07bf3a32 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-eval.xml @@ -0,0 +1,120 @@ + + + + eval + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + var + mixed + Oui + n/a + variable (ou chaîne de caractères) à évaluer + + + assign + chaîne de caractères + Non + n/a + Le nom de la variable PHP dans laquelle la sortie + sera assignée + + + + + + eval évalue une variable comme si cette dernière était un template. + Peut être utile pour embarquer des balises de templates ou des variables + de template dans des variables ou des balises/variables dans des + variables de fichiers de configuration. + + + Si vous définissez l'attribut "assign", la sortie sera assignée à la + variable de template désignée plutôt que d'être affichée dans le + template. + + + Note technique + + Les variables évaluées sont traitées de la même façon que les templates. + Elles suivent les mêmes règles de traitement et de sécurité, comme si + elles étaient réellement des templates. + + + + Note technique + + Les variables évaluées sont compilées à chaque invocation, et la version + compilée n'est pas sauvegardée ! Toutefois, si le cache est activé, + la sortie sera placée en cache avec le reste du template. + + + +eval + +setup.conf +---------- + +emphstart = <b> +emphend = </b> +titre = Bienvenue sur la homepage de {$company} ! +ErrorVille = Vous devez spécifier un nom de {#emphstart#}ville{#emphend#}. +ErrorDept = Vous devez spécifier un {#emphstart#}département{#emphend#}. + + +index.tpl +--------- + +{config_load file="setup.conf"} + +{eval var=$foo} +{eval var=#titre#} +{eval var=#ErrorVille#} +{eval var=#ErrorDept# assign="state_error"} +{$state_error} + +SORTIE: + +Ceci est le contenu de foo. +Bienvenue sur la homepage de FictifLand. +Vous devez spécifier un nom de <b>ville</b>. +Vous devez spécifier un <b>département</b>. + + + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-fetch.xml b/docs/fr/designers/language-custom-functions/language-function-fetch.xml new file mode 100644 index 00000000..efc92bc9 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-fetch.xml @@ -0,0 +1,107 @@ + + + + fetch + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + file + chaîne de caractères + Oui + n/a + le fichier, site http ou ftp à récupérer + + + assign + chaîne de caractères + Non + n/a + le nom de la variable PHP dans laquelle la sortie + sera assignée plutôt que d'être directement affichée. + + + + + + + fetch est utilisé pour récupérer des fichiers depuis le système de + fichier local, depuis un serveur http ou ftp, et en afficher le contenu. + Si le nom du fichier commence par "http://", la page internet sera + récupérée, puis affichée. Si le nom du fichier commence par "ftp://", + le fichier sera récupéré depuis le serveur ftp, et affiché. + Pour les fichiers du système local, le chemin doit être absolu ou + relatif au chemin d'exécution du script PHP. + + + Vous pouvez spécifier l'attribut optionnel assign + qui défini une variable de template dans laquelle la sortie + sera stockée plutôt qude d'être affichée (nouveau dans Smarty 1.5.0). + + + Note technique + Ne supporte pas les redirections http. Assurez vous d'inclure les + slash de fin sur votre page web si nécessaire. + + + + Note technique + + Si la sécurité est activée, vous ne pourez récupérer les + fichiers du système local que s'ils sont situés dans l'un des + répertoires sécurisé ($secure_dir). + + + +fetch + +{* Inclus du javascript dans votre template *} +{fetch file="/export/httpd/www.domain.com/docs/navbar.js"} + +{* récupère les informations météo d'un autre site sur votre page *} +{fetch file="http://www.myweather.com/68502/"} + +{* récupère les titres depuis un fichier ftp *} +{fetch file="ftp://user:password@ftp.domain.com/path/to/currentheadlines.txt"} + +{* assigne le contenu récupéré à une variable de template *} +{fetch file="http://www.myweather.com/68502/" assign="weather"} +{if $weather ne ""} + <b>{$weather}</b> +{/if} + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml b/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml new file mode 100644 index 00000000..0284f924 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml @@ -0,0 +1,146 @@ + + + + html_checkboxes + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + name + chaîne de caractères + Non + checkbox + Nom de la liste de cases à cocher + + + values + array + Oui, à moins que vous n'utilisiez l'attribut + option + n/a + Un tableau de valeurs pour les cases à + cocher + + + output + array + Oui, à moins que vous n'utilisiez l'attribut + option + n/a + Un tableau de sortie pour les cases à cocher + + + checked + chaîne de caractères + Non + empty + Les éléments cochés de la liste + + + options + associative array + Oui, à moins que vous n'utilisiez values et + output + n/a + Un tableau associatif de valeurs et + sorties + + + separator + chaîne de caractères + Non + empty + chaîne de caractère pour séparer chaque case + à cocher + + + + + + html_checkboxes est une fonction utilisateur qui crée un groupe de + cases à cocher avec les données fournies. Elle prend en compte la liste + des éléments sélectionnés par défaut. Les attributs requis sont + values et output, à moins que vous n'utilisiez options à la place. + La sortie générée est compatible XHTML. + + + Tous les paramètres qui ne sont pas listés ci-dessus sont affichés + en tant que paires nom/valeur dans chaque balise <input> crée. + + +html_checkboxes + +index.php: + +require('Smarty.class.php'); +$smarty = new Smarty; +$smarty->assign('id_client', array(1000,1001,1002,1003)); +$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane +Johnson','Charlie Brown')); +$smarty->assign('client_id', 1001); +$smarty->display('index.tpl'); + + +index.tpl: + +{html_checkboxes values=$id_client checked=$client_id output=$nom_client separator="<br />"} + + +index.php: + +require('Smarty.class.php'); +$smarty = new Smarty; +$smarty->assign('cust_checkboxes', array( + 1001 => 'Joe Schmoe', + 1002 => 'Jack Smith', + 1003 => 'Jane Johnson','Charlie Brown')); +$smarty->assign('client_id', 1001); +$smarty->display('index.tpl'); + +index.tpl: + +{html_checkboxes name="id" options=$cust_checkboxes checked=$client_id separator="<br />"} + + +SORTIE: (pour les deux exemples) + +<input type="checkbox" name="id[]" value="1000">Joe Schmoe<br /> +<input type="checkbox" name="id[]" value="1001" checked="checked"><br /> +<input type="checkbox" name="id[]" value="1002">Jane Johnson<br /> +<input type="checkbox" name="id[]" value="1003">Charlie Brown<br /> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-html-image.xml b/docs/fr/designers/language-custom-functions/language-function-html-image.xml new file mode 100644 index 00000000..be963ebe --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-html-image.xml @@ -0,0 +1,135 @@ + + + + html_image + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + file + chaîne de caractères + Oui + n/a + nom/chemin des images + + + border + chaîne de caractères + Non + 0 + Bordure de l'image + + + height + chaîne de caractères + Non + Hauteur de l'image actuelle + Hauteur de l'image à afficher + + + width + chaîne de caractères + Non + Longueur de l'image actuelle + Longueur de l'image à afficher + + + basedir + chaîne de caractères + non + racine du serveur web + répertoire depuis lequel baser le calcul des + chemins relatifs + + + link + chaîne de caractères + non + n/a + lien sur lequel l'image pointe + + + + + + html_image est une fonction utilisateur qui génère la balise + HTML pour une image. La hauteur et la longueur de l'image sont calculés + automatiquement depuis le fichier image si aucune n'est spécifiée. + + + basedir est le répertoire de base depuis lequel seront calculés les + chemins relatifs. Si non spécifié, la racine du serveur web est utilisé + (variable d'environnement DOCUMENT_ROOT). Si la sécurité est activée, + l'image doit se situer dans un répertoire sécurisé. + + + link est la valeur href à laquelle lier l'image. Si link est défini, + une balise <a href="VALEURLINK"><a> est placée autour de + l'image. + + + Note technique + + html_image requiert un accès au disque dur pour lire l'image et + calculer ses dimensions. Si vous n'utilisez pas un cache, il + est généralement préférable d'éviter d'utiliser html_image + et de laisser les balises images statiques pour de meilleures + performances. + + + +html_image + +index.php: + +require('Smarty.class.php'); +$smarty = new Smarty; +$smarty->display('index.tpl'); + +index.tpl: + +{image file="pumpkin.jpg"} +{image file="/path/from/docroot/pumpkin.jpg"} +{image file="../path/relative/to/currdir/pumpkin.jpg"} + +SORTIE: (possible) + +<img src="pumpkin.jpg" border="0" width="44" height="68"> +<img src="/path/under/docroot/pumpkin.jpg" border="0" width="44" height="68"> +<img src="../path/relative/to/currdir/pumpkin.jpg" border="0" width="44" height="68"> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-html-options.xml b/docs/fr/designers/language-custom-functions/language-function-html-options.xml new file mode 100644 index 00000000..a99bf411 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-html-options.xml @@ -0,0 +1,154 @@ + + + + html_options + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + values + array + Oui, à moins que vous n'utilisiez + l'attribut options + n/a + un tableau de valeurs pour les listes + déroulantes + + + output + array + Oui, à moins que vous n'utilisiez + l'attribut options + n/a + Un tableau de libellés pour la liste + déroulante + + + selected + chaîne de caractères/tableau + Non + empty + Les éléments sélectionnés + + + options + Tableau associatif + Oui, à moins que vous n'utilisiez option + et values + n/a + Un tableau associatif valeur / libellé + + + name + chaîne de caractères + Non + empty + Nom du goupe d'options + + + + + + html_options est une fonction utilisateur qui crée un groupe d'options + avec les données fournies. Elle prend en charge les éléments + sélectionnés par défaut. Les attributs requis sont values et output, + à moins que vous n'utilisiez options à la place. + + + Si la valeur donnée est un tableau, elle sera traitée comme un + OPTGROUP html, et affichée. La récursivité est supportée avec + OPTGROUP. La sortie est compatible XHTML. + + + Si l'attribut optionnel name est donné, les + balises <select name="groupname"></select> entoureront la + liste d'options. + + + Tous les paramètres qui ne sont pas dans la liste ci-dessus sont + affichés en tant que paires nom / valeur. Ils sont ignorés si + le paramètre optionnel name n'est pas donné. + + +html_options + +index.php: + +require('Smarty.class.php'); +$smarty = new Smarty; +$smarty->assign('id_client', array(1000,1001,1002,1003)); +$smarty->assign('nom_client', array('Joe Schmoe','Jack Smith','Jane +Johnson','Charlie Brown')); +$smarty->assign('client_id', 1001); +$smarty->display('index.tpl'); + +index.tpl: + +<select name=client_id> + {html_options values=$id_client selected=$client_id output=$nom_client} +</select> + + +index.php: + +require('Smarty.class.php'); +$smarty = new Smarty; +$smarty->assign('cust_options', array( + 1001 => 'Joe Schmoe', + 1002 => 'Jack Smith', + 1003 => 'Jane Johnson', + 1004 => 'Charlie Brown')); +$smarty->assign('client_id', 1001); +$smarty->display('index.tpl'); + +index.tpl: + +<select name=client_id> + {html_options options=$cust_options selected=$client_id} +</select> + + +SORTIE: (valable pour les deux exemples) + +<select name=client_id> + <option value="1000">Joe Schmoe</option> + <option value="1001" selected="selected">Jack Smith</option> + <option value="1002">Jane Johnson</option> + <option value="1003">Charlie Brown</option> +</select> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-html-radios.xml b/docs/fr/designers/language-custom-functions/language-function-html-radios.xml new file mode 100644 index 00000000..4ef98896 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-html-radios.xml @@ -0,0 +1,148 @@ + + + + html_radios + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + name + chaîne de caractères + Non + radio + nom de la liste boutons radio + + + values + tableau + Oui, à moins que vous n'utilisiez l'attribut + options + n/a + Le tableau des valeurs des boutons radio + + + output + tableau + Oui, à moins que vous n'utilisiez l'attribut + options + n/a + Un tableau de libellés pour les boutons radio + + + checked + chaîne de caractères + Non + empty + Les boutons radios sélectionnés + + + options + tableau associatif + Oui, à moins que vous n'utilisiez values + et outputs + n/a + un tableau associatif valeurs / libellés + + + separator + chaîne de caractères + Non + empty + chaîne de séparation à placer entre les + boutons radio + + + + + + html_radio est une fonction utilisateur qui crée des boutons radio + html à partir des données fournies. Elle prend en charge les éléments + sélectionnés par défaut. Les attributs requis sont values et output, + à moins que vous n'utilisiez options à la place. La sortie générée est + compatible XHTML. + + + Tous les paramètres qui ne sont pas dans la liste ci dessus sont + affichés en tant que paires nom / valeur dans chaque balise <input> + créée. + + + +html_radios + +index.php: + +require('Smarty.class.php'); +$smarty = new Smarty; +$smarty->assign('id_client', array(1000,1001,1002,1003)); +$smarty->assign('nom_client', array('Joe Schmoe','Jack Smith','Jane +Johnson','Charlie Brown')); +$smarty->assign('client_id', 1001); +$smarty->display('index.tpl'); + + +index.tpl: + +{html_radios values=$id_client checked=$client_id output=$nom_client separator="<br />"} + + +index.php: + +require('Smarty.class.php'); +$smarty = new Smarty; +$smarty->assign('cust_radios', array( + 1001 => 'Joe Schmoe', + 1002 => 'Jack Smith', + 1003 => 'Jane Johnson', + 1004 => 'Charlie Brown')); +$smarty->assign('client_id', 1001); +$smarty->display('index.tpl'); + + +index.tpl: + +{html_radios name="id" options=$cust_radios checked=$client_id separator="<br />"} + + +SORTIE: (both examples) + +<input type="radio" name="id[]" value="1000">Joe Schmoe<br /> +<input type="radio" name="id[]" value="1001" checked="checked"><br /> +<input type="radio" name="id[]" value="1002">Jane Johnson<br /> +<input type="radio" name="id[]" value="1003">Charlie Brown<br /> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml b/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml new file mode 100644 index 00000000..1d0ace53 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml @@ -0,0 +1,325 @@ + + + + html_select_date + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + prefix + chaîne de caractères + Non + Date_ + Avec quoi préfixer le nom de variable + + + time + timestamp/YYYY-MM-DD + Non + la date courante au format unix YYYY-MM-DD + format + la date / heure à utiliser + + + start_year + chaîne de caractères + Non + current year + La première année dans la liste déroulante, soit + le numéro de l'année, soit un nombre relatif à l'année + courante (+/- N). + + + end_year + chaîne de caractères + Non + même chose que start_year + La dernière année dans la liste déroulante, soit + le numéro de l'année, soit un nombre relatif à l'année + courante (+/- N). + + + display_days + boolean + Non + true + Si l'on souhaite afficher les jours ou pas. + + + display_months + boolean + Non + true + Si l'on souhaite afficher les mois ou pas. + + + display_years + boolean + Non + true + Si l'on souhaite afficher les années ou pas. + + + month_format + chaîne de caractères + Non + %B + le format du mois (strftime) + + + day_format + chaîne de caractères + Non + %02d + Le format du jour (sprintf) + + + day_value_format + chaîne de caractères + Non + %d + le format de la valeur du jour (sprintf) + + + year_as_text + boolean + Non + false + S'il faut afficher l'année au format texte + + + reverse_years + boolean + Non + false + Affiche les années dans l'ordre inverse + + + field_array + chaîne de caractères + Non + null + + Si un nom est donné, la liste déroulante sera affichée + de telle façon que les résultats seront retournés à PHP + sous la forme nom[Day] (jour), nom[Year] (année), + nom[Month] (Mois). + + + + day_size + chaîne de caractères + Non + null + Ajoute un attribut size à la liste + déroulante des jours. + + + month_size + chaîne de caractères + Non + null + Ajoute un attribut size à la liste + déroulante des mois. + + + year_size + chaîne de caractères + Non + null + Ajoute un attribut size à la liste + déroulante des années. + + + all_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires à + toutes les balises select/input. + + + day_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select/input du jour. + + + month_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select/input du mois. + + + year_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select/input de l'année. + + + field_order + chaîne de caractères + Non + MDY + L'ordre dans lequel afficher les + listes déroulantes. + + + field_separator + chaîne de caractères + Non + \n + la chaîne de caractères affichée entre les + différents champs. + + + month_value_format + chaîne de caractères + Non + %m + Le format strftime de la valeur des mois, par défaut %m + pour les numéros. + + + + + + html_select_date est une fonction utilisateur qui crée des listes + déroulantes pour saisir la date. Elle peut afficher n'importe quel + jour, mois et année. + + +html_select_date + +{html_select_date} + + +SORTIE: + +<select name="Date_Month"> +<option value="1">January</option> +<option value="2">February</option> +<option value="3">March</option> +<option value="4">April</option> +<option value="5">May</option> +<option value="6">June</option> +<option value="7">July</option> +<option value="8">August</option> +<option value="9">September</option> +<option value="10">October</option> +<option value="11">November</option> +<option value="12" selected>December</option> +</select> +<select name="Date_Day"> +<option value="1">01</option> +<option value="2">02</option> +<option value="3">03</option> +<option value="4">04</option> +<option value="5">05</option> +<option value="6">06</option> +<option value="7">07</option> +<option value="8">08</option> +<option value="9">09</option> +<option value="10">10</option> +<option value="11">11</option> +<option value="12">12</option> +<option value="13" selected>13</option> +<option value="14">14</option> +<option value="15">15</option> +<option value="16">16</option> +<option value="17">17</option> +<option value="18">18</option> +<option value="19">19</option> +<option value="20">20</option> +<option value="21">21</option> +<option value="22">22</option> +<option value="23">23</option> +<option value="24">24</option> +<option value="25">25</option> +<option value="26">26</option> +<option value="27">27</option> +<option value="28">28</option> +<option value="29">29</option> +<option value="30">30</option> +<option value="31">31</option> +</select> +<select name="Date_Year"> +<option value="2001" selected>2001</option> +</select> + + + + +html_select_date + + +{* le démarage et la fin de l'année peuvent être relatif à l'année courante *} +{html_select_date prefix="StartDate" time=$time start_year="-5" end_year="+1" display_days=false} + +SORTIE: (current year is 2000) + +<select name="StartDateMonth"> +<option value="1">January</option> +<option value="2">February</option> +<option value="3">March</option> +<option value="4">April</option> +<option value="5">May</option> +<option value="6">June</option> +<option value="7">July</option> +<option value="8">August</option> +<option value="9">September</option> +<option value="10">October</option> +<option value="11">November</option> +<option value="12" selected>December</option> +</select> +<select name="StartDateYear"> +<option value="1999">1995</option> +<option value="1999">1996</option> +<option value="1999">1997</option> +<option value="1999">1998</option> +<option value="1999">1999</option> +<option value="2000" selected>2000</option> +<option value="2001">2001</option> +</select> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-html-select-time.xml b/docs/fr/designers/language-custom-functions/language-function-html-select-time.xml new file mode 100644 index 00000000..4c4004c8 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-html-select-time.xml @@ -0,0 +1,326 @@ + + + + html_select_time + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + prefix + chaîne de caractères + Non + Time_ + Par quoi préfixer la variable. + + + time + timestamp + Non + current time + Quel jour / heure utiliser. + + + display_hours + boolean + Non + true + S'il faut afficher l'heure. + + + display_minutes + boolean + Non + true + S'il faut afficher les minutes. + + + display_seconds + boolean + Non + true + S'il faut afficher les secondes. + + + display_meridian + boolean + Non + true + S'il faut afficher le méridian (am/pm) + + + use_24_hours + boolean + Non + true + S'il faut utiliser l'horloge 24 heure. + + + minute_interval + integer + Non + 1 + Intervalle des minutes dans la liste + déroulante + + + second_interval + integer + Non + 1 + Intervalle des secondes dans la liste + déroulante + + + field_array + chaîne de caractères + Non + n/a + Nom du tableau dans lequel les valeures + seront stockées. + + + all_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input. + + + hour_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input de l'heure. + + + minute_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input des minutes. + + + second_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input des secondes. + + + meridian_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input du méridian. + + + + + + html_select_time est une fonction utilisateur qui crée des listes + déroulantes pour saisir une heure. Elle prends en charge l'heure, + les minutes, les secondes et le méridian. + + +html_select_time + +{html_select_time use_24_hours=true} + + +SORTIE: + +<select name="Time_Hour"> +<option value="00">00</option> +<option value="01">01</option> +<option value="02">02</option> +<option value="03">03</option> +<option value="04">04</option> +<option value="05">05</option> +<option value="06">06</option> +<option value="07">07</option> +<option value="08">08</option> +<option value="09" selected>09</option> +<option value="10">10</option> +<option value="11">11</option> +<option value="12">12</option> +<option value="13">13</option> +<option value="14">14</option> +<option value="15">15</option> +<option value="16">16</option> +<option value="17">17</option> +<option value="18">18</option> +<option value="19">19</option> +<option value="20">20</option> +<option value="21">21</option> +<option value="22">22</option> +<option value="23">23</option> +</select> +<select name="Time_Minute"> +<option value="00">00</option> +<option value="01">01</option> +<option value="02">02</option> +<option value="03">03</option> +<option value="04">04</option> +<option value="05">05</option> +<option value="06">06</option> +<option value="07">07</option> +<option value="08">08</option> +<option value="09">09</option> +<option value="10">10</option> +<option value="11">11</option> +<option value="12">12</option> +<option value="13">13</option> +<option value="14">14</option> +<option value="15">15</option> +<option value="16">16</option> +<option value="17">17</option> +<option value="18">18</option> +<option value="19">19</option> +<option value="20" selected>20</option> +<option value="21">21</option> +<option value="22">22</option> +<option value="23">23</option> +<option value="24">24</option> +<option value="25">25</option> +<option value="26">26</option> +<option value="27">27</option> +<option value="28">28</option> +<option value="29">29</option> +<option value="30">30</option> +<option value="31">31</option> +<option value="32">32</option> +<option value="33">33</option> +<option value="34">34</option> +<option value="35">35</option> +<option value="36">36</option> +<option value="37">37</option> +<option value="38">38</option> +<option value="39">39</option> +<option value="40">40</option> +<option value="41">41</option> +<option value="42">42</option> +<option value="43">43</option> +<option value="44">44</option> +<option value="45">45</option> +<option value="46">46</option> +<option value="47">47</option> +<option value="48">48</option> +<option value="49">49</option> +<option value="50">50</option> +<option value="51">51</option> +<option value="52">52</option> +<option value="53">53</option> +<option value="54">54</option> +<option value="55">55</option> +<option value="56">56</option> +<option value="57">57</option> +<option value="58">58</option> +<option value="59">59</option> +</select> +<select name="Time_Second"> +<option value="00">00</option> +<option value="01">01</option> +<option value="02">02</option> +<option value="03">03</option> +<option value="04">04</option> +<option value="05">05</option> +<option value="06">06</option> +<option value="07">07</option> +<option value="08">08</option> +<option value="09">09</option> +<option value="10">10</option> +<option value="11">11</option> +<option value="12">12</option> +<option value="13">13</option> +<option value="14">14</option> +<option value="15">15</option> +<option value="16">16</option> +<option value="17">17</option> +<option value="18">18</option> +<option value="19">19</option> +<option value="20">20</option> +<option value="21">21</option> +<option value="22">22</option> +<option value="23" selected>23</option> +<option value="24">24</option> +<option value="25">25</option> +<option value="26">26</option> +<option value="27">27</option> +<option value="28">28</option> +<option value="29">29</option> +<option value="30">30</option> +<option value="31">31</option> +<option value="32">32</option> +<option value="33">33</option> +<option value="34">34</option> +<option value="35">35</option> +<option value="36">36</option> +<option value="37">37</option> +<option value="38">38</option> +<option value="39">39</option> +<option value="40">40</option> +<option value="41">41</option> +<option value="42">42</option> +<option value="43">43</option> +<option value="44">44</option> +<option value="45">45</option> +<option value="46">46</option> +<option value="47">47</option> +<option value="48">48</option> +<option value="49">49</option> +<option value="50">50</option> +<option value="51">51</option> +<option value="52">52</option> +<option value="53">53</option> +<option value="54">54</option> +<option value="55">55</option> +<option value="56">56</option> +<option value="57">57</option> +<option value="58">58</option> +<option value="59">59</option> +</select> +<select name="Time_Meridian"> +<option value="am" selected>AM</option> +<option value="pm">PM</option> +</select> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-html-table.xml b/docs/fr/designers/language-custom-functions/language-function-html-table.xml new file mode 100644 index 00000000..eb066305 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-html-table.xml @@ -0,0 +1,136 @@ + + + + html_table + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + loop + array + Oui + n/a + Tableau de données à parcourir + + + cols + integer + Non + 3 + Nombre de colonnes du tableau + + + table_attr + chaîne de caractères + Non + border="1" + attributs pour la balise table + + + tr_attr + chaîne de caractères + Non + empty + attributs pour les balises tr (les tableaux sont + parcourus) + + + td_attr + chaîne de caractères + Non + empty + attributs pour les balises td (les tableaux sont + parcourus) + + + trailpad + chaîne de caractères + Non + &nbsp; + valeur avec laquelle remplir les cellules + restantes de la dernière ligne (si il y en a) + + + + + + html_table est une fonction utilisateur + qui transforme un tableau de données dans un tabeau HTML. L'attribut + cols détermine le nombre de colonne du tableau. + Les attributs table_attr, tr_attr + et td_attr déterminent les attributs donnés aux + balises table, tr et td. Si tr_attr ou + td_attr sont des tableaux, ils seront parcourus. + trailpad est la valeur avec laquelle remplir + les cellules restantes de la dernière ligne, s'il y en a une. + + +html_table + +index.php: + +require('Smarty.class.php'); +$smarty = new Smarty; +$smarty->assign('data',array(1,2,3,4,5,6,7,8,9)); +$smarty->assign('tr',array('bgcolor="#eeeeee"','bgcolor="#dddddd"')); +$smarty->display('index.tpl'); + +index.tpl: + +{html_table loop=$data} +{html_table loop=$data cols=4 table_attr='border="0"'} +{html_table loop=$data cols=4 tr_attr=$tr} + +SORTIE: + +<table border="1"> +<tr><td>1</td><td>2</td><td>3</td></tr> +<tr><td>4</td><td>5</td><td>6</td></tr> +<tr><td>7</td><td>8</td><td>9</td></tr> +</table> +<table border="0"> +<tr><td>1</td><td>2</td><td>3</td><td>4</td></tr> +<tr><td>5</td><td>6</td><td>7</td><td>8</td></tr> +<tr><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr> +</table> +<table border="1"> +<tr bgcolor="#eeeeee"><td>1</td><td>2</td><td>3</td><td>4</td></tr> +<tr bgcolor="#dddddd"><td>5</td><td>6</td><td>7</td><td>8</td></tr> +<tr bgcolor="#eeeeee"><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr> +</table> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-mailto.xml b/docs/fr/designers/language-custom-functions/language-function-mailto.xml new file mode 100644 index 00000000..4646e899 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-mailto.xml @@ -0,0 +1,152 @@ + + + + mailto + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + address + chaîne de caractères + Oui + n/a + l'adresse email + + + text + chaîne de caractères + Non + n/a + le texte à afficher, par défaut l'adresse email + + + encode + chaîne de caractères + Non + none + Comment encoder l'adresse email. + none, hex et javascript sont des valeurs correctes. + + + cc + chaîne de caractères + Non + n/a + Les adresses email en copie (Cc). + Séparez les entrées par une virgule. + + + bcc + chaîne de caractères + Non + n/a + Les adresses email en copie cachées (Bcc). + Séparez les entrées par une virgule. + + + subject + chaîne de caractères + Non + n/a + Sujet de l'email. + + + newsgroups + chaîne de caractères + Non + n/a + newsgroup ou poster le message. + Séparez les entrées par une virgule. + + + followupto + chaîne de caractères + Non + n/a + Adresses ou transmettre le message. + Séparez les entrées par une virgule. + + + + extra + chaîne de caractères + Non + n/a + Toute information que vous souhaitez passer au lien, + comme par exemple une classe css. + + + + + + mailto crée un lien mailto automatiquement encodé (optionnel). + L'encodage rend la tâche de récupération des e-mails sur votre + site plus difficiles aux "web spiders". + + + Note technique + + javascript n'est certainement pas la forme d'encodage la plus robuste. + Vous pouvez également utiliser un encodage hexadécimal. + + + +mailto + +{mailto address="me@domain.com"} +{mailto address="moi@domaine.com" text="send me some mail"} +{mailto address="moi@domaine.com" encode="javascript"} +{mailto address="moi@domaine.com" encode="hex"} +{mailto address="moi@domaine.com" subject="Hello to you!"} +{mailto address="moi@domaine.com" cc="you@domain.com,they@domain.com"} +{mailto address="moi@domaine.com" extra='class="email"'} + +SORTIE: + +<a href="mailto:moi@domaine.com" >moi@domaine.com</a> +<a href="mailto:moi@domaine.com" >send me some mail</a> +<SCRIPT language="javascript">eval(unescape('%64%6f%63%75%6d%65%6e%74%2e%77%72%6 +9%74%65%28%27%3c%61%20%68%72%65%66%3d%22%6d%61%69%6c%74%6f%3a%6d%65%40%64%6f%6d% +61%69%6e%2e%63%6f%6d%22%20%3e%6d%65%40%64%6f%6d%61%69%6e%2e%63%6f%6d%3c%2f%61%3e +%27%29%3b'))</SCRIPT> +<a href="mailto:%6d%65@%64%6f%6d%61%69%6e.%63%6f%6d" >&#x6d;&#x65;&#x40;&#x64;& +#x6f;&#x6d;&#x61;&#x69;&#x6e;&#x2e;&#x63;&#x6f;&#x6d;</a> +<a href="mailto:moi@domaine.com?subject=Hello%20to%20you%21" >moi@domaine.com</a> +<a href="mailto:moi@domaine.com?cc=you@domain.com%2Cthey@domain.com" >moi@domaine.com</a> +<a href="mailto:moi@domaine.com" class="email">moi@domaine.com</a> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-math.xml b/docs/fr/designers/language-custom-functions/language-function-math.xml new file mode 100644 index 00000000..d7ce5fd1 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-math.xml @@ -0,0 +1,150 @@ + + + + math + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + equation + chaîne de caractères + Oui + n/a + L'opération à éxécuter + + + format + chaîne de caractères + Non + n/a + Le format du résultat (sprintf) + + + var + numeric + Oui + n/a + Les variables de l'opération + + + assign + chaîne de caractères + Non + n/a + Variable de template dans laquelle la sortie + sera assignée + + + [var ...] + numeric + Oui + n/a + Valeurs des variables de l'opération + + + + + + math autorise les designers de templates à effectuer des opérations + dans le template. Toute valeur numérique peut être utilisée dans une + opération, et le résultat sera affiché à la place des balises + "equation". Les variables utilisées dans l'opération sont passées en + tant que paramètre, et peuvent être des variables de templates ou des + valeurs statiques. +, -, /, *, abs, ceil, cos, + exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, + srans et tan sont tous des opérateurs valides. Voir la + documentation PHP pour plus d'informations sur ces fonctions + mathématiques. + + + Si vous spécifiez l'attribut assign, la sortie sera assignée à la variable + donnée plutôt que d'être directement affichée. + + + Note technique + + math est une fonction coûteuse en terme de performances, du fait + qu'elle utilise la fonction PHP eval (). Effectuer les calculs + dans votre code PHP est beaucoup plus efficient, donc, chaque fois + que possible, effectuez vos calculs directement dans PHP et assignez + le résultat au template. Evitez coût que coût les appels + répétitifs à la fonction math, comme on pourait le faire une + une boucle section. + + + +math + +{* $height=4, $width=5 *} + +{math equation="x + y" x=$height y=$width} + +SORTIE: + +9 + + +{* $row_height = 10, $row_width = 20, #col_div# = 2, assigned in template *} + +{math equation="height * width / division" + height=$row_height + width=$row_width + division=#col_div#} + +SORTIE: + +100 + + +{* vous pouvez utiliser des parenthèses *} + +{math equation="(( x + y ) / z )" x=2 y=10 z=2} + +SORTIE: + +6 + + +{* vous pouvez définir un format sprintf pour l'affichage *} + +{math equation="x + y" x=4.4444 y=5.0000 format="%.2f"} + +SORTIE: + +9.44 + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-popup-init.xml b/docs/fr/designers/language-custom-functions/language-function-popup-init.xml new file mode 100644 index 00000000..056ec4f4 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-popup-init.xml @@ -0,0 +1,47 @@ + + + + popup_init + + popup est une intégration de overLib, une librairie capable de réaliser + des fenêtres surgissantes. (nous parlerons de "popup"). + Ce type de fenêtre est utilisé pour apporter des informations + contextuelles, comme des infobulles d'aides ou astuces. + popup_init doit être appelé une fois, en début de page si vous comptez + utiliser la fonction popup. + overLib à été écrit par Erik Bosrup. Le site d'overlib est situé à + l'adresse http://www.bosrup.com/web/overlib/. + + + Comme dans Smarty 2.1.2, overLib n'est PAS fournie dans la distribution. + Téléchargez overLib, déposez overlib.js dans votre arborescence web et + indiquez le chemin relatif à ce fichier dans l'attribut src de + popup_init. + + +popup_init + +{* popup_init doit être appelé une fois en début de page. *} +{popup_init src="/javascripts/overlib.js"} + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-popup.xml b/docs/fr/designers/language-custom-functions/language-function-popup.xml new file mode 100644 index 00000000..d9c8f580 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-popup.xml @@ -0,0 +1,443 @@ + + + + popup + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + text + chaîne de caractères + Oui + n/a + le texte/code html à afficher dans la popup + + + trigger + chaîne de caractères + Non + onMouseOver + L'évènement utilisé pour rendre la popup active, + onMouseOver ou onClick. + + + sticky + boolean + Non + false + Rends la popup active jusqu'a ce qu'elle soit + explicitement fermée. + + + caption + chaîne de caractères + Non + n/a + Défini le libellé du titre + + + fgcolor + chaîne de caractères + Non + n/a + couleur interne de la popup + + + bgcolor + chaîne de caractères + Non + n/a + couleur de la bordure de la popup + + + textcolor + chaîne de caractères + Non + n/a + couleur du texte à l'intérieur de la + popup + + + capcolor + chaîne de caractères + Non + n/a + couleur du libellé de la popup + + + closecolor + chaîne de caractères + Non + n/a + couleur du texte de fermeture + + + textfont + chaîne de caractères + Non + n/a + la police à utiliser dans le texte principal + + + captionfont + chaîne de caractères + Non + n/a + la police à utiliser dans le libellé + + + closefont + chaîne de caractères + Non + n/a + la police pour le texte de fermeture + + + textsize + chaîne de caractères + Non + n/a + taille de la police texte prinicpal + + + captionsize + chaîne de caractères + Non + n/a + taille de la police du libellé + + + closesize + chaîne de caractères + Non + n/a + taille de la police du bouton "fermer" + + + width + integer + Non + n/a + Longeur de la popup + + + height + integer + Non + n/a + Hauteur de la popup + + + left + boolean + Non + false + la popup va à gauche de la souris + + + right + boolean + Non + false + la popup va à droite de la souris + + + center + boolean + Non + false + la popup est centrée par rapport à la + position de la souris + + + above + boolean + Non + false + la popup est au dessus de la souris. NOTE: + possible uniquement si la hauteur est définie + + + below + boolean + Non + false + la popup apparait en dessous de la souris + + + border + integer + Non + n/a + rends la bordure de la popup plus épaisse ou plus + fine + + + offsetx + integer + Non + n/a + A quelle distance du curseur la popup apparaitra + , horizontalement. + + + offsety + integer + Non + n/a + A quelle distance du curseur la popup apparaitra + , verticalement. + + + fgbackground + url to image + Non + n/a + Une image à utiliser à la place de la couleur de + fonds dans la popup + + + bgbackground + url to image + Non + n/a + Image à utiliser à la place de la bordure de la + popup. NOTE: vous veillerez à définir bgcolor à "" ou la + couleur apparaitra de même. NOTE: Lorsque vous avez un + lien de fermeture, Netscape effectuera un nouveau rendu + des cellules du tableau, affichant mal les éléments + + + closetext + chaîne de caractères + Non + n/a + définit le texte de fermeture par autre chose + que "Close" + + + noclose + boolean + Non + n/a + N'affiche pas le bouton "Close" pour les fenêtres + "collantes". + + + + status + chaîne de caractères + Non + n/a + défini le texte de la barre de statut + du navigateur + + + autostatus + boolean + Non + n/a + Défini le texte de la barre de statut au contenu + de la popup. NOTE: Ecrase l'attribut status. + + + autostatuscap + chaîne de caractères + Non + n/a + Défini le texte de la barre de statut au libellé + de la popup. NOTE: Ecrase l'attribut status. + + + inarray + integer + Non + n/a + indique à overLib de lire le texte à cet index dans le + tableau ol_text, situé dans overlib.js. Ce paramètre peut être + utilisé à la place de text. + + + caparray + integer + Non + n/a + indique à overlib de lire le libellé depuis le + tableau ol_caps + + + capicon + url + Non + n/a + affiche l'image spécifiée avant le libellé de la + popup + + + snapx + integer + Non + n/a + Aligne la popup sur une grille horizontale + + + snapy + integer + Non + n/a + Aligne la popup sur une grille verticale + + + fixx + integer + Non + n/a + vérrouille la popup à une position horizontale. + Note: remplace les autres paramètres de position + horizontale + + + fixy + integer + Non + n/a + vérouille la popup à une position verticale + Note: remplace les autres paramètres de position + verticale + + + background + url + Non + n/a + défini l'image à utiliser plutôt que le tableau + de fond + + + padx + integer,integer + Non + n/a + écarte l'image de fond du reste des éléments + avec un espace horizontal, pour le positionnement du texte. + Note: c'est un attribut à deux paramètres. + + + pady + integer,integer + Non + n/a + écarte l'image de fond du reste des éléments + avec un espace vertical, pour le positionnement du texte. + Note: c'est un attribut à deux paramètres. + + + fullhtml + boolean + Non + n/a + vous autorise à placer du code html en tant que + contenu de la popup. Le code html est attendu dans + l'attribut text. + + + frame + chaîne de caractères + Non + n/a + contrôle la popup dans un cadre différent. + Voir la documentation d'overlib pour plus de détails + sur cette fonction. + + + timeout + chaîne de caractères + Non + n/a + Appelle la fonction javascript spécifiée et prends + sa valeur de retour comme texte devant être affiché + dans la popup. + + + delay + integer + Non + n/a + la popup se comporte comme une infobulle. + Elle disparaitra au bout d'un certain délai, en + millisecondes. + + + hauto + boolean + Non + n/a + Détermine automatiquement si la popup doit être + à gauche ou à droite de la souris + + + vauto + boolean + Non + n/a + Détermine automatiquement si la popup doit être + au-dessus ou au-dessous de la souris + + + + + + popup est utilisé pour créer une fenêtre popup javascript. + + +popup + +{* popup_init doit être appelé en haut de votre page *} +{popup_init src="/javascripts/overlib.js"} + +{* création d'un lien avec une popup qui apparait sur l'évènement onMouseOver *} +<A href="mypage.html" {popup text="Ce lien vous amène sur ma page!"}>mypage</A> + +{* vous pouvez utiliser du html, des liens, etc dans vos popup *} +<A href="mypage.html" {popup sticky=true caption="mypage contents" +text="<UL><LI>links<LI>pages<LI>images</UL>" snapx=10 snapy=10}>mypage</A> + +SORTIE: + +(allez sur le site officiel de Smarty pour des exemples.) + + + \ No newline at end of file diff --git a/docs/fr/designers/language-custom-functions/language-function-textformat.xml b/docs/fr/designers/language-custom-functions/language-function-textformat.xml new file mode 100644 index 00000000..8bb35f98 --- /dev/null +++ b/docs/fr/designers/language-custom-functions/language-function-textformat.xml @@ -0,0 +1,260 @@ + + + + textformat + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + style + chaîne de caractères + Non + n/a + style prédéfini + + + indent + number + Non + 0 + Taille de l'indentation pour chaque + ligne + + + indent_first + number + Non + 0 + Taille de l'indentation de la + première ligne + + + indent_char + chaîne de caractères + Non + (single space) + Le caractère (ou la chaîne) à utiliser pour + indenter + + + wrap + number + Non + 80 + A combien de caractères doit on ajuster chaque + ligne + + + wrap_char + chaîne de caractères + Non + \n + Le caractère (ou chaîne de caractères) avec lequel + terminer les lignes + + + wrap_cut + boolean + Non + false + Si true, wrap réduira les lignes au caractère exact + au lieu d'ajuster à la fin d'un mot + + + assign + chaîne de caractères + Non + n/a + Le nom de la variable PHP dans laquelle la + sortie sera assignée + + + + + + textformat est une fonction de bloc utilisée pour formater du texte. + Elle nettoie la chaîne de ses espaces et caractères spéciaux, puis + formate les paragraphes en ajustant ces derniers à une certaine limite, + puis en indentant les lignes. + + + Vous pouvez soit utiliser un style prédéfini, soit définir explicitement + chaque attribut. Actuellement, seul le style prédéfini "email" est + disponible. + + +textformat + +{textformat wrap=40} + +This is foo. +This is foo. +This is foo. +This is foo. +This is foo. +This is foo. + +This is bar. + +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. + +{/textformat} + +SORTIE: + +This is foo. This is foo. This is foo. +This is foo. This is foo. This is foo. + +This is bar. + +bar foo bar foo foo. bar foo bar foo +foo. bar foo bar foo foo. bar foo bar +foo foo. bar foo bar foo foo. bar foo +bar foo foo. bar foo bar foo foo. + + +{textformat wrap=40 indent=4} + +This is foo. +This is foo. +This is foo. +This is foo. +This is foo. +This is foo. + +This is bar. + +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. + +{/textformat} + +SORTIE: + + This is foo. This is foo. This is + foo. This is foo. This is foo. This + is foo. + + This is bar. + + bar foo bar foo foo. bar foo bar foo + foo. bar foo bar foo foo. bar foo + bar foo foo. bar foo bar foo foo. + bar foo bar foo foo. bar foo bar + foo foo. + +{textformat wrap=40 indent=4 indent_first=4} + +This is foo. +This is foo. +This is foo. +This is foo. +This is foo. +This is foo. + +This is bar. + +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. + +{/textformat} + +SORTIE: + + This is foo. This is foo. This + is foo. This is foo. This is foo. + This is foo. + + This is bar. + + bar foo bar foo foo. bar foo bar + foo foo. bar foo bar foo foo. bar + foo bar foo foo. bar foo bar foo + foo. bar foo bar foo foo. bar foo + bar foo foo. + +{textformat style="email"} + +This is foo. +This is foo. +This is foo. +This is foo. +This is foo. +This is foo. + +This is bar. + +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. +bar foo bar foo foo. + +{/textformat} + +SORTIE: + +This is foo. This is foo. This is foo. This is foo. This is foo. This is +foo. + +This is bar. + +bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo +bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo +foo. + + + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-capitalize.xml b/docs/fr/designers/language-modifiers/language-modifier-capitalize.xml new file mode 100644 index 00000000..555b8829 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-capitalize.xml @@ -0,0 +1,47 @@ + + + + capitalize + + Met la première lettre de chaque mot d'une variable en majuscule. + + + capitalize + +index.php: + +$smarty = new Smarty; +$smarty->assign('titreArticle', 'La police commence une campagne de sensibilisation contre la violence routière.'); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|capitalize} + +SORTIE: + +La police commence une campagne de sensibilisation contre la violence routière. +La Police Commence Une Campagne De Sensibilisation Contre La Violence Routière. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-cat.xml b/docs/fr/designers/language-modifiers/language-modifier-cat.xml new file mode 100644 index 00000000..36e31a12 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-cat.xml @@ -0,0 +1,72 @@ + + + + cat + + + + + + + + + + Position du paramètre + Type + Requis + cat + Description + + + + + 1 + chaîne de caractères + Non + empty + Valeur à concaténer à la variable donnée. + + + + + + Cette valeur est concaténée à la variable donnée. + + +cat + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', 'Les devins ont prévus que le monde existera toujours '); +$smarty->display('index.tpl'); + +index.tpl: + +{$TitreArticle|cat:" demain."} + +SORTIE: + +Les devins ont prévus que le monde existera toujours demain. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-count-characters.xml b/docs/fr/designers/language-modifiers/language-modifier-count-characters.xml new file mode 100644 index 00000000..98a7deee --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-count-characters.xml @@ -0,0 +1,48 @@ + + + + count_characters + + Compte le nombre de caractères dans une variable. + + +count_characters + +index.php: + +$smarty = new Smarty; +$smarty->assign('titreArticle', 'Vagues de froid liées à la température.'); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|count_characters} + +SORTIE: + +Vagues de froid liées à la température. +39 + + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-count-paragraphs.xml b/docs/fr/designers/language-modifiers/language-modifier-count-paragraphs.xml new file mode 100644 index 00000000..e86e4b59 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-count-paragraphs.xml @@ -0,0 +1,47 @@ + + + + count_paragraphs + + Compte le nombre de paragraphes dans une variable. + + +count_paragraphs + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', 'La guerre apporte la paix, au prix de la vie de certains innocents.'); +$smarty->display('index.tpl'); + +index.tpl: + +{$TitreArticle} +{$TitreArticle|count_paragraphs} + +SORTIE: + +La guerre apporte la paix, au prix de la vie des innocents. +1 + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-count-sentences.xml b/docs/fr/designers/language-modifiers/language-modifier-count-sentences.xml new file mode 100644 index 00000000..e9d02e69 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-count-sentences.xml @@ -0,0 +1,51 @@ + + + + count_sentences + + Compte le nombre de phrases dans une variable. + + +count_sentences + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', 'Deux navires rentrent en +collision - Un des deux coule. Des vaches enragées blessent un fermier à +coups de haches.'); +$smarty->display('index.tpl'); + +index.tpl: + +{$TitreArticle} +{$TitreArticle|count_sentences} + +SORTIE: +Deux navires rentrent en collision +- Un des deux coule. Des vaches enragées blessent un fermier +à coups de haches. + +2 + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-count-words.xml b/docs/fr/designers/language-modifiers/language-modifier-count-words.xml new file mode 100644 index 00000000..ab697450 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-count-words.xml @@ -0,0 +1,47 @@ + + + + count_words + + Compte le nombre de mots dans une variable. + + +count_words + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', 'Un anneau pour les gouverner tous.'); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|count_words} + +SORTIE: + +Un anneau pour les gouverner tous. +6 + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-date-format.xml b/docs/fr/designers/language-modifiers/language-modifier-date-format.xml new file mode 100644 index 00000000..9f6a7fb4 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-date-format.xml @@ -0,0 +1,187 @@ + + + + date_format + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractères + Non + %b %e, %Y + Format de sortie de la date. + + + 2 + chaîne de caractères + Non + n/a + Date par défaut si aucune n'est spécifiée en entrée. + + + + + + Formate une date / heure au format strftime donné. Les dates peuvent + être passées à smarty en tant que timestamp unix, timestamp mysql ou + comme chaîne quelconque contenant mois jour année (interprétable par + strtotime). Les concepteurs de templates peuvent utiliser date_format + pour contrôler parfaitement le format de sortie de la date. + Si la date passée à date_format est vide, et qu'un second paramètre + est donné, ce dernier sera utilisé comme étant la date à formater. + + +date_format + +index.php: + +$smarty = new Smarty; +$smarty->assign('hier', strtotime('-1 day')); +$smarty->display('index.tpl'); + +index.tpl: + + +{$smarty.now|date_format} +{$smarty.now|date_format:"%A, %B %e, %Y"} +{$smarty.now|date_format:"%H:%M:%S"} +{$hier|date_format} +{$hier|date_format:"%A, %B %e, %Y"} +{$hier|date_format:"%H:%M:%S"} + +SORTIE: + +Feb 6, 2001 +Tuesday, February 6, 2001 +14:33:00 +Feb 5, 2001 +Monday, February 5, 2001 +14:33:00 + + +date_format indicateurs de convertion + +%a - Abréviation du jour de la semaine, selon les paramètres locaux. + +%A - Nom du jour de la semaine, selon les paramètres locaux. + +%b - Abréviation du nom du jour, selon les paramètres locaux. + +%B - Nom complet du mois, selon les paramètres locaux. + +%c - Préférences d'affichage selon les paramètres locaux. + +%C - Siècle, (L'année divisée par 100 et tronquée comme un entier, de 00 à 99) + +%d - Jour du mois, en tant que nombre décimal (de 00 à 31) + +%D - même chose que %m/%d/%y + +%e - Jour du mois en tant que nombre décimal. Un chiffre unique est précédé par +un espace (de 1 à 31) + +%g - Position de la semaine dans le siècle [00,99] + +%G - Position de la semaine, incluant le siècle [0000,9999] + +%h - identique à %b + +%H - L'heure en tant que décimale, en utilisant une horloge sur 24 (de 00 à 23) + +%I - L'heure en tant que décimale en utilisant une horloge sur 12 (de 01 to 12) + +%j - jour de l'année (de 001 à 366) + +%k - Heure (horloge sur 24). Les numéros à un chiffre sont précédés d'un espace. (de 0 à 23) + +%l - Heure (horloge sur 12). Les numéros à un chiffre sont précédés d'un espace. (de 1 à 12) + +%m - Mois en tant que nombre décimal (de 01 à 12) + +%M - Minute en tant que nombre décimal + +%n - Retour chariot (nouvelle ligne). + +%p - soit am soit pm selon l'heure donnée, ou alors leurs correspondances locales. + +%r - heure en notation a.m. et p.m. + +%R - Heure au format 24 heures + +%S - Secondes en tant que nombre décimal. + +%t - Caractère tabulation. + +%T - Heure courante, équivalent à %H:%M:%S + +%u - Jour de la semaine en tant que nombre décimal [1,7], ou 1 représente le lundi. + +%U - Le numéro de la semaine en nombre décimal, utilisant le premier dimanche +en tant que premier jour de la première semaine. + +%V - Le numéro de la semaine de l'année courante selon la norme ISO 8601:1988, + de 01 à 53, ou la semaine 1 est la première semaine qui dispose au minimum + de 4 jours dans l'année courante et ou Lundi est le premier jour + de cette semaine. + +%w - Jour de la semaine en tant que nombre décimal, dimanche étant 0 + +%W - Le numéro de la semaine de l'année courante en tant que nombre décimal, + ou Lundi est le premier jour de la première semaine. + +%x - Représentation préférée de la date selon les paramètres locaux. + +%X - Représentation préférée de l'heure selon les paramètres locaux, sans la + date. + +%y - L'année en tant que nombre décimal, sans le siècle. (de 00 à 99) + +%Y - L'année en tant que nombre décimal, avec le siècle. + +%Z - Zone horraire, nom ou abréviation + +%% - Un caractère litéral `%' + +NOTE AUX DEVELOPPEURS: date_format est un alias de la fonction +PHP strftime(). Il est probable que vous disposiez de plus ou moins d'options +disponibles selon le système sur lequel PHP a été compilé (strftime ()). +Reportez vous à l'aide de votre système pour une liste complète des +paramètres disponibles. + + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-default.xml b/docs/fr/designers/language-modifiers/language-modifier-default.xml new file mode 100644 index 00000000..ce871144 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-default.xml @@ -0,0 +1,77 @@ + + + + default + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractères + Non + empty + La valeur par défaut de la sortie si la variable + d'entrée est vide. + + + + + + Utilisé pour définir une valeur par défaut à une variable. + Si la variable est vide ou indéfinie, la valeur donnée est affichée + en lieu et place. Default attends un seul argument. + + +default + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', 'Les portes de la moria restent fermées.'); +$smarty->display('index.tpl'); + +index.tpl: + +{$TitreArticle|default:"pas de titre"} +{$monTitre|default:"pas de titre"} + +SORTIE: + +Les portes de la moria restent fermées. +pas de titre + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-escape.xml b/docs/fr/designers/language-modifiers/language-modifier-escape.xml new file mode 100644 index 00000000..77d1d44d --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-escape.xml @@ -0,0 +1,91 @@ + + + + escape + + + + + + + + + + + Position du paramètre + Type + Requis + Valeurs possibles + Defaut + Description + + + + + 1 + chaîne de caractère + Non + html, htmlall, url, quotes, hex, hexentity, + javascript + html + Format d'échappement à utiliser. + + + + + + "Echappe" les caractères spéciaux html, d'url, pour + les quotes d'une chaîne, les valeurs + hexadécimales, les entités hexadécimales ou javascript. + Par défaut, ce paramètre est html. + + +escape + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', "'Stiff Opposition Expected to Casketless Funeral Plan'"); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|escape} +{$titreArticle|escape:"html"} {* escapes & " ' < > *} +{$titreArticle|escape:"htmlall"} {* escapes ALL html entities *} +{$titreArticle|escape:"url"} +{$titreArticle|escape:"quotes"} +<a href="mailto:{$EmailAddress|escape:"hex"}">{$EmailAddress|escape:"hexentity"}</a> + +SORTIE: + +'Stiff Opposition Expected to Casketless Funeral Plan' +&#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; +&#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; +&#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; +%27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27 +\'Stiff Opposition Expected to Casketless Funeral Plan\' +<a href="mailto:%62%6f%62%40%6d%65%2e%6e%65%74">&#x62;&#x6f;&#x62;&#x40;&#x6d;&#x65;&#x2e;&#x6e;&#x65;&#x74;</a> + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-indent.xml b/docs/fr/designers/language-modifiers/language-modifier-indent.xml new file mode 100644 index 00000000..894c7b95 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-indent.xml @@ -0,0 +1,96 @@ + + + + indent + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + entier + Non + 4 + De combien de caractères l'indentation doit être effectuée. + + + 2 + chaîne de caractère + Non + (espace) + Caractère à utiliser pour l'indentation. + + + + + + Indente chacune des lignes d'une chaîne. Comme paramètre optionnel, + vous pouvez spécifier le nombre de caractères à utiliser pour l'indentation (4 par défaut). + Comme second paramètre optionnel, vous + pouvez spécifier le caractère à utiliser pour l'indentation (utilisez + "\t" pour les tabulations). + + +indent + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', 'Il fera noir cette nuit.'); +$smarty->display('index.tpl'); + +index.tpl: + +{$TitreArticle} + +{$TitreArticle|indent} + +{$TitreArticle|indent:10} + +{$TitreArticle|indent:1:"\t"} + +SORTIE: + +Il fera noir cette nuit. + + Il fera noir cette nuit. + + Il fera noir cette nuit. + + Il fera noir cette nuit. + + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-lower.xml b/docs/fr/designers/language-modifiers/language-modifier-lower.xml new file mode 100644 index 00000000..111e3509 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-lower.xml @@ -0,0 +1,47 @@ + + + + lower + + Met une variable en minuscules. + + +lower + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', 'Deux Suspects Se Sont Sauvés.'); +$smarty->display('index.tpl'); + +index.tpl: + +{$TitreArticle} +{$TitreArticle|lower} + +SORTIE: + +Deux Suspects Se Sont Sauvés. +deux suspects se sont sauvés. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml b/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml new file mode 100644 index 00000000..2d43bfaa --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml @@ -0,0 +1,46 @@ + + + + nl2br + + Transforme toutes les fins de lignes en balises <br />. + Equivalent à la fonction PHP nl2br(). + + +nl2br + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', "Pluie ou soleil attendu\naujourd'hui, nuit noire"); +$smarty->display('index.tpl'); + +index.tpl: + +{$TitreArticle|nl2br} + +SORTIE: + +Pluie ou soleil attendu<br />aujourd'hui, nuit noire + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-regex-replace.xml b/docs/fr/designers/language-modifiers/language-modifier-regex-replace.xml new file mode 100644 index 00000000..7ddd2fdc --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-regex-replace.xml @@ -0,0 +1,85 @@ + + + + regex_replace + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractère + Oui + n/a + Expression régulière à remplacer. + + + 2 + chaîne de caractère + Oui + n/a + La chaîne de remplacement. + + + + + + Un rechercher / remplacer avec une expression régulière. Utilise la même + syntaxe que la fonction PHP preg_replace. + + +regex_replace + +index.php: + +$smarty = new Smarty; +$smarty->assign('TitreArticle', "L'infertilité est un maux grandissant\n, disent les experts."); +$smarty->display('index.tpl'); + +index.tpl: + +{* Remplace tous les retours chariot et les tabulation par une nouvelle ligne avec un espace *} + +{$TitreArticle} +{$TitreArticle|regex_replace:"/[\r\t\n]/":" "} + +SORTIE: + +L'infertilité est un maux grandissant +, disent les experts. +L'infertilité est un maux grandissant, disent les experts. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-replace.xml b/docs/fr/designers/language-modifiers/language-modifier-replace.xml new file mode 100644 index 00000000..930d29e4 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-replace.xml @@ -0,0 +1,83 @@ + + + + replace + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractères + Oui + n/a + chaîne à remplacer. + + + 2 + chaîne de caractères + Oui + n/a + chaîne de remplacement. + + + + + + Un simple remplacement de chaîne de caractères. + + +replace + +index.php: + +$smarty = new Smarty; +$smarty->assign('titreArticle', "Child's Stool Great for Use in Garden."); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|replace:"Garden":"Vineyard"} +{$titreArticle|replace:" ":" "} + +SORTIE: + +Child's Stool Great for Use in Garden. +Child's Stool Great for Use in Vineyard. +Child's Stool Great for Use in Garden. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-spacify.xml b/docs/fr/designers/language-modifiers/language-modifier-spacify.xml new file mode 100644 index 00000000..a269a6f4 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-spacify.xml @@ -0,0 +1,79 @@ + + + + spacify + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractère + Non + espace + Ce qui est inséré entre chaque caractère de la variable. + + + + + + spacify est un moyen pour insérer un espace entre tous les caractères + d'une variable. Optionnellement, vous pouvez lui passer un caractère + (ou une chaîne) différent de espace à insérer. + + +spacify + +index.php: + +$smarty = new Smarty; +$smarty->assign('titreArticle', 'Quelque chose s'est mal passé et à provoqué +cet accident, disent les experts'); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|spacify} +{$titreArticle|spacify:"^^"} + +SORTIE: + +Quelquechose s'est mal passé et à provoqué cet accident, disent les experts. +Q u e l q u e c h o s e s ' e s t m a l p a s s é e t à p r o v o q u é c e t a c c i d e n t , d i s e n t l e s e x p e r t s . +Q^^u^^e^^l^^q^^u^^e^^c^^h^^o^^s^^e^^ ^^s^^'^^e^^s^^t^^ ^^m^^a^^l^^ ^^p^^a^^s^^s^^é^^ ^^e^^t^^ ^^à^^ ^^p^^r^^o^^v^^o^^q^^u^^é^^ ^^c^^e^^t^^ ^^a^^c^^c^^i^^d^^e^^n^^t^^,^^ ^^d^^i^^s^^e^^n^^t^^ ^^l^^e^^s^^ ^^e^^x^^p^^e^^r^^t^^s^^. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-string-format.xml b/docs/fr/designers/language-modifiers/language-modifier-string-format.xml new file mode 100644 index 00000000..2e090440 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-string-format.xml @@ -0,0 +1,77 @@ + + + + string_format + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractères + Oui + n/a + Le format à utiliser (sprintf) + + + + + + Un moyen pour formater les chaînes de caractères, comme par exemple les + nombres décimaux. Utilise la syntaxe de sprintf pour formater les éléments. + + +string_format + +index.php: + +$smarty = new Smarty; +$smarty->assign('nombre', 23.5787446); +$smarty->display('index.tpl'); + +index.tpl: + +{$nombre} +{$nombre|string_format:"%.2f"} +{$nombre|string_format:"%d"} + +SORTIE: + +23.5787446 +23.58 +24 + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-strip-tags.xml b/docs/fr/designers/language-modifiers/language-modifier-strip-tags.xml new file mode 100644 index 00000000..68b84f0a --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-strip-tags.xml @@ -0,0 +1,51 @@ + + + + strip_tags + + Supprime toutes les balises, et plus généralement tout ce qui se trouve + entre < et >. + + +strip_tags + +index.php: + +$smarty = new Smarty; +$smarty->assign('titreArticle', "Une femme aveugle obtient un nouveau <font face=\"helvetica\"> +rein</font> d'un père qu'elle n'a pas vu depuis<b> des années</b>."); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|strip_tags} + +SORTIE: + +Une femme aveugle obtient un nouveau <font face=\"helvetica\"> +rein</font> d'un père qu'elle n'a pas vu depuis<b> des années</b>. +Une femme aveugle obtient un nouveau rein d'un père +qu'elle n'a pas vu depuis des années. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-strip.xml b/docs/fr/designers/language-modifiers/language-modifier-strip.xml new file mode 100644 index 00000000..5cce237e --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-strip.xml @@ -0,0 +1,61 @@ + + + + strip + + Remplace les espaces multiples, les nouvelles lignes et les tabulations + par un espace simple, ou une chaîne donnée. + + + Note + + Si vous voulez réaliser cette action sur un bloc complet du template, + utilisez la fonction strip. + + + +strip + +index.php: + +$smarty = new Smarty; +$smarty->assign('titreArticle', "Une réunion autour\n d'un feu de cheminée\t +est toujours agréable."); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|strip} +{$titreArticle|strip:"&nbsp;"} + +SORTIE: + +Une réunion autour + d'un feu de cheminée est toujours agréable. +Une réunion autour d'un feu de cheminée est toujours agréable. +Une&nbsp;réunion&nbsp;autour&nbsp;d'un&nbsp;feu&nbsp;de&nbsp;cheminée&nbsp;est&nbsp;toujours +&nbsp;agréable. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-truncate.xml b/docs/fr/designers/language-modifiers/language-modifier-truncate.xml new file mode 100644 index 00000000..ae7058b3 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-truncate.xml @@ -0,0 +1,108 @@ + + + + truncate + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + entier + Non + 80 + Le nombre de caractères maximums au-delà duquel + on effectue le troncage + + + 2 + chaîne de caractère + Non + ... + Le texte à rajouter lorsque l'on effectue un + troncage. + + + 3 + booléen + Non + false + Détermine si le troncage est effectué sur + le dernier mot (false), ou au caractère exact (true). + + + + + + + Tronque une variable à une certaine longueur, par défaut 80. + Un second paramètre optionnel permet de spécifier une chaîne à afficher + à la fin de la variable une fois tronquée. Les caractères de fin sont + inclus dans la longueur de la chaîne à tronquer. Par défaut, + truncate tentera de couper la chaîne à la fin d'un mot. Si vous voulez + tronquer la chaîne au caractère exact, donnez la valeur true au + dernier paramètre optionnel. + + +truncate + +index.php: + +$smarty = new Smarty; +$smarty->assign('titreArticle', 'Deux soeurs réunies après 18 ans de séparation.'); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|truncate} +{$titreArticle|truncate:30} +{$titreArticle|truncate:30:""} +{$titreArticle|truncate:30:"---"} +{$titreArticle|truncate:30:"":true} +{$titreArticle|truncate:30:"...":true} + +SORTIE: + +Deux soeurs réunies après 18 ans de séparation. +Deux soeurs réunies après... +Deux soeurs réunies après +Deux soeurs réunies après--- +Deux soeurs réunies après 18 a +Deux soeurs réunies après 1... + + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-upper.xml b/docs/fr/designers/language-modifiers/language-modifier-upper.xml new file mode 100644 index 00000000..5b3374d2 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-upper.xml @@ -0,0 +1,48 @@ + + + + upper + + Met une variable en majuscules. + + +upper + +index.php: + +$smarty = new Smarty; +$smarty->assign('titreArticle', "Si l'attaque n'est pas mise en place +rapidement, cela risque de durer longtemps."); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} +{$titreArticle|upper} + +SORTIE: + +Si l'attaque n'est pas mise en place rapidement, cela risque de durer longtemps. +SI L'ATTAQUE N'EST PAS MISE EN PLACE RAPIDEMENT, CELA RISQUE DE DURER LONGTEMPS. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers/language-modifier-wordwrap.xml b/docs/fr/designers/language-modifiers/language-modifier-wordwrap.xml new file mode 100644 index 00000000..f35afd95 --- /dev/null +++ b/docs/fr/designers/language-modifiers/language-modifier-wordwrap.xml @@ -0,0 +1,122 @@ + + + + wordwrap + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + entier + Non + 80 + La nombre de colonnes sur lequel ajuster l'affichage. + + + 2 + chaîne de caractères + Non + \n + chaîne de caractères utilisée pour l'ajustement. + + + 3 + booléen + Non + false + Détermine si l'ajustement se fait en fin de mot + (false) ou au caractère exact (true). + + + + + + Ajuste une chaîne de caractères à une taille de colonne, par défaut 80. + Un second paramètre optionnel vous permet de spécifier la chaîne à utiliser + pour l'ajustement à la nouvelle ligne (retour chariot \n par défaut). + Par défaut, wordwrap tente un ajustement à la fin d'un mot. Si vous voulez + autoriser le découpage des mots pour un ajustement au caractère près, + passez true au troisième paramètre optionnel. + + +wordwrap + +index.php: + +$smarty = new Smarty; +$smarty->assign('titreArticle', "Une femme aveugle obtient un nouveau rein +d'un père qu'elle n'a pas vu depuis des années."); +$smarty->display('index.tpl'); + +index.tpl: + +{$titreArticle} + +{$titreArticle|wordwrap:30} + +{$titreArticle|wordwrap:20} + +{$titreArticle|wordwrap:30:"<br>\n"} + +{$titreArticle|wordwrap:30:"\n":true} + +SORTIE: + +Une femme aveugle obtient un nouveau rein d'un père qu'elle n'a pas vu depuis des années. + +Une femme aveugle obtient un +nouveau rein d'un père +qu'elle n'a pas vu depuis +des années. + +Une femme aveugle +obtient un nouveau +rein d'un père +qu'elle n'a pas vu +depuis des années. + +Une femme aveugle obtient un<br> +nouveau rein d'un père<br> +qu'elle n'a pas vu depuis<br> +des années. + +Une femme aveugle obtient un n +ouveau rein d'un père qu'elle +n'a pas vu depuis des années. + + + + \ No newline at end of file diff --git a/docs/fr/designers/language-variables/language-assigned-variables.xml b/docs/fr/designers/language-variables/language-assigned-variables.xml new file mode 100644 index 00000000..f40f969b --- /dev/null +++ b/docs/fr/designers/language-variables/language-assigned-variables.xml @@ -0,0 +1,135 @@ + + + + Variables assignées depuis PHP + + Pour utiliser une variables assignées depuis PHP, il faut la préfixer par le + symbole dollar $. Les variables asignées depuis un + template grâce à la fonction assign + sont manipulées de la même façon. + + + + Variables assignées + +Bienvenue {$prenom}, heureux de voir que tu es arrivé ici. +<p> +La dernière connexion remonte au {$dateConnexionPrecedente}. + +SORTIE: + +Bienvenue Doug, heureux de voir que tu est arrivé ici. +<p> +La dernière connexion remonte au 11 janvier 2001. + + + + Tableaux associatifs + + Vous pouvez également utiliser des variables sous forme de tableaux + associatifs assignées depuis PHP en en spécifiant la clef, + après le symbole '.' (point). + + +accéder aux variables de tableaux associatifs + +index.php: + +$smarty = new Smarty; +$smarty->assign('Contacts', + array('fax' => '555-222-9876', + 'email' => 'zaphod@slartibartfast.com', + 'phone' => array('home' => '555-444-3333', + 'cell' => '555-111-1234'))); +$smarty->display('index.tpl'); + +index.tpl: + +{$Contacts.fax}<br> +{$Contacts.email}<br> +{* you can print arrays of arrays as well *} +{$Contacts.phone.home}<br> +{$Contacts.phone.cell}<br> + +SORTIE: + +555-222-9876<br> +zaphod@slartibartfast.com<br> +555-444-3333<br> +555-111-1234<br> + + + + Tableaux indexés + + Vous pouvez utiliser des tableaux indexés de la même façon que vous le + faites en PHP. + + +Accès aux tableaux grâce à l'index + +index.php: + +$smarty = new Smarty; +$smarty->assign('Contacts', + array('555-222-9876', + 'zaphod@slartibartfast.com', + array('555-444-3333', + '555-111-1234'))); +$smarty->display('index.tpl'); + +index.tpl: + +{$Contacts[0]}<br> +{$Contacts[1]}<br> +{* you can print arrays of arrays as well *} +{$Contacts[2][0]}<br> +{$Contacts[2][1]}<br> + +SORTIE: + +555-222-9876<br> +zaphod@slartibartfast.com<br> +555-444-3333<br> +555-111-1234<br> + + + + Objets + + Les attributs des objets assignés depuis PHP peuvent être utilisées en + en spécifiant le nom après le symbole '->'. + + +accéder aux attributs des objets + +nom: {$person->name}<br> +email: {$person->email}<br> + +SORTIE: + +nom: Zaphod Beeblebrox<br> +email: zaphod@slartibartfast.com<br> + + + + \ No newline at end of file diff --git a/docs/fr/designers/language-variables/language-config-variables.xml b/docs/fr/designers/language-variables/language-config-variables.xml new file mode 100644 index 00000000..677c860a --- /dev/null +++ b/docs/fr/designers/language-variables/language-config-variables.xml @@ -0,0 +1,96 @@ + + + + Variables chargées depuis des fichiers de configuration + + Les variables récupérées depuis un fichier de configuration sont utilisées + entourées du symbole dièse (#), ou via la variable spéciale smarty + $smarty.config. + + + +variables de fichiers de configuration + +foo.conf: + +pageTitle = "C'est le mien" +bodyBgColor = "#eeeeee" +tableBorderSize = "3" +tableBgColor = "#bbbbbb" +rowBgColor = "#cccccc" + +index.tpl: + +{config_load file="foo.conf"} +<html> +<title>{#pageTitle#}</title> +<body bgcolor="{#bodyBgColor#}"> +<table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> +<tr bgcolor="{#rowBgColor#}"> + <td>First</td> + <td>Last</td> + <td>Address</td> +</tr> +</table> +</body> +</html> + +index.tpl: (alternate syntax) + +{config_load file="foo.conf"} +<html> +<title>{$smarty.config.pageTitle}</title> +<body bgcolor="{$smarty.config.bodyBgColor}"> +<table border="{$smarty.config.tableBorderSize}" bgcolor="{$smarty.config.tableBgColor}"> +<tr bgcolor="{$smarty.config.rowBgColor}"> + <td>First</td> + <td>Last</td> + <td>Address</td> +</tr> +</table> +</body> +</html> + + +SORTIE: (same for both examples) + +<html> +<title>C'est le mien</title> +<body bgcolor="#eeeeee"> +<table border="3" bgcolor="#bbbbbb"> +<tr bgcolor="#cccccc"> + <td>First</td> + <td>Last</td> + <td>Address</td> +</tr> +</table> +</body> +</html> + + + Les variables de fichier de configuration ne peuvent être utilisés tant + qu'elles n'ont pas été chargées. Cette procédure est expliquée + plus loin dans le document, voir config_load. + + + \ No newline at end of file diff --git a/docs/fr/designers/language-variables/language-variables-smarty.xml b/docs/fr/designers/language-variables/language-variables-smarty.xml new file mode 100644 index 00000000..51cd6156 --- /dev/null +++ b/docs/fr/designers/language-variables/language-variables-smarty.xml @@ -0,0 +1,130 @@ + + + + Variable réservée {$smarty} + + La variable réservée {$smarty} peut être utilisée pour accéder à plusieurs + variables spéciales du template. En voici la liste complète. + + + + Variables de requête + + Les variables de requête comme GET, POST, COOKIES, SERVER, ENVIRONNEMENT + et SESSION peuvent être utilisées comme dans l'exemple suivant: + + + + Afficher des variables de requête + +{* Affiche la valeur de page dans l'url (GET) http://www.domain.com/index.php?page=foo *} +{$smarty.get.page} + +{* affiche la variable "page" récupérée depuis un formulaire (POST) *} +{$smarty.post.page} + +{* affiche la valeur du cookie "utilisateur" *} +{$smarty.cookies.utilisateur} + +{* affiche la variable serveur "SERVER_NAME" *} +{$smarty.server.SERVER_NAME} + +{* affiche la variable d'environnement "PATH" *} +{$smarty.env.PATH} + +{* affiche la variable de session PHP "id" *} +{$smarty.session.id} + +{* affiche la variable "utilisateur" du regroupement de get/post/cookies/server/env *} +{$smarty.request.utilisateur} + + + + + {$smarty.now} + + Le timestamp courant peut être récupéré grâce à {$smarty.now}. + Le nombre obtenu correspond au nombre de secondes écoulées depuis + Epoch (1 Janvier 1970) et peut être passé directement au modificateur + de variable date à des fins d'affichage. + + + +utilisation de {$smarty.now} + +{* utilise le modificateur de variable date_format pour afficher la date et heure *} +{$smarty.now|date_format:"%d-%m-%Y %H:%M:%S"} + + + + {$smarty.const} + + Vous pouvez directement accéder aux constantes PHP. + + + +Utiliser {$smarty.const} + +{$smarty.const._MA_CONSTANTE_} + + + + + {$smarty.capture} + + La capture réalisée via {capture}..{/capture} peut être récupérée + par l'intermédiaire de la variable {$smarty}. Voir la section + sur capture pour un + exemple à ce sujet. + + + + + {$smarty.config} + + La variable {$smarty} peut être utilisée pour désigner une variable + d'un fichier de configuration. {$smarty.config.foo} est un synonyme de + {#foo#}. Voir la section config_load + pour un exemple à ce sujet. + + + + + {$smarty.section}, {$smarty.foreach} + + La variable {$smarty} peut être utilisée pour accéder aux propriétés + des boucles 'section' et 'foreach'. Voir la documentation de + section et + foreach. + + + + + {$smarty.template} + + Cette variable contient le nom du template en cours de traitement. + + + + + \ No newline at end of file