smarty-php/smarty
1
0
Fork 0
mirror of https://github.com/smarty-php/smarty.git synced 2025-08-06 03:14:27 +02:00
Code Issues Packages Projects Releases Wiki Activity

sync with EN

Browse Source
This commit is contained in:
yannick
2006-10-01 20:03:00 +00:00
parent 7e4778f53c
commit 11278302ba
11 changed files with 482 additions and 333 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
docs/fr/designers/language-custom-functions/language-function-assign.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready -->
<sect1 id="language.function.assign">
<title>{assign}</title>
<para>
{assign} est utilis<69> pour d<>clarer des variables de template
<varname>{assign}</varname> est utilis<69> pour d<>clarer des variables de template
<emphasis role="bold">durant l'ex<65>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 @@ La valeur de $name est Bob.
</example>
<example>
<title>Acc<EFBFBD>s aux variables {assign} depuis un script PHP.</title>
<title>Acc<EFBFBD>s aux variables {assign} depuis un script PHP</title>
<para>
Pour acc<63>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<70>s ou pendant l'ex<65>cution du
template, comme le montre l'exemple suivant :
Pour acc<63>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<63>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<70>s/durant l'ex<65>cution du template,
comme dans le script ci-dessous.
</para>
<programlisting role="php">
<![CDATA[
<?php
@@ -92,8 +94,8 @@ La valeur de $name est Bob.
// ceci n'affichera rien car le template n'a pas encore <20>t<EFBFBD> ex<65>cut<75>
echo $smarty->get_template_vars('foo');
// Ex<EFBFBD>cution du template
$dead = $smarty->fetch('index.tpl');
// R<EFBFBD>cup<EFBFBD>re le template dans une variable
$whole_page = $smarty->fetch('index.tpl');
// Ceci affichera 'smarty' car le template a <20>t<EFBFBD> ex<65>cut<75>
echo $smarty->get_template_vars('foo');
@@ -115,21 +117,21 @@ echo $smarty->get_template_vars('foo');
</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>

17
docs/fr/designers/language-custom-functions/language-function-counter.xml
View File

@@ -1,21 +1,22 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
<!-- 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 <20> chaque it<69>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<61>ment en
leur donnant des noms uniques. Si vous ne donnez pas de nom <20> un
compteur, 'default' sera utilis<69>.
compteur, <quote>default</quote> sera utilis<69>.
</para>
<para>
Si vous donnez une valeur <20> l'attribut "assign", alors la sortie de la
fonction counter sera assign<67>e <20> la variable de template donn<6E>e plut<75>t
que d'<27>tre directement affich<63>e.
Si vous donnez une valeur <20> l'attribut <parameter>assign</parameter>,
alors la sortie de la fonction <varname>{counter}</varname> sera assign<67>e
<EFBFBD> la variable de template donn<6E>e plut<75>t que d'<27>tre directement affich<63>e.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -66,7 +67,7 @@
<entry>print</entry>
<entry>bool<EFBFBD>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 *}

51
docs/fr/designers/language-custom-functions/language-function-cycle.xml
View File

@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
<sect1 id="language.function.cycle">
<title>{cycle}</title>
<para>
{cycle} est utilis<69> pour boucler sur un ensemble de valeurs. Tr<54>s pratique
pour alterner entre deux ou plusieurs couleurs dans un tableau,
<varname>{cycle}</varname> est utilis<69> pour boucler sur un ensemble de valeurs.
Tr<EFBFBD>s pratique pour alterner entre deux ou plusieurs couleurs dans un tableau,
ou plus g<>n<EFBFBD>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<61>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<EFBFBD>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<EFBFBD>en</entry>
<entry>Non</entry>
<entry><emphasis>true</emphasis></entry>
<entry><emphasis>&true;</emphasis></entry>
<entry>Oui ou non aller <20> la procha<68>ne valeur</entry>
</row>
<row>
@@ -75,29 +75,33 @@
<entry>reset</entry>
<entry>bool<EFBFBD>en</entry>
<entry>Non</entry>
<entry><emphasis>false</emphasis></entry>
<entry><emphasis>&false;</emphasis></entry>
<entry>Le cycle sera d<>fini <20> la premi<6D>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<6D>cher la valeur courante de s'afficher en d<>finissant
l'attribut print <20> false. Ce proc<6F>d<EFBFBD> peut <20>tre utile pour discr<63>tement
passer outre une valeur de la liste.
</para>
<para>
L'attribut advance est utilis<69> pour r<>p<EFBFBD>ter une valeur. Lorsque
d<>finit <20> false, le prochain appel de {cycle} ram<61>nera la m<>me valeur.
</para>
<para>
Si vous d<>finissez l'attribut sp<73>cial "assign", la sortie de la fonction
cycle y sera assign<67>e plut<75>t que d'<27>tre directement affich<63>e.
</para>
l'attribut <parameter>print</parameter> <20> &false;. Ce proc<6F>d<EFBFBD> peut <20>tre
utile pour discr<63>tement passer outre une valeur de la liste.
</para></listitem>
<listitem><para>
L'attribut <parameter>advance</parameter> est utilis<69> pour r<>p<EFBFBD>ter une valeur. Lorsque
d<>finit <20> &false;, le prochain appel de <varname>{cycle}</varname> ram<61>nera la m<>me valeur.
</para></listitem>
<listitem><para>
Si vous d<>finissez l'attribut sp<73>cial <parameter>assign</parameter>, la sortie de la fonction
<varname>{cycle}</varname> y sera assign<67>e plut<75>t que d'<27>tre directement affich<63>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">

20
docs/fr/designers/language-custom-functions/language-function-debug.xml
View File

@@ -1,9 +1,18 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
<sect1 id="language.function.debug">
<title>{debug}</title>
<para>
<varname>{debug}</varname> am<61>ne la console de d<>bogage sur la page.
Fonctionne quelle que soit la valeur du param<61>tre
<link linkend="chapter.debugging.console">debug</link> de Smarty.
Comme ce dernier est appel<65> lors de l'ex<65>cution, il n'est capable
d'afficher que les variables <link linkend="api.assign">assign<EFBFBD>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" />
@@ -31,15 +40,6 @@
</tbody>
</tgroup>
</informaltable>
<para>
{debug} am<61>ne la console de d<>bogage sur la page. Fonctionne
quelle que soit la valeur du param<61>tre <link
linkend="chapter.debugging.console">debug</link> de Smarty.
Comme ce dernier est appel<65> lors de l'ex<65>cution, il n'est capable
d'afficher que les variables <link linkend="api.assign">assign<EFBFBD>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>.

29
docs/fr/designers/language-custom-functions/language-function-eval.xml
View File

@@ -1,17 +1,18 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
<sect1 id="language.function.eval">
<title>{eval}</title>
<para>
{eval} <20>value une variable comme si cette derni<6E>re <20>tait un template.
<varname>{eval}</varname> <20>value une variable comme si cette derni<6E>re
<20>tait un template.
Peut <20>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<67>e <20> la
Si vous d<>finissez l'attribut <parameter>assign</parameter>, la sortie sera assign<67>e <20> la
variable de template d<>sign<67>e plut<75>t que d'<27>tre affich<63>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<68>ne de caract<63>res) <20> <20>valuer</entry>
<entry>Variable (ou cha<68>ne de caract<63>res) <20> <20>valuer</entry>
</row>
<row>
<entry>assign</entry>
@@ -53,22 +54,25 @@
<note>
<title>Note technique</title>
<para>
<itemizedlist>
<listitem><para>
Les variables <20>valu<6C>es sont trait<69>es de la m<>me fa<66>on que les templates.
Elles suivent les m<>mes r<>gles de traitement et de s<>curit<69>, comme si
elles <20>taient r<>ellement des templates.
</para>
</note>
<note>
<title>Note technique</title>
<para>
</para></listitem>
<listitem><para>
Les variables <20>valu<6C>es sont compil<69>es <20> chaque invocation, et la version
compil<69>e n'est pas sauvegard<72>e ! Toutefois, si le
<link linkend="caching">cache</link> est activ<69>, la sortie sera plac<61>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 @@ Vous devez sp
<title>un autre exemple avec {eval}</title>
<para>
Ceci va afficher le nom du serveur (en majuscule) et son IP.
La variable $str <20>galement venir d'une requ<71>te de base de donn<6E>es.
La variable <parameter>$str</parameter> <20>galement venir d'une requ<71>te de base de donn<6E>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>

90
docs/fr/designers/language-custom-functions/language-function-fetch.xml
View File

@@ -1,23 +1,61 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready -->
<sect1 id="language.function.fetch">
<title>{fetch}</title>
<para>
{fetch} est utilis<69> pour r<>cup<75>rer des fichiers depuis le syst<73>me de
<varname>{fetch}</varname> est utilis<69> pour r<>cup<75>rer des fichiers depuis le syst<73>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<75>r<EFBFBD>e, puis affich<63>e. Si le nom du fichier commence par "ftp://",
le fichier sera r<>cup<75>r<EFBFBD> depuis le serveur ftp, et affich<63>.
Pour les fichiers du syst<73>me local, le chemin doit <20>tre absolu ou
relatif au chemin d'ex<65>cution du script PHP.
</para>
<para>
Vous pouvez sp<73>cifier l'attribut optionnel "assign"
qui d<>fini une variable de template dans laquelle la sortie
sera stock<63>e plut<75>t que d'<27>tre affich<63>e.
</para>
<itemizedlist>
<listitem>
<para>
Si le nom du fichier commence par <parameter>http://</parameter>, la page internet sera
r<>cup<75>r<EFBFBD>e, puis affich<63>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<75>r<EFBFBD> depuis le serveur ftp, et affich<63>.
</para>
</listitem>
<listitem>
<para>
Pour les fichiers du syst<73>me local, le chemin doit <20>tre absolu ou
relatif au chemin d'ex<65>cution du script PHP.
<note>
<para>
Si la variable de template <link linkend="variable.security">
<parameter>$security</parameter></link>
est activ<69>e et que vous r<>cup<75>rez un fichier depuis le syst<73>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<69>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<67>e <20> cette
variable de template au lieu d'<27>tre affich<63>e dans le template.
</para>
</listitem>
</itemizedlist>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -40,34 +78,20 @@
<entry>cha<EFBFBD>ne de caract<63>res</entry>
<entry>Oui</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>le fichier, site http ou ftp <20> r<>cup<75>rer</entry>
<entry>Le fichier, site http ou ftp <20> r<>cup<75>rer</entry>
</row>
<row>
<entry>assign</entry>
<entry>cha<EFBFBD>ne de caract<63>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<67>e plut<75>t que d'<27>tre directement affich<63>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<EFBFBD>curit<EFBFBD></link> est activ<69>e,
vous ne pourez r<>cup<75>rer les fichiers du syst<73>me local que s'ils sont
situ<74>s dans l'un des <link linkend="variable.secure.dir">r<EFBFBD>pertoires s<>curis<69></link>.
</para>
</note>
<example>
<title>Exempe avec {fetch}</title>
<programlisting>
@@ -86,17 +110,17 @@
{* assigne le contenu r<>cup<75>r<EFBFBD> <20> 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>

111
docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml
View File

@@ -1,16 +1,14 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready -->
<!-- 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<63>e un groupe de cases <20> cocher avec les donn<6E>es fournies. Elle prend
en compte la liste des <20>l<EFBFBD>ments s<>lectionn<6E>s par d<>faut. Les attributs requis
sont values et output, <20> moins que vous n'utilisiez options <20> la place.
La sortie g<>n<EFBFBD>r<EFBFBD>e est conforme au XHTML.
en compte la liste des <20>l<EFBFBD>ments s<>lectionn<6E>s par d<>faut.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -40,16 +38,16 @@
<entry>values</entry>
<entry>array</entry>
<entry>Oui, <20> 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 <20>
cocher</entry>
cocher</entry>
</row>
<row>
<entry>output</entry>
<entry>array</entry>
<entry>Oui, <20> 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 <20> cocher</entry>
</row>
@@ -64,10 +62,10 @@
<entry>options</entry>
<entry>Tableau associatif</entry>
<entry>Oui, <20> 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<EFBFBD>ne de caract<63>re pour s<>parer chaque case
<20> cocher</entry>
</row>
<row>
<entry>assign</entry>
<entry>cha<EFBFBD>ne de caract<63>res</entry>
<entry>Non</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>Assigne les balises d'un checkbox <20> un tableau plut<75>t que de les afficher</entry>
</row>
<row>
<entry>labels</entry>
<entry>bool<EFBFBD>en</entry>
<entry>Non</entry>
<entry><emphasis>true</emphasis></entry>
<entry>ajoute la balise &lt;label&gt;- <20> la sortie</entry>
<EFBFBD> cocher</entry>
</row>
<row>
<entry>assign</entry>
<entry>cha<EFBFBD>ne de caract<63>res</entry>
<entry>Non</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>assigne la sortie <20> un tableau dont chaque checkbox est un <20>l<EFBFBD>ment.</entry>
<entry>Assigne les balises d'un checkbox <20> un tableau plut<75>t que de les afficher</entry>
</row>
<row>
<entry>labels</entry>
<entry>bool<EFBFBD>en</entry>
<entry>Non</entry>
<entry><emphasis>true</emphasis></entry>
<entry>Ajoute la balise &lt;label&gt;- <20> la sortie</entry>
</row>
<row>
<entry>assign</entry>
<entry>cha<EFBFBD>ne de caract<63>res</entry>
<entry>Non</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>Assigne la sortie <20> un tableau dont chaque checkbox est un <20>l<EFBFBD>ment.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
Tous les param<61>tres qui ne sont pas list<73>s ci-dessus sont affich<63>s
en tant que paires nom/valeur dans chaque balise &lt;input&gt; cr<63>e.
</para>
<itemizedlist>
<listitem>
<para>
Les attributs requis sont <parameter>values</parameter> et
<parameter>output</parameter>, <20> moins que vous utilisez
<parameter>options</parameter> <20> la place.
</para>
</listitem>
<listitem>
<para>
Tous les affichages sont conformes XHTML.
</para>
</listitem>
<listitem>
<para>
Tous les param<61>tres qui ne sont pas dans la liste ci-dessus
sont affich<63>s sous la forme de paires nom/valeur dans chaque
balise &lt;input&gt; cr<63>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 @@ $smarty->assign('customer_id', 1001);
<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 @@ $smarty->assign('customer_id', 1001);
<?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 @@ $smarty->assign('customer_id', 1001);
<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 @@ $smarty->assign('contact',$db->getRow($sql));
?>
]]>
</programlisting>
<para>
Le r<>sultat des requ<71>tes de la base de donn<6E>es sera affich<63> 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>

