cvs: smarty /docs/fr/appendixes tips.xml /docs/fr/designers language-builtin-functions.xml language-modifiers.xml /docs/fr/designers/language-basic-syntax language-syntax-comments.xml language-syntax-functions.xml language-syntax-variables.xml /docs/fr/designers/language-builtin-functions language-function-capture.xml language-function-insert.xml language-function-php.xml /docs/fr/designers/language-custom-functions language-function-assign.xml language-function-eval.xml /docs/fr/designers/language-modifiers language-modifier-default.xml language-modifier-escape.xml language-modifier-nl2br.xml language-modifier-truncate.xml /docs/fr/designers/language-variables language-variables-smarty.xml
[email protected] ("Yannick Torres") Sun, 09 Apr 2006 21:59:55 -0000
| Newsgroups | php.smarty.cvs |
|---|---|
| Message-ID | <cvsyannick1144619995@cvsserver> |
yannick Sun Apr 9 21:59:55 2006 UTC
Modified files:
/smarty/docs/fr/appendixes tips.xml
/smarty/docs/fr/designers/language-basic-syntax
language-syntax-comments.xml
language-syntax-functions.xml
language-syntax-variables.xml
/smarty/docs/fr/designers/language-builtin-functions
language-function-capture.xml
language-function-insert.xml
language-function-php.xml
/smarty/docs/fr/designers language-builtin-functions.xml
language-modifiers.xml
/smarty/docs/fr/designers/language-custom-functions
language-function-assign.xml
language-function-eval.xml
/smarty/docs/fr/designers/language-modifiers
language-modifier-default.xml
language-modifier-escape.xml
language-modifier-nl2br.xml
language-modifier-truncate.xml
/smarty/docs/fr/designers/language-variables
language-variables-smarty.xml
Log:
sync with EN
yannick-20060409215955.txt
(text/plain, 39.3 KB)
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/appendixes/tips.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/appendixes/tips.xml
diff -u smarty/docs/fr/appendixes/tips.xml:1.10 smarty/docs/fr/appendixes/tips.xml:1.11
--- smarty/docs/fr/appendixes/tips.xml:1.10 Sat Feb 18 17:54:23 2006
+++ smarty/docs/fr/appendixes/tips.xml Sun Apr 9 21:59:55 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.10 Maintainer: didou Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.11 Maintainer: didou Status: ready -->
<chapter id="tips">
<title>Trucs et astuces</title>
@@ -111,7 +111,7 @@
</programlisting>
<para>
- <filename>header.tpl</filename> - Notez que "BC News" est affiché si la variable
+ <filename>header.tpl</filename> - Notez que "Smarty News" est affiché si la variable
$title n'est pas définie, en utilisant le modificateur de variable par
<link linkend="language.modifier.default">défaut</link>.
</para>
@@ -119,7 +119,7 @@
<![CDATA[
<html>
<head>
- <title>{$title|default:'BC News'}</title>
+ <title>{$title|default:'Smarty News'}</title>
</head>
<body>
]]>
@@ -359,7 +359,7 @@
</para>
<programlisting>
<![CDATA[
-{load_ticker symbol="YHOO" assign="ticker"}
+{load_ticker symbol='SMARTY' assign="ticker"}
Stock Name: {$ticker.name} Stock Price: {$ticker.price}
]]>
@@ -387,10 +387,9 @@
<title>Exemple de dissimulation d'une adresse email</title>
<programlisting>
<![CDATA[
-{* in index.tpl *}
-
-Send inquiries to
-{mailto address=$EmailAddress encode="javascript" subject="Hello"}
+{* dans le template *}
+<div id="contact">Envoyer une demande à
+{mailto address=$EmailAddress encode='javascript' subject='Bonjour'}
]]>
</programlisting>
</example>
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml?r1=1.8&r2=1.9&diff_format=u
Index: smarty/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml
diff -u smarty/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml:1.8 smarty/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml:1.9
--- smarty/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml:1.8 Wed Mar 22 17:30:04 2006
+++ smarty/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml Sun Apr 9 21:59:55 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready -->
<sect1 id="language.syntax.comments">
<title>Commentaires</title>
@@ -10,15 +10,18 @@
de cette façon : <emphasis>{* voici un commentaire *}</emphasis>
Les commentaires Smarty ne sont PAS affichés dans la sortie finale du
template, différemment des <!-- commentaires HTML -->
- et sont utilisés pour des notes internes, dans le template, pour aider
- les développeurs à en comprendre le fonctionnement.
+ et sont utilisés pour des notes internes, dans le template que personne ne verra ;)
</para>
<example>
- <title>Commentaires</title>
+ <title>Commentaires dans un template</title>
<programlisting>
<![CDATA[
-<body>
{* Je suis un commentaire Smarty, je n'existe pas dans la sortie compilée *}
+<html>
+ <head>
+ <title>{$title}</title>
+ </head>
+ <body>
{* un autre commentaire Smarty sur une seule ligne *}
<!-- Un commentaire Html qui sera envoyé au navigateur -->
@@ -35,7 +38,7 @@
@ css: the style output
**********************************************************}
-{* Inclusion du fichier d'en tête *}
+{* Inclusion du fichier d'en-tête contenant le logo principal *}
{include file='header.tpl'}
{* Note aux développeurs : $includeFile est assigné au script foo.php *}
@@ -48,10 +51,13 @@
{html_options options=$vals selected=$selected_id}
</select>
*}
-{* Balise cvs pour un template *}
-{* $Id: Exp $ *}
+{* Balise cvs pour un template, ci-dessous, le 36 DOIT ÊTRE une devise américaine sinon,
+il sera converti en cvs.. *}
+{* $Id: Exp $ *}
+{* $Id: *}
</body>
+</html>
]]>
</programlisting>
</example>
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml?r1=1.9&r2=1.10&diff_format=u
Index: smarty/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml
diff -u smarty/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml:1.9 smarty/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml:1.10
--- smarty/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml:1.9 Wed Mar 22 17:30:04 2006
+++ smarty/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml Sun Apr 9 21:59:55 2006
@@ -1,11 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready -->
+
<sect1 id="language.syntax.functions">
<title>Fonctions</title>
<para>
Les balises Smarty affichent une <link linkend="language.variables">variable</link>
- ou invoquent une fonction. Les fonctions sont appelées
+ ou invoquent une fonction. Elles sont appelées
lorsqu'elles sont entourées, ainsi que leurs
<link linkend="language.syntax.attributes">paramètres</link>, des délimiteurs Smarty.
Par exemple : {nomfonction attr1='val' attr2='val'}.
@@ -16,15 +17,15 @@
<![CDATA[
{config_load file='colors.conf'}
{include file='header.tpl'}
-{insert file='banner_ads.tpl'}
+{insert file='banner_ads.tpl' title='Smarty est cool !'}
-{if $highlight_name}
+{if $logged_in}
Bonjour, <font color="{#fontColor#}">{$name}!</font>
{else}
Bonjour, {$name}!
{/if}
-{include file='footer.tpl'}
+{include file='footer.tpl' ad=$random_id}
]]>
</programlisting>
</example>
@@ -39,7 +40,7 @@
comme <link linkend="language.function.if">{if}</link>,
<link linkend="language.function.section">{section}</link> et
<link linkend="language.function.strip">{strip}</link>.
- Elles ne devraient pas être modifiées.
+ Il n'y a aucune raison à ce qu'elles soient modifiées ou changées.
</para>
<para>
Les fonctions utilisateurs sont des fonctions <emphasis role="bold">additionnelles</emphasis>,
@@ -50,6 +51,11 @@
<link linkend="language.function.popup">{popup}</link>
sont deux exemples de fonctions utilisateurs.
</para>
+
+ <para>
+ Voir aussi
+ <link linkend="api.register.function">register_function()</link>.
+ </para>
</sect1>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml?r1=1.5&r2=1.6&diff_format=u
Index: smarty/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml
diff -u smarty/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml:1.5 smarty/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml:1.6
--- smarty/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml:1.5 Wed Mar 22 17:30:04 2006
+++ smarty/docs/fr/designers/language-basic-syntax/language-syntax-variables.xml Sun Apr 9 21:59:55 2006
@@ -1,17 +1,21 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready -->
+
<sect1 id="language.syntax.variables">
<title>Variables</title>
<para>
Les variables de template commence par un signe dollar (<literal>$</literal>).
Elles peuvent contenir des nombres, des lettres et des underscores, tout
- comme une <ulink url="&url.php-manual;language.variables">variable PHP</ulink>.
+ comme une <ulink url="&url.php-manual;language.variables">variable PHP</ulink>.
Vous pouvez référencer des tableaux indexés
- numériquement ou non. Vous pouvez aussi référencer des propriétés d'objet
- ainsi que des méthodes. Les <link linkend="language.config.variables">variables des fichiers de
+ numériquement ou non. Vous pouvez aussi référencer des propriétés d'objet
+ ainsi que des méthodes.
+ </para>
+ <para>
+ Les <link linkend="language.config.variables">variables des fichiers de
configuration</link> sont une exception à la synthaxe utilisant un signe dollar. Elles peuvent être
- référencées en les entourant du signe dièse (<literal>#</literal>) ou avec la variable spéciale
+ référencées en les entourant du signe dièse (<literal>#</literal>) ou via la variable spéciale
<link linkend="language.variables.smarty.config">$smarty.config</link>.
</para>
<example>
@@ -27,7 +31,7 @@
{#foo#} <-- affiche la variable du fichier de configuration "foo"
{$smarty.config.foo} <-- synonyme pour {#foo#}
{$foo[bar]} <-- synthaxe uniquement valide dans une section de boucle, voir {section}
-{assign var=foo value="baa"}{$foo} <-- affiche "baa", voir {assign}
+{assign var=foo value='baa'}{$foo} <-- affiche "baa", voir {assign}
Plusieurs autres combinaisons sont autorisées
@@ -46,9 +50,10 @@
</example>
<para>
- Les variables spéciales comme get, post, session, etc. sont également disponibles,
+ Les variables spéciales comme $_GET, $_SESSION, etc. sont également disponibles,
lisez le chapitre sur les variables réservées
- <link linkend="language.variables.smarty">$smarty</link> pour plus de détails.
+ <emphasis><link linkend="language.variables.smarty">$smarty</link></emphasis>
+ pour plus de détails.
</para>
<para>
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml:1.10 smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml:1.11
--- smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml:1.10 Sat Feb 18 17:54:23 2006
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml Sun Apr 9 21:59:55 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.13 Maintainer: gerald Status: ready -->
<sect1 id="language.function.capture">
<title>{capture}</title>
@@ -8,14 +8,19 @@
<para>
{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
+ name='foo'} et {/capture} est intercepté dans une variable dont le nom est
+ spécifié dans l'attribut name.
+ </para>
+ <para>
+ Le contenu capturé peut être utilisé dans
le template par l'intermédiaire de la variable spéciale
<link linkend="language.variables.smarty.capture">$smarty.capture.foo</link>
où "foo" est la valeur de l'attribut name. Si vous ne donnez pas de valeur
- à l'attribut name, alors "default" est utilisé. Toutes les commandes
- {capture} doivent être utilisées de paire avec {/capture}. Vous pouvez
- imbriquer les demandes de captures.
+ à l'attribut name, alors "default" est utilisé en tant que nom, i.e.
+ $smarty.capture.default.
+ </para>
+ <para>
+ {capture} peut être imbriqué.
</para>
<informaltable frame="all">
@@ -65,38 +70,32 @@
</caution>
<para>
<example>
- <title>Capturer le contenu d'un template.</title>
+ <title>{capture} avec le nom de l'attribut</title>
<programlisting>
<![CDATA[
-{* nous ne voulons afficher une ligne que si cette dernière est activé. *}
+{* nous ne voulons afficher une balise div que si le contenu est affiché. *}
{capture name=banner}
{include file='get_banner.tpl'}
{/capture}
{if $smarty.capture.banner ne ""}
-<table>
-<tr>
- <td>
- {$smarty.capture.banner}
- </td>
-</tr>
-</table>
+<div id="banner">{$smarty.capture.banner}</div>
{/if}
]]>
</programlisting>
</example>
<example>
- <title>Capturer le contenu dans une variable</title>
+ <title>{capture} dans une variable de template</title>
<para>Cet exemple démontre également la fonction
<link linkend="language.function.popup">{popup}</link>
</para>
<programlisting>
<![CDATA[
{capture name=some_content assign=popText}
-.... du contenu ....
+Le serveur est {$smarty.server.SERVER_NAME|upper} sur {$smarty.server.SERVER_ADDR}<br>
+Votre IP est {$smarty.server.REMOTE_ADDR}.
{/capture}
-
-<a href="#" {popup caption='Help' text=$popText}>help</a>
+<a href="#" {popup caption='Information sur le serveur' text=$popText}>Aide</a>
]]>
</programlisting>
</example>
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml:1.10 smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml:1.11
--- smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml:1.10 Fri Feb 17 22:40:54 2006
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml Sun Apr 9 21:59:55 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.9 Maintainer: gerald Status: ready -->
<sect1 id="language.function.insert">
<title>{insert}</title>
@@ -9,7 +9,7 @@
Les balises {insert} fonctionnent à peu près comme les balises
<link linkend="language.function.include">include</link>,
à l'exception que leur sortie n'est PAS placée en cache lorsque
- <link linkend="caching">le cache</link> est activé.
+ <link linkend="caching">le cache</link> du template est activé.
Les balises {insert} seront exécutées à chaque appel du template.
</para>
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml?r1=1.9&r2=1.10&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml:1.9 smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml:1.10
--- smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml:1.9 Fri Feb 17 22:40:54 2006
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml Sun Apr 9 21:59:55 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
<sect1 id="language.function.php">
<title>{php}</title>
@@ -9,11 +9,11 @@
template. Ils ne seront pas ignorés, quelle que soit la valeur de <link
linkend="variable.php.handling">$php_handling</link>. Pour les
utilisateurs avancés seulement, son utilisation n'est normalement pas
- nécessaire.
+ nécessaire et n'est pas recommandée.
</para>
<example>
<title>Balises {php}</title>
- <programlisting role="php">
+ <programlisting>
<![CDATA[
{php}
// inclusion directe d'un script PHP
@@ -32,14 +32,26 @@
</note>
<example>
- <title>Balises {php} avec le mot clé global</title>
+ <title>Balises {php} avec le mot clé global et assignement d'une variable</title>
<programlisting role="php">
<![CDATA[
{php}
global $foo, $bar;
if($foo == $bar){
- // do something
+ echo 'Ceci apparaîtera dans le template';
}
+$this->assign('varX','Strawberry');
+{/php}
+<strong>{$varX}</strong> est ma glâce favorite
+]]>
+ </programlisting>
+ <para>
+ Ce qui suit n'est vrament PAS recommandé, vu que c'est dans le contexte du template.
+ </para>
+ <programlisting>
+<![CDATA[
+{php}
+print_r($some_array);
{/php}
]]>
</programlisting>
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-builtin-functions.xml?r1=1.6&r2=1.7&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions.xml
diff -u smarty/docs/fr/designers/language-builtin-functions.xml:1.6 smarty/docs/fr/designers/language-builtin-functions.xml:1.7
--- smarty/docs/fr/designers/language-builtin-functions.xml:1.6 Mon Nov 28 21:20:27 2005
+++ smarty/docs/fr/designers/language-builtin-functions.xml Sun Apr 9 21:59:55 2006
@@ -1,15 +1,23 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
<chapter id="language.builtin.functions">
<title>Fonctions natives</title>
<para>
Smarty est fourni en standard avec plusieurs fonctions natives.
- Les fonctions natives sont partie intégrante du language de template.
- Vous ne pouvez pas créer de fonctions utilisateurs qui portent le même nom
- qu'une fonction native. Vous ne pouvez pas non plus en modifier le
- comportement.
+ Ces fonctions natives sont partie intégrante du moteur de Smarty.
+ Vous ne pouvez pas créer de
+ <link linkend="language.custom.functions">fonctions utilisateurs</link>
+ qui portent le même nom qu'une fonction native et vous ne pouvez pas non
+ plus en modifier le comportement.
+ </para>
+ <para>
+ Quelques-unes de ces fonctions ont un attribut
+ <emphasis role="bold">assign</emphasis> qui récupère le résultat de la
+ fonction et la place dans une variable nommée dans le template plutôt que
+ de l'afficher.tout comme la fonction
+ <link linkend="language.function.assign">{assign}</link>.
</para>
&designers.language-builtin-functions.language-function-capture;
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-modifiers.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/designers/language-modifiers.xml
diff -u smarty/docs/fr/designers/language-modifiers.xml:1.10 smarty/docs/fr/designers/language-modifiers.xml:1.11
--- smarty/docs/fr/designers/language-modifiers.xml:1.10 Mon Nov 28 21:20:28 2005
+++ smarty/docs/fr/designers/language-modifiers.xml Sun Apr 9 21:59:55 2006
@@ -1,17 +1,21 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.19 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.23 Maintainer: gerald Status: ready -->
<chapter id="language.modifiers">
<title>Modificateurs de variables</title>
<para>
- Les modificateurs de variables peuvent être appliqués aux variables,
- fonctions utilisateurs ou chaînes de caractères. Pour appliquer un modificateur
+ Les modificateurs de variables peuvent être appliqués aux
+ <link linkend="language.syntax.variables">variables</link>,
+ <link linkend="language.custom.functions">fonctions utilisateurs</link>
+ ou chaînes de caractères. Pour appliquer un modificateur
de variable, tappez une valeure suivie de <literal>|</literal>
(pipe) et du nom du modificateur. Un modificateur de variable
est succeptible d'accepter des paramètres additionnels, qui en affectent
le comportement. Ces paramètres suivent le nom du modificateur et
sont séparés par un <literal>:</literal> (deux points).
+ De plus, toutes les fonctions PHP peuvent être utilisées en tant que modifieurs
+ implicitement.
</para>
<example>
<title>Exemple de modificateur</title>
@@ -21,21 +25,35 @@
{$titre|upper}
{* modificateur avec paramètres *}
-{$titre|truncate:40:"..."}
+{$titre|truncate:40:'...'}
{* applique un modificateur à un paramètre de fonction *}
{html_table loop=$mavariable|upper}
{* avec paramètres *}
-{html_table loop=$mavariable|truncate:40:"..."}
+{html_table loop=$mavariable|truncate:40:'...'}
{* applique un modificateur à une chaine de caractères *}
-{"foobar"|upper}
+{'foobar'|upper}
{* utilise date_format pour mettre en forme la date *}
{$smarty.now|date_format:"%d/%m/%Y"}
{* applique un modificateur à une fonction utilisateur *}
-{mailto|upper address="[email protected]"}
+{mailto|upper address='[email protected]'}
+
+{* utilisation de la fonction PHP str_repeat *}
+{'='|str_repeat:80}
+
+{* Compteur PHP *}
+{$myArray|@count}
+
+{* mélange aléatoire des IP du serveur grâce à PHP *}
+{$smarty.server.SERVER_ADDR|shuffle}
+
+(* ceci va mettre en majuscule et tronque le tableau *}
+<select name="name_id">
+ {html_options output=$myArray|upper|truncate:20}
+</select>
]]>
</programlisting>
</example>
@@ -49,21 +67,21 @@
</para>
<para>
Les modificateurs sont chargés automatiquement depuis votre répertoire
- de plugin <link linkend="variable.plugins.dir">$plugins_dir</link> (voir aussi:
- <link linkend="plugins.naming.conventions">convention de nommage</link>)
- ou peuvent être enregistrés explicitement (voir: <link
- linkend="api.register.modifier">register_modifier</link>).
+ de plugin <link linkend="variable.plugins.dir">$plugins_dir</link>
+ ou peuvent être enregistrés explicitement avec <link
+ linkend="api.register.modifier">register_modifier()</link> ; ceci est utile
+ pour partager une fonction dans un scirpt PHP et les templates Smarty.
</para>
<para>
- De même, toutes les fonction php peuvent être utilisées comme modificateur,
+ Toutes les fonction PHP peuvent être utilisées comme modificateur,
sans autre déclaration. (L'exemple avec
- <literal>@count</literal> ci dessus utilise la fonction count(), et non un modificateur
+ <literal>@count</literal> ci-dessus utilise la fonction count(), et non un modificateur
Smarty. Utiliser des fonctions PHP en tant que modificateur comporte deux
risques: Premièrement: il arrive que l'ordre des paramètres ne soit pas
celui attendu (<literal>{"%2.f"|sprintf:$float}</literal> fonctionne,
mais demande une syntaxe plus naturelle, par exemple<literal>{$float|string_format:"%2.f"}</literal>
fourni dans la distribution Smarty). Deuxièmement : lorsque <link
- linkend="variable.security">$security</link> est activé, les fonctions php
+ linkend="variable.security">$security</link> est activé, les fonctions PHP
utilisées en tant que modificateur doivent être explicitement déclarées
comme connues dans le tableau <link linkend="variable.security.settings">
$security_settings['MODIFIER_FUNCS']</link>.
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml?r1=1.7&r2=1.8&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml:1.7 smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml:1.8
--- smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml:1.7 Sat Mar 11 19:45:40 2006
+++ smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml Sun Apr 9 21:59:55 2006
@@ -1,11 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
<sect1 id="language.function.assign">
<title>{assign}</title>
<para>
- {assign} est utilisé pour déclarer ou modifier des variables de template.
+ {assign} est utilisé pour déclarer des variables de template
+ <emphasis role="bold">durant l'exécution du template</emphasis>.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -73,7 +74,7 @@
<example>
<title>Accès aux variables {assign} depuis un script PHP.</title>
<para>
- Pour accéder aux variables {assign} depuis PHP, utilisez
+ Pour accéder aux variables {assign} depuis le script PHP, utilisez
<link linkend="api.get.template.vars">get_template_vars()</link>.
Cependant, les variables ne sont disponibles qu'après ou pendant l'exécution du
template, comme le montre l'exemple suivant :
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml?r1=1.5&r2=1.6&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml:1.5 smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml:1.6
--- smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml:1.5 Sun Dec 4 17:56:05 2005
+++ smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml Sun Apr 9 21:59:55 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<sect1 id="language.function.eval">
<title>{eval}</title>
@@ -71,9 +71,8 @@
<title>{eval}</title>
<programlisting>
<![CDATA[
-setup.conf
-----------
-
+#setup.conf
+#----------
emphstart = <strong>
emphend = </strong>
titre = Bienvenue sur la homepage de {$company} !
@@ -82,16 +81,16 @@
]]>
</programlisting>
<para>
- Où index.tpl est :
+ Où le template est :
</para>
<programlisting>
<![CDATA[
-{config_load file="setup.conf"}
+{config_load file='setup.conf'}
{eval var=$foo}
{eval var=#titre#}
{eval var=#ErrorVille#}
-{eval var=#ErrorDept# assign="state_error"}
+{eval var=#ErrorDept# assign='state_error'}
{$state_error}
]]>
</programlisting>
@@ -104,10 +103,33 @@
Bienvenue sur la homepage de FictifLand.
Vous devez spécifier un nom de <strong>ville</strong>.
Vous devez spécifier un <strong>département</strong>.
-
]]>
</screen>
</example>
+
+ <example>
+ <title>un autre exemple avec {eval}</title>
+ <para>
+ Ceci va afficher le nom du serveur (en majuscule) et son IP.
+ La variable $str également venir d'une requête de base de données.
+ </para>
+ <programlisting role="php">
+<![CDATA[
+// script php
+$str = 'Le nom du serveur est {$smarty.server.SERVER_NAME|upper} '
+.'at {$smarty.server.SERVER_ADDR}';
+$smarty->assign('foo',$str);
+ ]]>
+ </programlisting>
+ <para>
+ Où le template est :
+ </para>
+ <programlisting>
+<![CDATA[
+{eval var=$foo}
+]]>
+ </programlisting>
+ </example>
</sect1>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-modifiers/language-modifier-default.xml?r1=1.6&r2=1.7&diff_format=u
Index: smarty/docs/fr/designers/language-modifiers/language-modifier-default.xml
diff -u smarty/docs/fr/designers/language-modifiers/language-modifier-default.xml:1.6 smarty/docs/fr/designers/language-modifiers/language-modifier-default.xml:1.7
--- smarty/docs/fr/designers/language-modifiers/language-modifier-default.xml:1.6 Sat Mar 11 19:45:40 2006
+++ smarty/docs/fr/designers/language-modifiers/language-modifier-default.xml Sun Apr 9 21:59:55 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
<sect1 id="language.modifier.default">
<title>default</title>
@@ -9,6 +9,14 @@
Si la variable est vide ou indéfinie, la valeur donnée est affichée
en lieu et place. Default attends un seul argument.
</para>
+ <para>
+ <note>
+ <para>
+ Avec error_reporting(E_ALL), les variables non déclarées lanceront toujours une erreur
+ dans le template. Cette fonction est utile pour remplacer les chaînes vides ou de longueurs vides.
+ </para>
+ </note>
+ </para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-modifiers/language-modifier-escape.xml?r1=1.9&r2=1.10&diff_format=u
Index: smarty/docs/fr/designers/language-modifiers/language-modifier-escape.xml
diff -u smarty/docs/fr/designers/language-modifiers/language-modifier-escape.xml:1.9 smarty/docs/fr/designers/language-modifiers/language-modifier-escape.xml:1.10
--- smarty/docs/fr/designers/language-modifiers/language-modifier-escape.xml:1.9 Wed Mar 22 17:30:04 2006
+++ smarty/docs/fr/designers/language-modifiers/language-modifier-escape.xml Sun Apr 9 21:59:55 2006
@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready -->
<sect1 id="language.modifier.escape">
<title>escape</title>
<para>
- "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.
+ Utile pour encoder / échapper une variable pour quelles soient compatibles
+ pour les URL Html, pour les hexadécimaux, pour les entités hexadécimales, pour javascript
+ et pour les e-mails.
Par défaut, ce paramètre est html.
</para>
<informaltable frame="all">
@@ -76,12 +76,13 @@
<![CDATA[
{$titreArticle}
{$titreArticle|escape}
-{$titreArticle|escape:"html"} {* escapes & " ' < > *}
-{$titreArticle|escape:"htmlall"} {* escapes ALL html entities *}
-{$titreArticle|escape:"url"}
-{$titreArticle|escape:"quotes"}
+{$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>
-{$EmailAddress|escape:'mail'}
+{$EmailAddress|escape:'mail'} {* ceci convertit l'e-mail en texte *}
+{'[email protected]'|escape:'mail'}
]]>
</programlisting>
<para>
@@ -97,6 +98,7 @@
\'Stiff Opposition Expected to Casketless Funeral Plan\'
<a href="mailto:%62%6f%..snip..%65%74">bob..snip..et</a>
smarty [AT] example [DOT] com
+mail [AT] example [DOT] com
]]>
</screen>
<para>
@@ -108,11 +110,21 @@
<a href="{$SCRIPT_NAME}?page=foo&rewind={$smarty.server.REQUEST_URI|urlencode}">click here</a>
]]>
</screen>
+ <para>
+ Et ceci est utile pour les e-mails, mais lisez plutôt la documentation de
+ <link linkend="language.function.mailto">{mailto}</link></para>
+<screen>
+ <![CDATA[
+{* email address mangled *}
+<a href="mailto:{$EmailAddress|escape:'hex'}">{$EmailAddress|escape:'mail'}</a>
+]]>
+ </screen>
</example>
<para>
Voir aussi la
- <link linkend="language.escaping">désactivation de l'analyse de Smarty</link> et
- le <link linkend="tips.obfuscating.email">mascage des adresses E-mail</link>.
+ l'<link linkend="language.escaping">anayse Smarty d'échappement</link>,
+ <link linkend="language.function.mailto">{mailto}</link> et
+ le <link linkend="tips.obfuscating.email">mascage des adresses e-mail</link>.
</para>
</sect1>
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml?r1=1.5&r2=1.6&diff_format=u
Index: smarty/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml
diff -u smarty/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml:1.5 smarty/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml:1.6
--- smarty/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml:1.5 Sun Dec 4 20:09:57 2005
+++ smarty/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml Sun Apr 9 21:59:55 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
<sect1 id="language.modifier.nl2br">
<title>nl2br</title>
@@ -10,7 +10,7 @@
</para>
<example>
<title>nl2br</title>
-<programlisting role="php">
+ <programlisting role="php">
<![CDATA[
<?php
@@ -20,30 +20,30 @@
?>
]]>
-</programlisting>
-<para>
-Où le template est :
-</para>
-<programlisting>
+ </programlisting>
+ <para>
+ Où le template est :
+ </para>
+ <programlisting>
<![CDATA[
{$TitreArticle|nl2br}
]]>
-</programlisting>
-<para>
-Ce qui donne en sortie :
-</para>
-<screen>
+ </programlisting>
+ <para>
+ Affichera :
+ </para>
+ <screen>
<![CDATA[
Pluie ou soleil attendu<br />aujourd'hui, nuit noire
]]>
-</screen>
-</example>
-<para>
- Voir aussi
- <link linkend="language.modifier.wordwrap">word_wrap</link>,
- <link linkend="language.modifier.count.paragraphs">count_paragraphs</link> et
- <link linkend="language.modifier.count.sentences">count_sentences</link>.
- </para>
+ </screen>
+ </example>
+ <para>
+ Voir aussi
+ <link linkend="language.modifier.wordwrap">word_wrap</link>,
+ <link linkend="language.modifier.count.paragraphs">count_paragraphs</link> et
+ <link linkend="language.modifier.count.sentences">count_sentences</link>.
+ </para>
</sect1>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-modifiers/language-modifier-truncate.xml?r1=1.4&r2=1.5&diff_format=u
Index: smarty/docs/fr/designers/language-modifiers/language-modifier-truncate.xml
diff -u smarty/docs/fr/designers/language-modifiers/language-modifier-truncate.xml:1.4 smarty/docs/fr/designers/language-modifiers/language-modifier-truncate.xml:1.5
--- smarty/docs/fr/designers/language-modifiers/language-modifier-truncate.xml:1.4 Sun Dec 4 20:09:57 2005
+++ smarty/docs/fr/designers/language-modifiers/language-modifier-truncate.xml Sun Apr 9 21:59:55 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<sect1 id="language.modifier.truncate">
<title>truncate</title>
@@ -90,6 +90,7 @@
{$titreArticle|truncate:30:"---"}
{$titreArticle|truncate:30:"":true}
{$titreArticle|truncate:30:"...":true}
+{$articleTitle|truncate:30:'..':true:true}
]]>
</programlisting>
<para>
@@ -103,6 +104,7 @@
Deux soeurs réunies après---
Deux soeurs réunies après 18 a
Deux soeurs réunies après 1...
+Deux soeurs ... de séparation.
]]>
</screen>
</example>
http://cvs.php.net/viewcvs.cgi/smarty/docs/fr/designers/language-variables/language-variables-smarty.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/designers/language-variables/language-variables-smarty.xml
diff -u smarty/docs/fr/designers/language-variables/language-variables-smarty.xml:1.10 smarty/docs/fr/designers/language-variables/language-variables-smarty.xml:1.11
--- smarty/docs/fr/designers/language-variables/language-variables-smarty.xml:1.10 Sat Dec 10 22:09:38 2005
+++ smarty/docs/fr/designers/language-variables/language-variables-smarty.xml Sun Apr 9 21:59:55 2006
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready -->
<sect1 id="language.variables.smarty">
<title>Variable réservée {$smarty}</title>
<para>
La variable PHP réservée {$smarty} peut être utilisée pour accéder à plusieurs
- variables spéciales du template. En voici la liste complète.
+ variables d'environnements. En voici la liste complète.
</para>
<sect2 id="language.variables.smarty.request">
@@ -51,6 +51,12 @@
directement, cependant, {$smarty.server.SCRIPT_NAME} est
la solution proposée pour accéder à cette valeur.
</para>
+ <programlisting>
+<![CDATA[
+<a href="{$SCRIPT_NAME}?page=smarty">click me</a>
+<a href="{$smarty.server.SCRIPT_NAME}?page=smarty">click me</a>
+]]>
+ </programlisting>
</note>
</sect2>
@@ -59,10 +65,12 @@
<para>
Le <ulink url="&url.php-manual;function.time">timestamp</ulink>
courant peut être récupéré grâce à {$smarty.now}.
- Le nombre obtenu correspond au nombre de secondes écoulées depuis
+ La valeur correspond au nombre de secondes écoulées depuis
Epoch (1 Janvier 1970) et peut être passé directement au modificateur
de variable date <link linkend="language.modifier.date.format">date_format</link>
- à des fins d'affichage.
+ à des fins d'affichage. Notez que time() est appelé à chaque invocation, i.e.
+ un script qui prend 3 secondes à s'exécuter avec $smarty.now au début et à la fin montrera
+ les 3 secondes de différence.
</para>
<example>
<title>Utilisation de {$smarty.now}</title>
@@ -82,9 +90,16 @@
Voir aussi les <link linkend="smarty.constants">constantes smarty</link>.
</para>
<example>
- <title>Utiliser {$smarty.const}</title>
+ <title>Utiliser {$smarty.const} pour accéder aux constantes</title>
+ <programlisting role="php">
+<![CDATA[
+// la constante définie dans PHP
+define('_MY_CONST_VAL','CHERRIES');
+]]>
+ </programlisting>
<programlisting>
<![CDATA[
+{* la sortie de la constante PHP dans le template *}
{$smarty.const._MA_CONSTANTE_}
]]>
</programlisting>
@@ -94,9 +109,9 @@
<sect2 id="language.variables.smarty.capture">
<title>{$smarty.capture}</title>
<para>
- La capture réalisée via
+ La sortie du template réalisée via
<link linkend="language.function.capture">{capture}..{/capture}</link>
- peut être récupérée par l'intermédiaire de la variable {$smarty}. Voir la section
+ peut être récupérée par l'intermédiaire de la variable {$smarty.capture}. Voir la section
sur <link linkend="language.function.capture">{capture}</link> pour un
exemple à ce sujet.
</para>
@@ -120,27 +135,47 @@
des boucles 'section' et 'foreach'. Voir la documentation de
<link linkend="language.function.section">{section}</link> et
<link linkend="language.function.foreach">{foreach}</link>.
+ Ils ont des valeurs vraiment utiles comme .first, .index, etc.
</para>
</sect2>
<sect2 id="language.variables.smarty.template">
<title>{$smarty.template}</title>
<para>
- Cette variable contient le nom du template en cours de traitement.
+ Retourne le nom du template courant. Cet exemple montre le container.tpl
+ ainsi que le banner.tpl inclu avec {$smarty.template}.
</para>
+ <programlisting>
+<![CDATA[
+<b>Le conteneur principal est {$smarty.template}</b>
+{include file='banner.tpl}
+ ]]>
+</programlisting>
+Affichera :
+<programlisting>
+ <![CDATA[
+<b>Le conteneur principal est container.tpl</b>
+ banner.tpl
+ ]]>
+ </programlisting>
</sect2>
<sect2 id="language.variables.smarty.version">
<title>{$smarty.version}</title>
<para>
- Cette variable contient la version de Smarty utilisée pour compiler un template.
+ Retourne la version de Smarty ayant servie à compiler le template.
</para>
+ <programlisting>
+<![CDATA[
+<div id="footer">Généré par Smarty {$smarty.version}</div>
+]]>
+</programlisting>
</sect2>
<sect2 id="language.variables.smarty.ldelim">
<title>{$smarty.ldelim}, {$smarty.rdelim}</title>
<para>
- Cette variable est utilisée pour afficher le délémiteur gauche et le délimiteur droit. Lisez aussi
+ Ces variables sont utilisées pour afficher le délémiteur gauche et le délimiteur droit. Lisez aussi
la partie <link linkend="language.function.ldelim">{ldelim},{rdelim}</link>.
</para>
<para>