cvs: smarty /docs/fr/designers/language-custom-functions language-function-assign.xml language-function-counter.xml language-function-cycle.xml language-function-debug.xml language-function-eval.xml language-function-fetch.xml language-function-html-checkboxes.xml language-function-html-image.xml language-function-html-options.xml language-function-html-radios.xml language-function-html-select-date.xml
"Yannick Torres" <[email protected]> Sun, 01 Oct 2006 20:03:00 -0000
| Newsgroups | gmane.comp.php.cvs.smarty |
|---|---|
| Message-ID | <cvsyannick1159732980@cvsserver> |
yannick Sun Oct 1 20:03:00 2006 UTC
Modified files:
/smarty/docs/fr/designers/language-custom-functions
language-function-assign.xml
language-function-counter.xml
language-function-cycle.xml
language-function-debug.xml
language-function-eval.xml
language-function-fetch.xml
language-function-html-checkboxes.xml
language-function-html-image.xml
language-function-html-options.xml
language-function-html-radios.xml
language-function-html-select-date.xml
Log:
sync with EN
--
Smarty CVS Mailing List (http://cvs.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
yannick-20061001200300.txt
(text/plain, 56.3 KB)
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml?r1=1.8&r2=1.9&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.8 smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml:1.9
--- smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml:1.8 Sun Apr 9 21:59:55 2006
+++ smarty/docs/fr/designers/language-custom-functions/language-function-assign.xml Sun Oct 1 20:03:00 2006
@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready -->
<sect1 id="language.function.assign">
<title>{assign}</title>
<para>
- {assign} est utilisé pour déclarer des variables de template
+ <varname>{assign}</varname> est utilisé pour déclarer des variables de template
<emphasis role="bold">durant l'exécution du template</emphasis>.
</para>
<informaltable frame="all">
@@ -46,7 +46,7 @@
<title>{assign}</title>
<programlisting>
<![CDATA[
-{assign var="name" value="Bob"}
+{assign var='name' value='Bob'}
La valeur de $name est {$name}.
]]>
@@ -72,19 +72,21 @@
</example>
<example>
- <title>Accès aux variables {assign} depuis un script PHP.</title>
+ <title>Accès aux variables {assign} depuis un script PHP</title>
<para>
- 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 :
+ Pour accéder aux variables <varname>{assign}</varname> depuis le script PHP, utilisez
+ <link linkend="api.get.template.vars"><varname>get_template_vars()</varname></link>.
+ Ci-dessous, le template qui crée la variable <parameter>$foo</parameter>.
</para>
<programlisting>
<![CDATA[
-{* index.tpl *}
-{assign var="foo" value="Smarty"}
+{assign var='foo' value='Smarty'}
]]>
</programlisting>
+ <para>
+ Les variables de template ne sont disponibles que après/durant l'exécution du template,
+ comme dans le script ci-dessous.
+ </para>
<programlisting role="php">
<![CDATA[
<?php
@@ -92,8 +94,8 @@
// ceci n'affichera rien car le template n'a pas encore été exécuté
echo $smarty->get_template_vars('foo');
-// Exécution du template
-$dead = $smarty->fetch('index.tpl');
+// Récupère le template dans une variable
+$whole_page = $smarty->fetch('index.tpl');
// Ceci affichera 'smarty' car le template a été exécuté
echo $smarty->get_template_vars('foo');
@@ -115,21 +117,21 @@
</para>
<para>
- <link linkend="language.function.capture">{capture}</link>,
- <link linkend="language.function.include">{include}</link>,
- <link linkend="language.function.include.php">{include_php}</link>,
- <link linkend="language.function.insert">{insert}</link>,
- <link linkend="language.function.counter">{counter}</link>,
- <link linkend="language.function.cycle">{cycle}</link>,
- <link linkend="language.function.eval">{eval}</link>,
- <link linkend="language.function.fetch">{fetch}</link>,
- <link linkend="language.function.math">{math}</link> et
- <link linkend="language.function.textformat">{textformat}</link>.
+ <link linkend="language.function.capture"><varname>{capture}</varname></link>,
+ <link linkend="language.function.include"><varname>{include}</varname></link>,
+ <link linkend="language.function.include.php"><varname>{include_php}</varname></link>,
+ <link linkend="language.function.insert"><varname>{insert}</varname></link>,
+ <link linkend="language.function.counter"><varname>{counter}</varname></link>,
+ <link linkend="language.function.cycle"><varname>{cycle}</varname></link>,
+ <link linkend="language.function.eval"><varname>{eval}</varname></link>,
+ <link linkend="language.function.fetch"><varname>{fetch}</varname></link>,
+ <link linkend="language.function.math"><varname>{math}</varname></link> et
+ <link linkend="language.function.textformat"><varname>{textformat}</varname></link>.
</para>
<para>
Voir aussi
- <link linkend="api.assign">assign()</link> et
- <link linkend="api.get.template.vars">get_template_vars()</link>.
+ <link linkend="api.assign"><varname>assign()</varname></link> et
+ <link linkend="api.get.template.vars"><varname>get_template_vars()</varname></link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-counter.xml?r1=1.5&r2=1.6&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-counter.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-counter.xml:1.5 smarty/docs/fr/designers/language-custom-functions/language-function-counter.xml:1.6
--- smarty/docs/fr/designers/language-custom-functions/language-function-counter.xml:1.5 Sun Dec 4 17:56:05 2005
+++ smarty/docs/fr/designers/language-custom-functions/language-function-counter.xml Sun Oct 1 20:03:00 2006
@@ -1,21 +1,22 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<sect1 id="language.function.counter">
<title>{counter}</title>
<para>
- {counter} affiche un compteur. {counter} retient la valeur
+ <varname>{counter}</varname> affiche un compteur.
+ <varname>{counter}</varname> 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é.
+ compteur, <quote>default</quote> sera utilisé.
</para>
<para>
- 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.
+ Si vous donnez une valeur à l'attribut <parameter>assign</parameter>,
+ alors la sortie de la fonction <varname>{counter}</varname> sera assignée
+ à la variable de template donnée plutôt que d'être directement affichée.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -66,7 +67,7 @@
<entry>print</entry>
<entry>booléen</entry>
<entry>Non</entry>
- <entry><emphasis>true</emphasis></entry>
+ <entry><emphasis>&true;</emphasis></entry>
<entry>S'il faut afficher cette valeur ou non</entry>
</row>
<row>
@@ -81,7 +82,7 @@
</tgroup>
</informaltable>
<example>
- <title>counter</title>
+ <title>{counter}</title>
<programlisting>
<![CDATA[
{* initialisation du compteur *}
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-cycle.xml?r1=1.4&r2=1.5&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-cycle.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-cycle.xml:1.4 smarty/docs/fr/designers/language-custom-functions/language-function-cycle.xml:1.5
--- smarty/docs/fr/designers/language-custom-functions/language-function-cycle.xml:1.4 Sun Dec 4 17:56:05 2005
+++ smarty/docs/fr/designers/language-custom-functions/language-function-cycle.xml Sun Oct 1 20:03:00 2006
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
<sect1 id="language.function.cycle">
<title>{cycle}</title>
<para>
- {cycle} est utilisé pour boucler sur un ensemble de valeurs. Très pratique
- pour alterner entre deux ou plusieurs couleurs dans un tableau,
+ <varname>{cycle}</varname> 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.
</para>
<informaltable frame="all">
@@ -40,20 +40,20 @@
<entry><emphasis>N/A</emphasis></entry>
<entry>Les valeurs sur lesquelles boucler, soit une liste
séparée par des virgules, (voir l'attribut delimiter),
- soit un tableau de valeurs.</entry>
+ soit un tableau de valeurs</entry>
</row>
<row>
<entry>print</entry>
<entry>booléen</entry>
<entry>Non</entry>
- <entry><emphasis>true</emphasis></entry>
+ <entry><emphasis>&true;</emphasis></entry>
<entry>S'il faut afficher ou non cette valeur</entry>
</row>
<row>
<entry>advance</entry>
<entry>booléen</entry>
<entry>Non</entry>
- <entry><emphasis>true</emphasis></entry>
+ <entry><emphasis>&true;</emphasis></entry>
<entry>Oui ou non aller à la prochaîne valeur</entry>
</row>
<row>
@@ -75,29 +75,33 @@
<entry>reset</entry>
<entry>booléen</entry>
<entry>Non</entry>
- <entry><emphasis>false</emphasis></entry>
+ <entry><emphasis>&false;</emphasis></entry>
<entry>Le cycle sera défini à la première valeur</entry>
</row>
</tbody>
</tgroup>
</informaltable>
+
+ <itemizedlist>
+ <listitem>
<para>
- Vous pouvez définir plusieurs {cycle} dans votre template, en leur
- donnant des noms uniques (attribut name).
- </para>
- <para>
+ Vous pouvez définir plusieurs <varname>{cycle}</varname> dans votre template, en leur
+ donnant des noms uniques (attribut <parameter>name</parameter>).
+ </para></listitem>
+ <listitem><para>
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.
- </para>
- <para>
- 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.
- </para>
- <para>
- 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.
- </para>
+ l'attribut <parameter>print</parameter> à &false;. Ce procédé peut être
+ utile pour discrètement passer outre une valeur de la liste.
+ </para></listitem>
+ <listitem><para>
+ L'attribut <parameter>advance</parameter> est utilisé pour répéter une valeur. Lorsque
+ définit à &false;, le prochain appel de <varname>{cycle}</varname> ramènera la même valeur.
+ </para></listitem>
+ <listitem><para>
+ Si vous définissez l'attribut spécial <parameter>assign</parameter>, la sortie de la fonction
+ <varname>{cycle}</varname> y sera assignée plutôt que d'être directement affichée.
+ </para></listitem>
+</itemizedlist>
<example>
<title>{cycle}</title>
<programlisting>
@@ -108,7 +112,8 @@
</tr>
{/section}
]]>
- </programlisting>
+</programlisting>
+ <para>Le template ci-dessus affichera :</para>
<screen>
<![CDATA[
<tr bgcolor="#eeeeee">
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-debug.xml?r1=1.5&r2=1.6&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-debug.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-debug.xml:1.5 smarty/docs/fr/designers/language-custom-functions/language-function-debug.xml:1.6
--- smarty/docs/fr/designers/language-custom-functions/language-function-debug.xml:1.5 Sun Dec 4 17:56:05 2005
+++ smarty/docs/fr/designers/language-custom-functions/language-function-debug.xml Sun Oct 1 20:03:00 2006
@@ -1,9 +1,18 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
<sect1 id="language.function.debug">
<title>{debug}</title>
+ <para>
+ <varname>{debug}</varname> amène la console de débogage sur la page.
+ Fonctionne quelle que soit la valeur du paramètre
+ <link linkend="chapter.debugging.console">debug</link> de Smarty.
+ Comme ce dernier est appelé lors de l'exécution, il n'est capable
+ d'afficher que les variables <link linkend="api.assign">assignées</link>
+ au template, et non les templates en cours d'utilisation. Toutefois, vous
+ voyez toutes les variables disponibles pour le template courant.
+ </para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -32,15 +41,6 @@
</tgroup>
</informaltable>
<para>
- {debug} amène la console de débogage sur la page. Fonctionne
- quelle que soit la valeur du paramètre <link
- linkend="chapter.debugging.console">debug</link> de Smarty.
- Comme ce dernier est appelé lors de l'exécution, il n'est capable
- d'afficher que les variables <link linkend="api.assign">assignées</link>
- au template, et non les templates en cours d'utilisation. Toutefois, vous
- voyez toutes les variables disponibles pour le template courant.
- </para>
- <para>
Voir aussi
<link linkend="chapter.debugging.console">la console de débogage</link>.
</para>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml?r1=1.6&r2=1.7&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.6 smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml:1.7
--- smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml:1.6 Sun Apr 9 21:59:55 2006
+++ smarty/docs/fr/designers/language-custom-functions/language-function-eval.xml Sun Oct 1 20:03:00 2006
@@ -1,17 +1,18 @@
<?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.7 Maintainer: yannick Status: ready -->
<sect1 id="language.function.eval">
<title>{eval}</title>
<para>
- {eval} évalue une variable comme si cette dernière était un template.
+ <varname>{eval}</varname> é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.
</para>
<para>
- Si vous définissez l'attribut "assign", la sortie sera assignée à la
+ Si vous définissez l'attribut <parameter>assign</parameter>, la sortie sera assignée à la
variable de template désignée plutôt que d'être affichée dans le
template.
</para>
@@ -37,7 +38,7 @@
<entry>mixed</entry>
<entry>Oui</entry>
<entry><emphasis>n/a</emphasis></entry>
- <entry>variable (ou chaîne de caractères) à évaluer</entry>
+ <entry>Variable (ou chaîne de caractères) à évaluer</entry>
</row>
<row>
<entry>assign</entry>
@@ -53,22 +54,25 @@
<note>
<title>Note technique</title>
<para>
+ <itemizedlist>
+ <listitem><para>
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.
- </para>
- </note>
- <note>
- <title>Note technique</title>
- <para>
+ </para></listitem>
+
+ <listitem><para>
Les variables évaluées sont compilées à chaque invocation, et la version
compilée n'est pas sauvegardée ! Toutefois, si le
<link linkend="caching">cache</link> est activé, la sortie sera placée en
cache avec le reste du template.
- </para>
+ </para></listitem>
+</itemizedlist>
+</para>
</note>
<example>
<title>{eval}</title>
+<para>Le contenu du fichier de configuration, <filename>setup.conf</filename>.</para>
<programlisting>
<![CDATA[
#setup.conf
@@ -111,14 +115,15 @@
<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.
+ La variable <parameter>$str</parameter> également venir d'une requête de base de données.
</para>
<programlisting role="php">
<![CDATA[
-// script php
+<?php
$str = 'Le nom du serveur est {$smarty.server.SERVER_NAME|upper} '
.'at {$smarty.server.SERVER_ADDR}';
$smarty->assign('foo',$str);
+?>
]]>
</programlisting>
<para>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-fetch.xml?r1=1.8&r2=1.9&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-fetch.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-fetch.xml:1.8 smarty/docs/fr/designers/language-custom-functions/language-function-fetch.xml:1.9
--- smarty/docs/fr/designers/language-custom-functions/language-function-fetch.xml:1.8 Wed Mar 22 17:30:04 2006
+++ smarty/docs/fr/designers/language-custom-functions/language-function-fetch.xml Sun Oct 1 20:03:00 2006
@@ -1,23 +1,61 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready -->
<sect1 id="language.function.fetch">
<title>{fetch}</title>
<para>
- {fetch} est utilisé pour récupérer des fichiers depuis le système de
+ <varname>{fetch}</varname> 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.
- </para>
- <para>
- Vous pouvez spécifier l'attribut optionnel "assign"
- qui défini une variable de template dans laquelle la sortie
- sera stockée plutôt que d'être affichée.
</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ Si le nom du fichier commence par <parameter>http://</parameter>, la page internet sera
+ récupérée, puis affichée.
+ <note>
+ <para>
+ Ceci ne supporte pas les redirections http. Assurez vous d'inclure les
+ slash de fin sur votre page web si nécessaire.
+ </para>
+ </note>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Si le nom du fichier commence par <parameter>ftp://</parameter>,
+ le fichier sera récupéré depuis le serveur ftp, et affiché.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Pour les fichiers du système local, le chemin doit être absolu ou
+ relatif au chemin d'exécution du script PHP.
+ <note>
+ <para>
+ Si la variable de template <link linkend="variable.security">
+ <parameter>$security</parameter></link>
+ est activée et que vous récupérez un fichier depuis le système
+ de fichiers local, <varname>{fetch}</varname>
+ ne permettra que les fichiers se trouvant dans un des dossiers
+ définis dans les <link linkend="variable.secure.dir">dossiers sécurisés</link>.
+ </para>
+ </note>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Si l'attribut <parameter>assign</parameter> est défini, l'affichage
+ de la fonction <varname>{fetch}</varname> sera assignée à cette
+ variable de template au lieu d'être affichée dans le template.
+ </para>
+ </listitem>
+ </itemizedlist>
+
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -40,34 +78,20 @@
<entry>chaîne de caractères</entry>
<entry>Oui</entry>
<entry><emphasis>n/a</emphasis></entry>
- <entry>le fichier, site http ou ftp à récupérer</entry>
+ <entry>Le fichier, site http ou ftp à récupérer</entry>
</row>
<row>
<entry>assign</entry>
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry><emphasis>n/a</emphasis></entry>
- <entry>le nom de la variable PHP dans laquelle la sortie
+ <entry>Le nom de la variable PHP dans laquelle la sortie
sera assignée plutôt que d'être directement affichée.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
- <note>
- <title>Note technique</title>
- <para>Ne supporte pas les redirections http. Assurez vous d'inclure les
- slash de fin sur votre page web si nécessaire.
- </para>
- </note>
- <note>
- <title>Note technique</title>
- <para>
- Si la <link linkend="variable.security">sécurité</link> 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 <link linkend="variable.secure.dir">répertoires sécurisé</link>.
- </para>
- </note>
<example>
<title>Exempe avec {fetch}</title>
<programlisting>
@@ -86,17 +110,17 @@
{* assigne le contenu récupéré à une variable de template *}
{fetch file='http://www.myweather.com/68502/' assign='weather'}
{if $weather ne ''}
- <div id="weather">{$weather}</div>
+<div id="weather">{$weather}</div>
{/if}
]]>
</programlisting>
</example>
<para>
Voir aussi
- <link linkend="language.function.capture">{capture}</link>,
- <link linkend="language.function.assign">{assign}</link>
- <link linkend="language.function.eval">{eval}</link> et
- <link linkend="api.fetch">fetch()</link>.
+ <link linkend="language.function.capture"><varname>{capture}</varname></link>,
+ <link linkend="language.function.assign"><varname>{assign}</varname></link>
+ <link linkend="language.function.eval"><varname>{eval}</varname></link> et
+ <link linkend="api.fetch"><varname>fetch()</varname></link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml?r1=1.12&r2=1.13&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml:1.12 smarty/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml:1.13
--- smarty/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml:1.12 Mon May 22 08:46:06 2006
+++ smarty/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml Sun Oct 1 20:03:00 2006
@@ -1,16 +1,14 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.12 $ -->
-<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.13 $ -->
+<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready -->
<sect1 id="language.function.html.checkboxes">
<title>{html_checkboxes}</title>
<para>
- {html_checkboxes} est une
+ <varname>{html_checkboxes}</varname> est une
<link linkend="language.custom.functions">fonction utilisateur</link>
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 conforme au XHTML.
+ en compte la liste des éléments sélectionnés par défaut.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -40,16 +38,16 @@
<entry>values</entry>
<entry>array</entry>
<entry>Oui, à moins que vous n'utilisiez l'attribut
- option</entry>
+ option</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Un tableau de valeurs pour les cases à
- cocher</entry>
+ cocher</entry>
</row>
<row>
<entry>output</entry>
<entry>array</entry>
<entry>Oui, à moins que vous n'utilisiez l'attribut
- option</entry>
+ option</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Un tableau de sortie pour les cases à cocher</entry>
</row>
@@ -64,10 +62,10 @@
<entry>options</entry>
<entry>Tableau associatif</entry>
<entry>Oui, à moins que vous n'utilisiez values et
- output</entry>
+ output</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Un tableau associatif de valeurs et
- sorties</entry>
+ sorties</entry>
</row>
<row>
<entry>separator</entry>
@@ -75,36 +73,55 @@
<entry>Non</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>chaîne de caractère pour séparer chaque case
- à cocher</entry>
- </row>
- <row>
- <entry>assign</entry>
- <entry>chaîne de caractères</entry>
- <entry>Non</entry>
- <entry><emphasis>empty</emphasis></entry>
- <entry>Assigne les balises d'un checkbox à un tableau plutôt que de les afficher</entry>
+ à cocher</entry>
+ </row>
+ <row>
+ <entry>assign</entry>
+ <entry>chaîne de caractères</entry>
+ <entry>Non</entry>
+ <entry><emphasis>empty</emphasis></entry>
+ <entry>Assigne les balises d'un checkbox à un tableau plutôt que de les afficher</entry>
</row>
<row>
<entry>labels</entry>
<entry>booléen</entry>
<entry>Non</entry>
<entry><emphasis>true</emphasis></entry>
- <entry>ajoute la balise <label>- à la sortie</entry>
+ <entry>Ajoute la balise <label>- à la sortie</entry>
</row>
<row>
<entry>assign</entry>
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry><emphasis>empty</emphasis></entry>
- <entry>assigne la sortie à un tableau dont chaque checkbox est un élément.</entry>
+ <entry>Assigne la sortie à un tableau dont chaque checkbox est un élément.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
- <para>
- 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.
- </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ Les attributs requis sont <parameter>values</parameter> et
+ <parameter>output</parameter>, à moins que vous utilisez
+ <parameter>options</parameter> à la place.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Tous les affichages sont conformes XHTML.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Tous les paramètres qui ne sont pas dans la liste ci-dessus
+ sont affichés sous la forme de paires nom/valeur dans chaque
+ balise <input> crées.
+ </para>
+ </listitem>
+ </itemizedlist>
+
<example>
<title>{html_checkboxes}</title>
<programlisting role="php">
@@ -113,11 +130,11 @@
$smarty->assign('cust_ids', array(1000,1001,1002,1003));
$smarty->assign('cust_names', array(
- 'Joe Schmoe',
- 'Jack Smith',
- 'Jane Johnson',
- 'Charlie Brown')
- );
+'Joe Schmoe',
+'Jack Smith',
+'Jane Johnson',
+'Charlie Brown')
+);
$smarty->assign('customer_id', 1001);
?>
@@ -129,7 +146,7 @@
<programlisting>
<![CDATA[
{html_checkboxes name='id' values=$cust_ids output=$cust_names
- selected=$customer_id separator='<br />'}
+ selected=$customer_id separator='<br />'}
]]>
</programlisting>
<para>
@@ -140,11 +157,11 @@
<?php
$smarty->assign('cust_checkboxes', array(
- 1000 => 'Joe Schmoe',
- 1001 => 'Jack Smith',
- 1002 => 'Jane Johnson',
- 1003 => 'Charlie Brown')
- );
+1000 => 'Joe Schmoe',
+1001 => 'Jack Smith',
+1002 => 'Jane Johnson',
+1003 => 'Charlie Brown')
+);
$smarty->assign('customer_id', 1001);
?>
@@ -156,7 +173,7 @@
<programlisting>
<![CDATA[
{html_checkboxes name='id' options=$cust_checkboxes
- selected=$customer_id separator='<br />'}
+ selected=$customer_id separator='<br />'}
]]>
</programlisting>
<para>
@@ -189,16 +206,20 @@
?>
]]>
</programlisting>
+ <para>
+ Le résultat des requêtes de la base de données sera affiché avec :
+ </para>
<programlisting>
<![CDATA[
-{html_checkboxes name="type" options=$types selected=$contact.type_id separator="<br />"}
+{html_checkboxes name='contact_type_id' options=$contact_types
+ selected=$contact.contact_type_id separator='<br />'}
]]>
</programlisting>
</example>
<para>
Voir aussi
- <link linkend="language.function.html.radios">{html_radios}</link> et
- <link linkend="language.function.html.options">{html_options}</link>.
+ <link linkend="language.function.html.radios"><varname>{html_radios}</varname></link> et
+ <link linkend="language.function.html.options"><varname>{html_options}</varname></link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-html-image.xml?r1=1.7&r2=1.8&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-html-image.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-html-image.xml:1.7 smarty/docs/fr/designers/language-custom-functions/language-function-html-image.xml:1.8
--- smarty/docs/fr/designers/language-custom-functions/language-function-html-image.xml:1.7 Wed Mar 22 17:30:04 2006
+++ smarty/docs/fr/designers/language-custom-functions/language-function-html-image.xml Sun Oct 1 20:03:00 2006
@@ -1,11 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready -->
<sect1 id="language.function.html.image">
<title>{html_image}</title>
<para>
- {html_image} est une fonction utilisateur qui génère la balise
+ <varname>{html_image}</varname> est une
+ <link linkend="language.custom.functions">fonction utilisateur</link> 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.
</para>
@@ -52,70 +53,83 @@
<entry>chaîne de caractères</entry>
<entry>non</entry>
<entry><emphasis>racine du serveur web</emphasis></entry>
- <entry>répertoire depuis lequel baser le calcul des
+ <entry>Répertoire depuis lequel baser le calcul des
chemins relatifs</entry>
+ </row>
+ <row>
+ <entry>alt</entry>
+ <entry>chaîne de caractères</entry>
+ <entry>non</entry>
+ <entry><emphasis><quote></quote></emphasis></entry>
+ <entry>Description alternative de l'image</entry>
+ </row>
+ <row>
+ <entry>href</entry>
+ <entry>chaîne de caractères</entry>
+ <entry>non</entry>
+ <entry><emphasis>n/a</emphasis></entry>
+ <entry>valeur de l'attribut href, indiquant le lien vers l'image</entry>
</row>
<row>
- <entry>link</entry>
+ <entry>path_prefix</entry>
<entry>chaîne de caractères</entry>
<entry>non</entry>
<entry><emphasis>n/a</emphasis></entry>
- <entry>lien sur lequel l'image pointe</entry>
- </row>
- <row>
- <entry>path_prefix</entry>
- <entry>string</entry>
- <entry>no</entry>
- <entry><emphasis>n/a</emphasis></entry>
- <entry>préfixe pour le chemin de la sortie</entry>
+ <entry>Préfixe pour le chemin de la sortie</entry>
</row>
</tbody>
</tgroup>
</informaltable>
- <para>
- 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'<link linkend="language.variables.smarty">environnement</link>
- DOCUMENT_ROOT). Si <link linkend="variable.security">$security</link>
- est activé, l'image doit se situer dans un répertoire sécurisé.
- </para>
- <para>
- <parameter>href</parameter> est la valeur de l'attribut 'href' à laquelle lier l'image. Si link est défini,
- une balise <a href="LINKVALUE"><a> est placée autour de
- l'image.
- </para>
- <para>
- <parameter>path_prefix</parameter> est un préfixe optionnel que vous ouvez donné pour
- le chemin de sortie. Ceci est pratique si vous voulez fournir un nom de serveur différent
- pour l'image.
- </para>
- <para>
- Tous les paramètres qui ne sont pas listés ci-dessus seront affichés
- en tant que paires nom/valeur dans la balise <img> créée.
- </para>
+
+ <itemizedlist>
+ <listitem><para>
+ <parameter>basedir</parameter> est le dossier de base dans lequel
+ les images sont basées. S'il n'est pas fourni, la variable d'environnement
+ <varname>$_ENV['DOCUMENT_ROOT']</varname> sera utilisée.
+ Si <link linkend="variable.security"><parameter>$security</parameter></link>
+ est activé, le chemin vers l'image doit être présent dans le
+ <link linkend="variable.secure.dir">dossier de sécurité</link>.
+ </para></listitem>
+
+ <listitem><para>
+ <parameter>href</parameter> est la valeur de l'attribut href de l'image.
+ Si le lien est fourni, une balise <literal><a href="LINKVALUE"><a></literal>
+ sera placée autour de la balise de l'image.
+ </para> </listitem>
+
+ <listitem><para>
+ <parameter>path_prefix</parameter> est un préfixe optionnel que vous pouvez fournir.
+ Il est utile si vous voulez fournir un nom de serveur différent pour l'image.
+ </para></listitem>
+
+ <listitem><para>
+ Tous les paramètres qui ne sont pas dans la liste ci-dessus sont affichés
+ sous la forme d'une paire nom/valeur dans la balise
+ <literal><img></literal> créée.
+ </para></listitem>
+</itemizedlist>
+
<note>
<title>Note technique</title>
<para>
- {html_image} requiert un accès au disque dur pour lire l'image et
+ <varname>{html_image}</varname> requiert un accès au disque dur pour lire l'image et
calculer ses dimensions. Si vous n'utilisez pas un <link linkend="caching">cache</link>,
- il est généralement préférable d'éviter d'utiliser html_image
+ il est généralement préférable d'éviter d'utiliser <varname>{html_image}</varname>
et de laisser les balises images statiques pour de meilleures
performances.
</para>
</note>
<example>
- <title>html_image</title>
+ <title>Exemple avec {html_image}</title>
<programlisting>
<![CDATA[
-Où index.tpl est :
--------------------
{html_image file='pumpkin.jpg'}
{html_image file='/path/from/docroot/pumpkin.jpg'}
{html_image file='../path/relative/to/currdir/pumpkin.jpg'}
]]>
</programlisting>
<para>
- Sortie possible :
+ L'affichage possible du template ci-dessus pourrait être :
</para>
<screen>
<![CDATA[
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-html-options.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-html-options.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-html-options.xml:1.10 smarty/docs/fr/designers/language-custom-functions/language-function-html-options.xml:1.11
--- smarty/docs/fr/designers/language-custom-functions/language-function-html-options.xml:1.10 Wed Apr 19 21:01:32 2006
+++ smarty/docs/fr/designers/language-custom-functions/language-function-html-options.xml Sun Oct 1 20:03:00 2006
@@ -1,15 +1,14 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready -->
<sect1 id="language.function.html.options">
<title>{html_options}</title>
<para>
- {html_options} est une
+ <varname>{html_options}</varname> est une
<link linkend="language.custom.functions">fonction personnalisée</link>
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.
+ les éléments sélectionnés par défaut.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -32,19 +31,19 @@
<entry>values</entry>
<entry>array</entry>
<entry>Oui, à moins que vous n'utilisiez
- l'attribut options</entry>
+ l'attribut options</entry>
<entry><emphasis>n/a</emphasis></entry>
- <entry>un tableau de valeurs pour les listes
- déroulantes</entry>
+ <entry>Un tableau de valeurs pour les listes
+ déroulantes</entry>
</row>
<row>
<entry>output</entry>
<entry>array</entry>
<entry>Oui, à moins que vous n'utilisiez
- l'attribut options</entry>
+ l'attribut options</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Un tableau de libellés pour la liste
- déroulante</entry>
+ déroulante</entry>
</row>
<row>
<entry>selected</entry>
@@ -57,7 +56,7 @@
<entry>options</entry>
<entry>Tableau associatif</entry>
<entry>Oui, à moins que vous n'utilisiez option
- et values</entry>
+ et values</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Un tableau associatif valeur / libellé</entry>
</row>
@@ -71,94 +70,120 @@
</tbody>
</tgroup>
</informaltable>
- <para>
- 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.
- </para>
- <para>
- Si l'attribut optionnel <emphasis>name</emphasis> est donné, les
- balises <select name="groupname"></select> entoureront la
- liste d'options. Sinon, seule la liste <option> sera générée.
- </para>
- <para>
- Tous les paramètres qui ne sont pas dans la liste ci-dessus sont
- affichés en tant que paires nom / valeur dans la balise <select>. Ils
- sont ignorés si le paramètre optionnel <emphasis>name</emphasis>
- n'est pas donné.
- </para>
+
+ <itemizedlist>
+ <listitem><para>
+ Les attributs requis sont
+ <parameter>values</parameter> et <parameter>output</parameter>,
+ à moins que vous n'utilisiez <parameter>options</parameter> à la place.
+ </para></listitem>
+
+ <listitem><para>
+ Si l'attribut optionnel <parameter>name</parameter> est fourni, les balises
+ <literal><select></select></literal> seront créées,
+ sinon, UNIQUEMENT la liste <literal><option></literal> sera générée.
+ </para></listitem>
+
+ <listitem><para>
+ Si la valeur fournie est un tableau, il sera traité comme un
+ <literal><optgroup></literal> HTML, et affichera les groupes.
+ La récursivité est supportée avec <literal><optgroup></literal>.
+ </para></listitem>
+
+ <listitem><para>
+ Tous les paramètres qui ne sont pas dans la liste ci-dessus sont affichés
+ sous la forme de paire nom/valeur dans la balise
+ <literal><select></literal>. Ils seront ignorés si le paramètre optionnel
+ <parameter>name</parameter> n'est pas fourni.
+ </para></listitem>
+
+ <listitem><para>
+ Tous les affichages sont conformes XHTML.
+ </para></listitem>
+ </itemizedlist>
+
<example>
- <title>{html_options}</title>
- <para>
- <emphasis role="bold">Exemple 1 :</emphasis>
- </para>
+ <title>Un tableau associatif avec l'attribut <varname>options</varname></title>
<programlisting role="php">
<![CDATA[
<?php
-
-$smarty->assign('cust_ids', array(1000,1001,1002,1003));
-$smarty->assign('cust_names', array(
- 'Joe Schmoe',
- 'Jack Smith',
- 'Jane Johnson',
- 'Charlie Brown'));
-$smarty->assign('customer_id', 1001);
-
+$smarty->assign('myOptions', array(
+ 1800 => 'Joe Schmoe',
+ 9904 => 'Jack Smith',
+ 2003 => 'Charlie Brown')
+);
+$smarty->assign('mySelect', 9904);
?>
]]>
</programlisting>
<para>
- Où le template est :
+ Le template suivant génèrera une liste. Notez la présence
+ de l'attribut <parameter>name</parameter> qui crée les
+ balises <literal><select></literal>.
</para>
<programlisting>
<![CDATA[
-<select name="customer_id">
- {html_options values=$cust_ids output=$cust_names selected=$customer_id}
-</select>
+{html_options name=foo options=$myOptions selected=$mySelect}
]]>
</programlisting>
+
<para>
- <emphasis role="bold">Exemple 2 :</emphasis>
+ L'affichage de l'exemple ci-dessus sera :
</para>
- <programlisting>
+ <screen>
<![CDATA[
-<?php
-
-$smarty->assign('cust_options', array(
- 1000 => 'Joe Schmoe',
- 1001 => 'Jack Smith',
- 1002 => 'Jane Johnson',
- 1003 => 'Charlie Brown')
- );
-$smarty->assign('customer_id', 1001);
+<select name="foo">
+ <option label="Joe Schmoe" value="1800">Joe Schmoe</option>
+ <option label="Jack Smith" value="9904" selected="selected">Jack Smith</option>
+ <option label="Charlie Brown" value="2003">Charlie Brown</option>
+</select>
+]]>
+ </screen>
+ </example>
+ <example>
+ <title>Tableaux séparés pour <varname>values</varname> et
+ <varname>ouptut</varname></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$smarty->assign('cust_ids', array(56,92,13));
+$smarty->assign('cust_names', array(
+ 'Joe Schmoe',
+ 'Jane Johnson',
+ 'Charlie Brown'));
+$smarty->assign('customer_id', 92);
?>
]]>
</programlisting>
<para>
- Où le template est :
+ Les tableaux ci-dessus seront affichés avec le template suivant
+ (notez l'utilisation de la fonction PHP <ulink url="&url.php-manual;function.count">
+ <varname>count()</varname></ulink> en tant que modificateur pour
+ définir la taille du select).
</para>
<programlisting>
<![CDATA[
- {html_options name=customer_id options=$cust_options selected=$customer_id}
+<select name="customer_id" size="{$cust_names|@count}">
+ {html_options values=$cust_ids output=$cust_names selected=$customer_id}
+</select>
]]>
</programlisting>
<para>
- Les deux exemples afficheront :
+ L'exemple ci-dessous affichera :
</para>
<screen>
<![CDATA[
<select name="customer_id">
- <option label="Joe Schmoe" value="1000">Joe Schmoe</option>
- <option label="Jack Smith" value="1001" selected="selected">Jack Smith</option>
- <option label="Jane Johnson" value="1002">Jane Johnson</option>
- <option label="Charlie Brown" value="1003">Charlie Brown</option>
+ <option label="Joe Schmoe" value="56">Joe Schmoe</option>
+ <option label="Jack Smith" value="92" selected="selected">Jane Johnson</option>
+ <option label="Charlie Brown" value="13">Charlie Brown</option>
</select>
]]>
</screen>
</example>
<example>
- <title>{html_options} - Exemple avec une base de données (eg PEAR ou ADODB):</title>
+ <title>Exemple avec une base de données (e.g. ADODB ou PEAR)</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -167,30 +192,72 @@
$smarty->assign('contact_types',$db->getAssoc($sql));
$sql = 'select contact_id, name, email, contact_type_id
- from contacts where contact_id='.$contact_id;
+from contacts where contact_id='.$contact_id;
$smarty->assign('contact',$db->getRow($sql));
?>
]]>
</programlisting>
<para>
- où le template est :
+ Où le template pourrait être celui-ci. Notez l'utilisation du modificateur
+ <link linkend="language.modifier.truncate"><varname>truncate</varname></link>.
</para>
<programlisting>
<![CDATA[
<select name="type_id">
<option value='null'>-- none --</option>
- {html_options options=$contact_types selected=$contact.type_id}
+ {html_options options=$contact_types|truncate:20 selected=$contact.type_id}
</select>
]]>
</programlisting>
</example>
- <para>
- Voir aussi
- <link linkend="language.function.html.checkboxes">{html_checkboxes}</link> et
- <link linkend="language.function.html.radios">{html_radios}</link>.
- </para>
-</sect1>
+
+ <example>
+ <title>Exemple avec <optgroup> </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$arr['Sport'] = array(6 => 'Golf', 9 => 'Cricket',7 => 'Swim');
+$arr['Rest'] = array(3 => 'Sauna',1 => 'Massage');
+$smarty->assign('lookups', $arr);
+$smarty->assign('fav', 7);
+?>
+]]>
+ </programlisting>
+ <para>Le script ci-dessus et le template suivant
+ </para>
+ <programlisting>
+<![CDATA[
+{html_options name=foo options=$myOptions selected=$mySelect}
+]]>
+ </programlisting>
+
+ <para>
+ affichera :
+ </para>
+ <screen>
+<![CDATA[
+<select name="breakTime">
+ <optgroup label="Sport">
+ <option label="Golf" value="6">Golf</option>
+ <option label="Cricket" value="9">Cricket</option>
+ <option label="Swim" value="7" selected="selected">Swim</option>
+ </optgroup>
+ <optgroup label="Rest">
+ <option label="Sauna" value="3">Sauna</option>
+ <option label="Massage" value="1">Massage</option>
+ </optgroup>
+</select>
+]]>
+ </screen>
+ </example>
+ <para>
+ Voir aussi
+ <link linkend="language.function.html.checkboxes"><varname>{html_checkboxes}</varname></link>
+ et
+ <link linkend="language.function.html.radios"><varname>{html_radios}</varname></link>
+ </para>
+ </sect1>
<!-- Keep this comment at the end of the file
Local variables:
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-html-radios.xml?r1=1.11&r2=1.12&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-html-radios.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-html-radios.xml:1.11 smarty/docs/fr/designers/language-custom-functions/language-function-html-radios.xml:1.12
--- smarty/docs/fr/designers/language-custom-functions/language-function-html-radios.xml:1.11 Mon May 22 08:46:06 2006
+++ smarty/docs/fr/designers/language-custom-functions/language-function-html-radios.xml Sun Oct 1 20:03:00 2006
@@ -1,16 +1,14 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
-<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.12 $ -->
+<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready -->
<sect1 id="language.function.html.radios">
<title>{html_radios}</title>
<para>
- {html_radio} est une
+ <varname>{html_radios}</varname> est une
<link linkend="language.custom.functions">fonction personnalisée</link>
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
- conforme au XHTML.
+ charge les éléments sélectionnés par défaut.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -34,7 +32,7 @@
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry><emphasis>radio</emphasis></entry>
- <entry>nom de la liste boutons radio</entry>
+ <entry>Nom de la liste boutons radio</entry>
</row>
<row>
<entry>values</entry>
@@ -65,14 +63,14 @@
<entry>Oui, à moins que vous n'utilisiez values
et outputs</entry>
<entry><emphasis>n/a</emphasis></entry>
- <entry>un tableau associatif valeurs / libellés</entry>
+ <entry>Un tableau associatif valeurs / libellés</entry>
</row>
<row>
<entry>separator</entry>
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry><emphasis>empty</emphasis></entry>
- <entry>chaîne de séparation à placer entre les
+ <entry>Chaîne de séparation à placer entre les
boutons radio</entry>
</row>
<row>
@@ -85,14 +83,27 @@
</tbody>
</tgroup>
</informaltable>
- <para>
- 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.
- </para>
+
+ <itemizedlist>
+ <listitem><para>
+ Les attributs requis sont <parameter>values</parameter> et
+ <parameter>output</parameter>, à moins que vous n'utilisez
+ <parameter>options</parameter> à la place.
+ </para></listitem>
+
+ <listitem><para>
+ Tous les affichages sont conformes XHTML.
+ </para></listitem>
+
+ <listitem><para>
+ Tous les paramètres qui ne sont pas dans la liste ci-dessus sont
+ affichés sous la forme de paire nom/valeur dans la balise
+ <literal><input></literal> créées.
+ </para></listitem>
+ </itemizedlist>
<example>
- <title>{html_radios} : Exemple 1</title>
+ <title>{html_radios} : Première exemple</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -121,7 +132,7 @@
</programlisting>
</example>
<example>
- <title>{html_radios} : Exemple 2</title>
+ <title>{html_radios} : Deuxième exemple</title>
<programlisting>
<![CDATA[
<?php
@@ -175,19 +186,20 @@
]]>
</programlisting>
<para>
- et le template :
+ La variable assignée depuis la base de données ci-dessus sera affichée
+ avec le template :
</para>
<programlisting>
<![CDATA[
-{html_radios name='contact_type_id' options=$types
- selected=$contact.contact_type_id separator='<br />'}
+{html_radios name='contact_type_id' options=$contact_types
+ selected=$contact.contact_type_id separator='<br />'}
]]>
</programlisting>
</example>
<para>
Voir aussi
- <link linkend="language.function.html.checkboxes">{html_checkboxes}</link> et
- <link linkend="language.function.html.options">{html_options}</link>.
+ <link linkend="language.function.html.checkboxes"><varname>{html_checkboxes}</varname></link> et
+ <link linkend="language.function.html.options"><varname>{html_options}</varname></link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml?r1=1.9&r2=1.10&diff_format=u
Index: smarty/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml
diff -u smarty/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml:1.9 smarty/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml:1.10
--- smarty/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml:1.9 Wed Dec 14 22:09:58 2005
+++ smarty/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml Sun Oct 1 20:03:00 2006
@@ -1,14 +1,17 @@
<?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.12 Maintainer: yannick Status: ready -->
<sect1 id="language.function.html.select.date">
<title>{html_select_date}</title>
<para>
- {html_select_date} est une
+ <varname>{html_select_date}</varname> est une
<link linkend="language.custom.functions">fonction personnalisée</link>
qui crée des listes déroulantes pour saisir la date. Elle peut afficher n'importe
quel jour, mois et année.
+ Tous les paramètres qui ne sont pas dans la liste ci-dessous sont
+ affichés sous la forme pair nom/valeur dans les balises
+ <literal><select></literal> des jours, mois et années.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -40,7 +43,7 @@
<entry>Non</entry>
<entry>la date courante au format unix YYYY-MM-DD
format</entry>
- <entry>la date / heure à utiliser</entry>
+ <entry>La date / heure à utiliser</entry>
</row>
<row>
<entry>start_year</entry>
@@ -100,7 +103,7 @@
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry>%d</entry>
- <entry>le format de la valeur du jour (sprintf)</entry>
+ <entry>Le format de la valeur du jour (sprintf)</entry>
</row>
<row>
<entry>year_as_text</entry>
@@ -214,10 +217,10 @@
<entry>Non</entry>
<entry>null</entry>
<entry>S'il est renseigné, alors le premier élément de la boite de sélection
- affiche le texte donné en tant que libellé et dispose de la valeur "".
+ affiche le texte donné en tant que libellé et dispose de la valeur <quote></quote>.
Utile par exemple lorsque vous souhaitez que la boite de sélection affiche
- "Sélectionnez une année".
- A savoir que vous pouvez spécifier des valeurs de la forme "-MM-JJ" pour
+ <quote>Sélectionnez une année</quote>.
+ A savoir que vous pouvez spécifier des valeurs de la forme <quote>-MM-DD</quote> pour
l'attribut time afin d'indiquer une année non sélectionnée.</entry>
</row>
<row>
@@ -226,9 +229,9 @@
<entry>Non</entry>
<entry>null</entry>
<entry>S'il est renseigné, le premier élément de la boite de sélection
- affiche le texte donné en tant que libellé et dispose de la valeur "".
- A savoir que vous pouvez spécifier des valeurs de la forme "AAAA--JJ" pour
- l'attribut time afin d'indiquer qu'il manque le moi.</entry>
+ affiche le texte donné en tant que libellé et dispose de la valeur <quote></quote>.
+ A savoir que vous pouvez spécifier des valeurs de la forme <quote>YYYY--DD</quote> pour
+ l'attribut time afin d'indiquer qu'il manque le moi.</entry>
</row>
<row>
<entry>day_empty</entry>
@@ -236,21 +239,25 @@
<entry>Non</entry>
<entry>null</entry>
<entry>S'il est renseigné, le premier élément de la boite de sélection
- affiche le texte donné en tant que libellé et dispose de la valeur "".
- A savoir que vous pouvez spécifier des valeurs de la forme "AAAA-MM-" pour
+ affiche le texte donné en tant que libellé et dispose de la valeur <quote></quote>.
+ A savoir que vous pouvez spécifier des valeurs de la forme <quote>YYYY-MM-</quote> pour
l'attribut time afin d'indiquer qu'il manque le jour.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
- <para>
- Tous les paramètres non présents dans la liste ci-dessus sont affichés
- en tant que paires nom/valeur dans la balise <select> du jour, mois
- et année.
- </para>
+
+ <note>
+ <para>
+ Il y a une fonction PHP utile sur la
+ <link linkend="tips.dates">page des astuces sur les dates</link> pour convertir
+ les valeurs <varname>{html_select_date}</varname> en un timestamp.
+ </para>
+ </note>
+
<example>
- <title>{html_select_date}</title>
+ <title>{html_select_date} : Premier exemple</title>
<para>Code du template</para>
<programlisting>
<![CDATA[
@@ -287,14 +294,14 @@
<option value="31">31</option>
</select>
<select name="Date_Year">
- <option value="2001" selected="selected">2001</option>
+ <option value="2006" selected="selected">2006</option>
</select>
]]>
</screen>
</example>
<example>
- <title>{html_select_date}</title>
+ <title>{html_select_date} : Deuxième exemple</title>
<programlisting>
<![CDATA[
{* le démarage et la fin de l'année peuvent être relatif à l'année courante *}
@@ -310,22 +317,13 @@
<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>
+ ..... coupé .....
<option value="11">November</option>
<option value="12" selected="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="1995">1995</option>
+ ..... coupé .....
<option value="1999">1999</option>
<option value="2000" selected="selected">2000</option>
<option value="2001">2001</option>
@@ -335,9 +333,9 @@
</example>
<para>
Voir aussi
- <link linkend="language.function.html.select.time">{html_select_time}</link>,
- <link linkend="language.modifier.date.format">date_format</link>,
- <link linkend="language.variables.smarty.now">$smarty.now</link> et
+ <link linkend="language.function.html.select.time"><varname>{html_select_time}</varname></link>,
+ <link linkend="language.modifier.date.format"><varname>date_format</varname></link>,
+ <link linkend="language.variables.smarty.now"><parameter>$smarty.now</parameter></link> et
les <link linkend="tips.dates">astuces sur les dates</link>.
</para>
</sect1>