94
docs/fr/designers/language-custom-functions/language-function-html-image.xml
View File

@@ -1,11 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
<!-- 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<EFBFBD>re la balise
<varname>{html_image}</varname> est une
<link linkend="language.custom.functions">fonction utilisateur</link> qui g<>n<EFBFBD>re la balise
HTML pour une image. La hauteur et la longueur de l'image sont calcul<75>s
automatiquement depuis le fichier image si aucune n'est sp<73>cifi<66>e.
</para>
@@ -52,70 +53,83 @@
<entry>cha<EFBFBD>ne de caract<63>res</entry>
<entry>non</entry>
<entry><emphasis>racine du serveur web</emphasis></entry>
<entry>r<EFBFBD>pertoire depuis lequel baser le calcul des
<entry>R<EFBFBD>pertoire depuis lequel baser le calcul des
chemins relatifs</entry>
</row>
<row>
<entry>link</entry>
<entry>cha<EFBFBD>ne de caract<63>res</entry>
<entry>non</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>lien sur lequel l'image pointe</entry>
</row>
<row>
<entry>alt</entry>
<entry>cha<EFBFBD>ne de caract<63>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<EFBFBD>ne de caract<63>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>path_prefix</entry>
<entry>string</entry>
<entry>no</entry>
<entry>cha<EFBFBD>ne de caract<63>res</entry>
<entry>non</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>pr<EFBFBD>fixe pour le chemin de la sortie</entry>
<entry>Pr<EFBFBD>fixe pour le chemin de la sortie</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
basedir est le r<>pertoire de base depuis lequel seront calcul<75>s les
chemins relatifs. Si non sp<73>cifi<66>, la racine du serveur web est utilis<69>
(variable d'<link linkend="language.variables.smarty">environnement</link>
DOCUMENT_ROOT). Si <link linkend="variable.security">$security</link>
est activ<69>, l'image doit se situer dans un r<>pertoire s<>curis<EFBFBD>.
</para>
<para>
<parameter>href</parameter> est la valeur de l'attribut 'href' <20> laquelle lier l'image. Si link est d<>fini,
une balise &lt;a href="LINKVALUE"&gt;&lt;a&gt; est plac<61>e autour de
l'image.
</para>
<para>
<parameter>path_prefix</parameter> est un pr<70>fixe optionnel que vous ouvez donn<6E> pour
le chemin de sortie. Ceci est pratique si vous voulez fournir un nom de serveur diff<66>rent
pour l'image.
</para>
<para>
Tous les param<61>tres qui ne sont pas list<73>s ci-dessus seront affich<63>s
en tant que paires nom/valeur dans la balise &lt;img&gt; cr<63><72>e.
</para>
<itemizedlist>
<listitem><para>
<parameter>basedir</parameter> est le dossier de base dans lequel
les images sont bas<61>es. S'il n'est pas fourni, la variable d'environnement
<varname>$_ENV['DOCUMENT_ROOT']</varname> sera utilis<EFBFBD>e.
Si <link linkend="variable.security"><parameter>$security</parameter></link>
est activ<69>, le chemin vers l'image doit <20>tre pr<70>sent dans le
<link linkend="variable.secure.dir">dossier de s<>curit<69></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>&lt;a href="LINKVALUE"&gt;&lt;a&gt;</literal>
sera plac<61>e autour de la balise de l'image.
</para> </listitem>
<listitem><para>
<parameter>path_prefix</parameter> est un pr<70>fixe optionnel que vous pouvez fournir.
Il est utile si vous voulez fournir un nom de serveur diff<66>rent pour l'image.
</para></listitem>
<listitem><para>
Tous les param<61>tres qui ne sont pas dans la liste ci-dessus sont affich<63>s
sous la forme d'une paire nom/valeur dans la balise
<literal>&lt;img&gt;</literal> cr<63><72>e.
</para></listitem>
</itemizedlist>
<note>
<title>Note technique</title>
<para>
{html_image} requiert un acc<63>s au disque dur pour lire l'image et
<varname>{html_image}</varname> requiert un acc<63>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<EFBFBD>ralement pr<70>f<EFBFBD>rable d'<27>viter d'utiliser html_image
il est g<>n<EFBFBD>ralement pr<70>f<EFBFBD>rable d'<27>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<EFBFBD> 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 <20>tre :
</para>
<screen>
<![CDATA[

233
docs/fr/designers/language-custom-functions/language-function-html-options.xml
View File

@@ -1,15 +1,14 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready -->
<!-- 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<69>e</link>
qui cr<63>e un groupe d'options avec les donn<6E>es fournies. Elle prend en charge
les <20>l<EFBFBD>ments s<>lectionn<6E>s par d<>faut. Les attributs requis sont values et output,
<20> moins que vous n'utilisiez options <20> la place.
les <20>l<EFBFBD>ments s<>lectionn<6E>s par d<>faut.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -32,19 +31,19 @@
<entry>values</entry>
<entry>array</entry>
<entry>Oui, <20> 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<EFBFBD>roulantes</entry>
</row>
<row>
<entry>output</entry>
<entry>array</entry>
<entry>Oui, <20> moins que vous n'utilisiez
l'attribut options</entry>
l'attribut options</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Un tableau de libell<6C>s pour la liste
d<>roulante</entry>
d<EFBFBD>roulante</entry>
</row>
<row>
<entry>selected</entry>
@@ -57,7 +56,7 @@
<entry>options</entry>
<entry>Tableau associatif</entry>
<entry>Oui, <20> moins que vous n'utilisiez option
et values</entry>
et values</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Un tableau associatif valeur / libell<6C></entry>
</row>
@@ -71,94 +70,120 @@
</tbody>
</tgroup>
</informaltable>
<para>
Si la valeur donn<6E>e est un tableau, elle sera trait<69>e comme un
&lt;optgroup&gt; html, et affich<63>e. La r<>cursivit<69> est support<72>e avec
&lt;optgroup&gt;. La sortie est compatible XHTML.
</para>
<para>
Si l'attribut optionnel <emphasis>name</emphasis> est donn<6E>, les
balises &lt;select name="groupname"&gt;&lt;/select&gt; entoureront la
liste d'options. Sinon, seule la liste &lt;option&gt; sera g<>n<EFBFBD>r<EFBFBD>e.
</para>
<para>
Tous les param<61>tres qui ne sont pas dans la liste ci-dessus sont
affich<EFBFBD>s en tant que paires nom / valeur dans la balise &lt;select&gt;. Ils
sont ignor<6F>s si le param<61>tre optionnel <emphasis>name</emphasis>
n'est pas donn<6E>.
</para>
<itemizedlist>
<listitem><para>
Les attributs requis sont
<parameter>values</parameter> et <parameter>output</parameter>,
<20> moins que vous n'utilisiez <parameter>options</parameter> <20> la place.
</para></listitem>
<listitem><para>
Si l'attribut optionnel <parameter>name</parameter> est fourni, les balises
<literal>&lt;select&gt;&lt;/select&gt;</literal> seront cr<63><72>es,
sinon, UNIQUEMENT la liste <literal>&lt;option&gt;</literal> sera g<>n<EFBFBD>r<EFBFBD>e.
</para></listitem>
<listitem><para>
Si la valeur fournie est un tableau, il sera trait<69> comme un
<literal>&lt;optgroup&gt;</literal> HTML, et affichera les groupes.
La r<>cursivit<69> est support<72>e avec <literal>&lt;optgroup&gt;</literal>.
</para></listitem>
<listitem><para>
Tous les param<61>tres qui ne sont pas dans la liste ci-dessus sont affich<63>s
sous la forme de paire nom/valeur dans la balise
<literal>&lt;select&gt;</literal>. Ils seront ignor<6F>s si le param<61>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<EFBFBD> le template est :
Le template suivant g<>n<EFBFBD>rera une liste. Notez la pr<70>sence
de l'attribut <parameter>name</parameter> qui cr<63>e les
balises <literal>&lt;select&gt;</literal>.
</para>
<programlisting>
<![CDATA[
<select name="customer_id">
{html_options values=$cust_ids output=$cust_names selected=$customer_id}
{html_options name=foo options=$myOptions selected=$mySelect}
]]>
</programlisting>
<para>
L'affichage de l'exemple ci-dessus sera :
</para>
<screen>
<![CDATA[
<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<61>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>
Les tableaux ci-dessus seront affich<63>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[
<select name="customer_id" size="{$cust_names|@count}">
{html_options values=$cust_ids output=$cust_names selected=$customer_id}
</select>
]]>
</programlisting>
<para>
<emphasis role="bold">Exemple 2 :</emphasis>
</para>
<programlisting>
<![CDATA[
<?php
$smarty->assign('cust_options', array(
1000 => 'Joe Schmoe',
1001 => 'Jack Smith',
1002 => 'Jane Johnson',
1003 => 'Charlie Brown')
);
$smarty->assign('customer_id', 1001);
?>
]]>
</programlisting>
<para>
O<> le template est :
</para>
<programlisting>
<![CDATA[
{html_options name=customer_id options=$cust_options selected=$customer_id}
]]>
</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<6E>es (eg PEAR ou ADODB):</title>
<title>Exemple avec une base de donn<6E>es (e.g. ADODB ou PEAR)</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -167,30 +192,72 @@ $sql = 'select type_id, types from contact_types order by type';
$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<EFBFBD> le template est :
O<EFBFBD> le template pourrait <20>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 &lt;optgroup&gt; </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:

52
docs/fr/designers/language-custom-functions/language-function-html-radios.xml
View File

@@ -1,16 +1,14 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready -->
<!-- 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<69>e</link>
qui cr<63>e des boutons radio html <20> partir des donn<6E>es fournies. Elle prend en
charge les <20>l<EFBFBD>ments s<>lectionn<6E>s par d<>faut. Les attributs requis sont values
et output, <20> moins que vous n'utilisiez options <20> la place. La sortie g<>n<EFBFBD>r<EFBFBD>e est
conforme au XHTML.
charge les <20>l<EFBFBD>ments s<>lectionn<6E>s par d<>faut.
</para>
<informaltable frame="all">
<tgroup cols="5">
@@ -34,7 +32,7 @@
<entry>cha<EFBFBD>ne de caract<63>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, <20> moins que vous n'utilisiez values
et outputs</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>un tableau associatif valeurs / libell<6C>s</entry>
<entry>Un tableau associatif valeurs / libell<6C>s</entry>
</row>
<row>
<entry>separator</entry>
<entry>cha<EFBFBD>ne de caract<63>res</entry>
<entry>Non</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>cha<EFBFBD>ne de s<>paration <20> placer entre les
<entry>Cha<EFBFBD>ne de s<>paration <20> placer entre les
boutons radio</entry>
</row>
<row>
@@ -85,14 +83,27 @@
</tbody>
</tgroup>
</informaltable>
<para>
Tous les param<61>tres qui ne sont pas dans la liste ci dessus sont
affich<EFBFBD>s en tant que paires nom / valeur dans chaque balise &lt;input&gt;
cr<EFBFBD><EFBFBD>e.
</para>
<itemizedlist>
<listitem><para>
Les attributs requis sont <parameter>values</parameter> et
<parameter>output</parameter>, <20> moins que vous n'utilisez
<parameter>options</parameter> <20> la place.
</para></listitem>
<listitem><para>
Tous les affichages sont conformes XHTML.
</para></listitem>
<listitem><para>
Tous les param<61>tres qui ne sont pas dans la liste ci-dessus sont
affich<63>s sous la forme de paire nom/valeur dans la balise
<literal>&lt;input&gt;</literal> cr<63><72>es.
</para></listitem>
</itemizedlist>
<example>
<title>{html_radios} : Exemple 1</title>
<title>{html_radios} : Premi<EFBFBD>re exemple</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -121,7 +132,7 @@ $smarty->assign('customer_id', 1001);
</programlisting>
</example>
<example>
<title>{html_radios} : Exemple 2</title>
<title>{html_radios} : Deuxi<EFBFBD>me exemple</title>
<programlisting>
<![CDATA[
<?php
@@ -175,19 +186,20 @@ $smarty->assign('contact',$db->getRow($sql));
]]>
</programlisting>
<para>
et le template :
La variable assign<67>e depuis la base de donn<6E>es ci-dessus sera affich<63>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>

68
docs/fr/designers/language-custom-functions/language-function-html-select-date.xml
View File

@@ -1,14 +1,17 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready -->
<!-- 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<69>e</link>
qui cr<63>e des listes d<>roulantes pour saisir la date. Elle peut afficher n'importe
quel jour, mois et ann<6E>e.
Tous les param<61>tres qui ne sont pas dans la liste ci-dessous sont
affich<63>s sous la forme pair nom/valeur dans les balises
<literal>&lt;select&gt;</literal> des jours, mois et ann<6E>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 <20> utiliser</entry>
<entry>La date / heure <20> utiliser</entry>
</row>
<row>
<entry>start_year</entry>
@@ -100,7 +103,7 @@
<entry>cha<EFBFBD>ne de caract<63>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<67>, alors le premier <20>l<EFBFBD>ment de la boite de s<>lection
affiche le texte donn<6E> en tant que libell<6C> et dispose de la valeur "".
affiche le texte donn<6E> en tant que libell<6C> et dispose de la valeur <quote></quote>.
Utile par exemple lorsque vous souhaitez que la boite de s<>lection affiche
"S<EFBFBD>lectionnez une ann<6E>e".
A savoir que vous pouvez sp<73>cifier des valeurs de la forme "-MM-JJ" pour
<quote>S<EFBFBD>lectionnez une ann<6E>e</quote>.
A savoir que vous pouvez sp<73>cifier des valeurs de la forme <quote>-MM-DD</quote> pour
l'attribut time afin d'indiquer une ann<6E>e non s<>lectionn<6E>e.</entry>
</row>
<row>
@@ -226,9 +229,9 @@
<entry>Non</entry>
<entry>null</entry>
<entry>S'il est renseign<67>, le premier <20>l<EFBFBD>ment de la boite de s<>lection
affiche le texte donn<6E> en tant que libell<6C> et dispose de la valeur "".
A savoir que vous pouvez sp<73>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<6E> en tant que libell<6C> et dispose de la valeur <quote></quote>.
A savoir que vous pouvez sp<73>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<67>, le premier <20>l<EFBFBD>ment de la boite de s<>lection
affiche le texte donn<6E> en tant que libell<6C> et dispose de la valeur "".
A savoir que vous pouvez sp<73>cifier des valeurs de la forme "AAAA-MM-" pour
affiche le texte donn<6E> en tant que libell<6C> et dispose de la valeur <quote></quote>.
A savoir que vous pouvez sp<73>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<61>tres non pr<70>sents dans la liste ci-dessus sont affich<63>s
en tant que paires nom/valeur dans la balise &lt;select&gt; du jour, mois
et ann<6E>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<78>me exemple</title>
<programlisting>
<![CDATA[
{* le d<>marage et la fin de l'ann<6E>e peuvent <20>tre relatif <20> l'ann<6E>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<75> .....
<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<75> .....
<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>