cvs: smarty /docs/fr/programmers/advanced-features advanced-features-objects.xml advanced-features-outputfilters.xml advanced-features-postfilters.xml advanced-features-prefilters.xml section-template-cache-handler-func.xml template-resources.xml
[email protected] ("Yannick Torres") Sat, 07 Oct 2006 12:05:26 -0000
| Newsgroups | php.smarty.cvs |
|---|---|
| Message-ID | <cvsyannick1160222726@cvsserver> |
yannick Sat Oct 7 12:05:26 2006 UTC
Modified files:
/smarty/docs/fr/programmers/advanced-features
advanced-features-objects.xml
advanced-features-outputfilters.xml
advanced-features-postfilters.xml
advanced-features-prefilters.xml
section-template-cache-handler-func.xml
template-resources.xml
Log:
sync with EN
yannick-20061007120526.txt
(text/plain, 21 KB)
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/programmers/advanced-features/advanced-features-objects.xml?r1=1.6&r2=1.7&diff_format=u
Index: smarty/docs/fr/programmers/advanced-features/advanced-features-objects.xml
diff -u smarty/docs/fr/programmers/advanced-features/advanced-features-objects.xml:1.6 smarty/docs/fr/programmers/advanced-features/advanced-features-objects.xml:1.7
--- smarty/docs/fr/programmers/advanced-features/advanced-features-objects.xml:1.6 Wed Dec 14 22:09:58 2005
+++ smarty/docs/fr/programmers/advanced-features/advanced-features-objects.xml Sat Oct 7 12:05:26 2006
@@ -1,18 +1,28 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
<sect1 id="advanced.features.objects">
<title>Objets</title>
<para>
Smarty donne l'accès aux <ulink url="&url.php-manual;object">objets</ulink>
- PHP à travers les templates. Il y a 2 moyens d'y avoir accès. Le premier consiste à
+ PHP à travers les templates. Il y a 2 moyens d'y avoir accès.
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem><para>
+ Le premier consiste à
<link linkend="api.register.object">allouer les objets</link>
au template puis de les utiliser avec une syntaxe similaire a celles
des <link linkend="language.custom.functions">fonctions personnalisées</link>.
+ </para></listitem>
+ <listitem><para>
Le deuxième moyen consiste à <link linkend="api.assign">assigner</link> des objets
aux templates et de les utiliser comme n'importe quelle
- variable. La première méthode a une syntaxe beaucoup plus sympathique.
+ variable.
+ </para></listitem>
+ </itemizedlist>
+ <para>
+ La première méthode a une syntaxe beaucoup plus sympathique.
Elle est aussi plus sécurisée, puisqu'un objet alloué ne peut avoir accès
qu'a certaines méthodes et propriétés. Néanmoins,
<emphasis role="bold">un objet alloué ne peut pas avoir de lien sur lui-même
@@ -22,7 +32,7 @@
afin de réduire la syntaxe des templates au minimum.
</para>
<para>
- Si l'option de <link linkend="variable.security">sécurité</link>
+ Si l'option de <link linkend="variable.security">sécurité</link>
est activée, aucune méthode ou fonctions privées
n'est accessible (commentant par "_"). S'il existe une méthode et une
propriété du même nom, c'est la méthode qui sera utilisée.
@@ -39,7 +49,7 @@
Le premier paramètre correspond à un tableau associatif, le second à l'objet
Smarty. Si vous souhaitez que les paramètres soient passés un à un, comme
dans un appel traditionnel, définissez registration, quatrième paramètre optionnel,
- à false.
+ à &false;.
</para>
<para>
Le cinquième paramètre optionnel n'a d'effet que si le paramètre
@@ -47,8 +57,8 @@
une liste de méthodes qui doivent être traitées comme des blocks. Celà signifie
que ces méthodes ont un tag fermant dans le template
(<literal>{foobar->meth2}...{/foobar->meth2}</literal>) et que les paramètres
- de ces méthodes fonctionnent de la même façon que les paramètres des
- <link linkend="plugins.block.functions">blocks de fonctions des plugins</link> :
+ de ces méthodes fonctionnent de la même façon que les paramètres des
+ <link linkend="plugins.block.functions">blocks de fonctions des plugins</link> :
Ils contiennent 4 paramètres
<parameter>$params</parameter>,
<parameter>$content</parameter>,
@@ -87,7 +97,7 @@
]]>
</programlisting>
<para>
- Et voici comment accéder à vos objets dans index.tpl:
+ Et voici comment accéder à vos objets dans <filename>index.tpl</filename> :
</para>
<programlisting>
<![CDATA[
@@ -105,8 +115,8 @@
</example>
<para>
Voir aussi
- <link linkend="api.register.object">register_object()</link> et
- <link linkend="api.assign">assign()</link>.
+ <link linkend="api.register.object"><varname>register_object()</varname></link> et
+ <link linkend="api.assign"><varname>assign()</varname></link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml?r1=1.6&r2=1.7&diff_format=u
Index: smarty/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml
diff -u smarty/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml:1.6 smarty/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml:1.7
--- smarty/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml:1.6 Sun Sep 3 10:03:12 2006
+++ smarty/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml Sat Oct 7 12:05:26 2006
@@ -1,13 +1,13 @@
<?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="advanced.features.outputfilters">
<title>Filtres de sortie</title>
<para>
Quand le template est appelé via les fonctions
- <link linkend="api.display">display()</link> ou
- <link linkend="api.fetch">fetch()</link>,
+ <link linkend="api.display"><varname>display()</varname></link> ou
+ <link linkend="api.fetch"><varname>fetch()</varname></link>,
sa sortie est envoyée à travers un ou plusieurs filtres de sorties.
Ils diffèrent des <link linkend="advanced.features.postfilters">filtres
de post-compilation</link> dans le sens où ils agissent sur la sortie
@@ -19,9 +19,9 @@
<link linkend="api.register.outputfilter">déclarés</link> soit
chargés depuis les <link linkend="variable.plugins.dir">répertoires
des plugins</link> en utilisant la fonction
- <link linkend="api.load.filter">load_filter()</link>
+ <link linkend="api.load.filter"><varname>load_filter()</varname></link>
ou en réglant la variable
- <link linkend="variable.autoload.filters">$autoload_filters</link>.
+ <link linkend="variable.autoload.filters"><parameter>$autoload_filters</parameter></link>.
Smarty passera la sortie du template en premier argument et attendra
de la fonction qu'elle retourne le résultat de l'exécution.
</para>
@@ -51,11 +51,11 @@
</example>
<para>
Voir aussi
- <link linkend="api.register.outputfilter">register_outpurfilter()</link>,
- <link linkend="api.load.filter">load_filter()</link>,
- <link linkend="variable.autoload.filters">$autoload_filters</link>,
+ <link linkend="api.register.outputfilter"><varname>register_outpurfilter()</varname></link>,
+ <link linkend="api.load.filter"><varname>load_filter()</varname></link>,
+ <link linkend="variable.autoload.filters"><parameter>$autoload_filters</parameter></link>,
les <link linkend="advanced.features.postfilters">filtres de post-compilation</link> et
- <link linkend="variable.plugins.dir">$plugins_dir</link>.
+ <link linkend="variable.plugins.dir"><parameter>$plugins_dir</parameter></link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml?r1=1.8&r2=1.9&diff_format=u
Index: smarty/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml
diff -u smarty/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml:1.8 smarty/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml:1.9
--- smarty/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml:1.8 Sun Sep 3 10:03:12 2006
+++ smarty/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml Sat Oct 7 12:05:26 2006
@@ -1,16 +1,18 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
<sect1 id="advanced.features.postfilters">
<title>Filtres de post-compilation</title>
<para>
Les filtres de post-compilation sont des fonctions PHP que vos templates
- exécutent après avoir été compilés. Les filtres de post-compilation peuvent
- être soit <link linkend="api.register.postfilter">déclarés</link>, soit chargés
+ exécutent <emphasis>après avoir été compilés</emphasis>. Les filtres de post-compilation
+ peuvent être soit <link linkend="api.register.postfilter">déclarés</link>, soit chargés
depuis les <link linkend="variable.plugins.dir">répertoires des plugins</link>
- en utilisant la fonction <link linkend="api.load.filter">load_filter()</link> ou en réglant
- la variable <link linkend="variable.autoload.filters">$autoload_filters</link>.
+ en utilisant la fonction
+ <link linkend="api.load.filter"><varname>load_filter()</varname></link> ou en réglant
+ la variable
+ <link linkend="variable.autoload.filters"><parameter>$autoload_filters</parameter></link>.
Smarty passera le template compilé en tant que premier paramètre et attendra
de la fonction qu'elle retourne le résultat de l'exécution.
</para>
@@ -32,7 +34,7 @@
]]>
</programlisting>
<para>
- Votre template Smarty index.tpl ressemblera, après compilation à :
+ Votre template Smarty <filename>index.tpl</filename> ressemblera, après compilation à :
</para>
<screen>
<![CDATA[
@@ -43,9 +45,9 @@
</example>
<para>
Voir aussi
- <link linkend="api.register.postfilter">register_postfilter()</link>,
+ <link linkend="api.register.postfilter"><varname>register_postfilter()</varname></link>,
<link linkend="advanced.features.prefilters">les pré-filtres</link> et
- <link linkend="api.load.filter">load_filter()</link>.
+ <link linkend="api.load.filter"><varname>load_filter()</varname></link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml?r1=1.7&r2=1.8&diff_format=u
Index: smarty/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml
diff -u smarty/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml:1.7 smarty/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml:1.8
--- smarty/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml:1.7 Sun Sep 3 10:03:12 2006
+++ smarty/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml Sat Oct 7 12:05:26 2006
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
<sect1 id="advanced.features.prefilters">
<title>Filtres de pré-compilation</title>
<para>
Les filtres de pré-compilation sont des fonctions PHP que vos templates
- exécutent avant qu'ils ne soient compilés. Celà peut être utile
+ exécutent <emphasis>avant qu'ils ne soient compilés</emphasis>. Celà peut être utile
pour pré-traiter vos templates afin d'enlever les commentaires
inutiles, garder un oeil sur ce que les gens mettent dans leurs templates, etc.
</para>
@@ -14,9 +14,9 @@
Les filtre de pré-compilations peuvent être soit
<link linkend="api.register.prefilter">déclarés</link>, soit chargés
à partir des <link linkend="variable.plugins.dir">répertoires de plugins</link>
- en utilisant la fonction <link linkend="api.load.filter">load_filter()</link> ou
+ en utilisant la fonction <link linkend="api.load.filter"><varname>load_filter()</varname></link> ou
en réglant la variable
- <link linkend="variable.autoload.filters">$autoload_filters</link>.
+ <link linkend="variable.autoload.filters"><parameter>$autoload_filters</parameter></link>.
</para>
<para>
Smarty passera à la fonction le code source en tant que premier argument,
@@ -45,9 +45,9 @@
</example>
<para>
Voir aussi
- <link linkend="api.register.prefilter">register_prefilter()</link>,
+ <link linkend="api.register.prefilter"><varname>register_prefilter()</varname></link>,
les <link linkend="advanced.features.postfilters">post-filtres</link> et
- <link linkend="api.load.filter">load_filter()</link>.
+ <link linkend="api.load.filter"><varname>load_filter()</varname></link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml?r1=1.8&r2=1.9&diff_format=u
Index: smarty/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml
diff -u smarty/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml:1.8 smarty/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml:1.9
--- smarty/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml:1.8 Fri Feb 17 22:40:54 2006
+++ smarty/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml Sat Oct 7 12:05:26 2006
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.5 Maintainer: gerald Status: ready -->
+
<sect1 id="section.template.cache.handler.func">
<title>Fonction de gestion du cache</title>
<para>
@@ -14,25 +15,53 @@
fonction à la variable de classe
<link linkend="variable.cache.handler.func">$cache_handler_func</link>.
Smarty utilisera alors cette fonction pour gérer les données du cache.
- Le premier argument est l'action, qui sera 'read', 'write' ou 'clear'.
- Le second paramètre est l'objet Smarty. Le troisième est le contenu
- du cache. Pour écrire, Smarty passe le contenu du cache dans ces paramètres.
- Pour lire, Smarty s'attend à ce que votre fonction accepte ce paramètre
- par référence et que vous le remplissiez avec les données du cache. Pour effacer,
- il suffit de passer une variable fictive car cette dernière n'est pas utilisée.
- Le quatrième paramètre est le nom du fichier de template (utile pour
- lire/écrire), le cinquième paramètre est l'identifiant de cache (optionnel)
- et le sixième est l'identifiant de compilation (optionnel).
</para>
- <para>
- Note: Le dernier paramètre ($exp_time) a été ajouté dans Smarty-2.6.0.
- </para>
+
+ <itemizedlist>
+ <listitem><para>
+ Le premier argument est l'action, qui sera <literal>read</literal>, <literal>write</literal> and
+ <literal>clear</literal>.
+ </para></listitem>
+
+ <listitem><para>
+ Le second paramètre est l'objet Smarty.
+ </para></listitem>
+
+ <listitem><para>
+ Le troisième est le contenu
+ du cache. Pour écrire, Smarty passe le contenu du cache dans ces paramètres.
+ Pour lire, Smarty s'attend à ce que votre fonction accepte ce paramètre
+ par référence et que vous le remplissiez avec les données du cache. Pour effacer,
+ il suffit de passer une variable fictive car cette dernière n'est pas utilisée.
+ </para></listitem>
+
+ <listitem><para>
+ Le quatrième paramètre est le nom du fichier de template (utile pour
+ lire/écrire).
+ </para></listitem>
+
+ <listitem><para>
+ Le cinquième paramètre est l'identifiant <parameter>$cache_id</parameter>.
+ </para></listitem>
+
+ <listitem><para>
+ Le sixième est l'identifiant optionnel <link linkend="variable.compile.id">
+ <parameter>$compile_id</parameter></link>.
+ </para></listitem>
+
+ <listitem><para>
+ Le septième et dernier paramètre <parameter>$exp_time</parameter>
+ a été ajouté dans Smarty-2.6.0.
+</para></listitem>
+
+</itemizedlist>
+
<example>
<title>Exemple d'utilisation de MySQL pour la source du cache</title>
<programlisting role="php">
<![CDATA[
<?php
-/*
+/*****
exemple d'usage :
@@ -54,7 +83,7 @@
CacheContents MEDIUMTEXT NOT NULL
);
-*/
+*****/
function mysql_cache_handler($action, &$smarty_obj, &$cache_content, $tpl_file=null, $cache_id=null, $compile_id=null)
{
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/programmers/advanced-features/template-resources.xml?r1=1.5&r2=1.6&diff_format=u
Index: smarty/docs/fr/programmers/advanced-features/template-resources.xml
diff -u smarty/docs/fr/programmers/advanced-features/template-resources.xml:1.5 smarty/docs/fr/programmers/advanced-features/template-resources.xml:1.6
--- smarty/docs/fr/programmers/advanced-features/template-resources.xml:1.5 Wed May 25 16:49:34 2005
+++ smarty/docs/fr/programmers/advanced-features/template-resources.xml Sat Oct 7 12:05:26 2006
@@ -1,27 +1,29 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+
<sect1 id="template.resources">
<title>Ressources</title>
<para>
Les templates peuvent provenir d'une grande variété de ressources. Quand vous
- affichez (<link linkend="api.display">display()</link>) ou
- récupérez (<link linkend="api.fetch">fetch()</link>) un template, ou quand vous incluez un template
- dans un autre template, vous fournissez un type de ressource, suivi
- par le chemin approprié et le nom du template. Si une ressource n'est pas
- explicitement donnée, la valeur de la variable <link
- linkend="variable.default.resource.type">$default_resource_type</link>
+ affichez (<link linkend="api.display"><varname>display()</varname></link>) ou
+ récupérez (<link linkend="api.fetch"><varname>fetch()</varname></link>) un
+ template, ou quand vous incluez un template dans un autre template, vous fournissez
+ un type de ressource, suivi par le chemin approprié et le nom du template.
+ Si une ressource n'est pas explicitement donnée, la valeur de la variable <link
+ linkend="variable.default.resource.type"><parameter>$default_resource_type</parameter></link>
sera utilisée.
</para>
<sect2 id="templates.from.template.dir">
<title>Templates depuis $template_dir</title>
<para>
- Les templates du répertoire
- <link linkend="variable.template.dir">$template_dir</link> n'ont pas
+ Les templates du répertoire
+ <link linkend="variable.template.dir"><parameter>$template_dir</parameter></link> n'ont pas
besoin d'une ressource template, bien que vous puissiez utiliser
la ressource "file" pour être cohérent. Vous n'avez qu'à fournir
le chemin vers le template que vous voulez utiliser, relatif
- au répertoire racine <link linkend="variable.template.dir">$template_dir</link>.
+ au répertoire racine
+ <link linkend="variable.template.dir"><parameter>$template_dir</parameter></link>.
</para>
<example>
<title>Utilisation de templates depuis $template_dir</title>
@@ -43,9 +45,9 @@
<sect2 id="templates.from.any.dir">
<title>Templates à partir de n'importe quel répertoire</title>
<para>
- Les templates en-dehors du répertoire
- <link linkend="variable.template.dir">$template_dir</link> nécessitent
- le type de ressource template, suivi du chemin absolu et du nom du
+ Les templates en-dehors du répertoire
+ <link linkend="variable.template.dir"><parameter>$template_dir</parameter></link>
+ nécessitent le type de ressource template, suivi du chemin absolu et du nom du
template.
</para>
<example>
@@ -53,8 +55,8 @@
<programlisting role="php">
<![CDATA[
<?php
-$smarty->display("file:/export/templates/index.tpl");
-$smarty->display("file:/path/to/my/templates/menu.tpl");
+$smarty->display('file:/export/templates/index.tpl');
+$smarty->display('file:/path/to/my/templates/menu.tpl');
?>
]]>
</programlisting>
@@ -63,7 +65,7 @@
</para>
<programlisting>
<![CDATA[
-{include file="file:/usr/local/share/templates/navigation.tpl"}
+{include file='file:/usr/local/share/templates/navigation.tpl'}
]]>
</programlisting>
</example>
@@ -73,7 +75,7 @@
<para>
Si vous utilisez Windows, les chemins de fichiers sont la plupart
du temps sur un disque identifié par une lettre (c:) au début du chemin.
- Assurez-vous de bien mettre "file:" dans le chemin pour éviter des
+ Assurez-vous de bien mettre <literal>file:</literal> dans le chemin pour éviter des
conflits d'espace de noms et obtenir les résultats escomptés.
</para>
<example>
@@ -81,8 +83,8 @@
<programlisting role="php">
<![CDATA[
<?php
-$smarty->display("file:C:/export/templates/index.tpl");
-$smarty->display("file:F:/path/to/my/templates/menu.tpl");
+$smarty->display('file:C:/export/templates/index.tpl');
+$smarty->display('file:F:/path/to/my/templates/menu.tpl');
?>
]]>
</programlisting>
@@ -91,7 +93,7 @@
</para>
<programlisting>
<![CDATA[
-{include file="file:D:/usr/local/share/templates/navigation.tpl"}
+{include file='file:D:/usr/local/share/templates/navigation.tpl'}
]]>
</programlisting>
</example>
@@ -114,7 +116,7 @@
<note>
<para>
- Notez que vous ne pouvez pas écraser la ressource <literal>file</literal> native,
+ Notez que vous ne pouvez pas écraser la ressource <literal>file:</literal> native,
toutefois, vous pouvez fournir une ressource qui récupère un template depuis
le système de fichier par un autre moyen en l'enregistrant sous un autre
nom de ressource.
@@ -184,7 +186,7 @@
</para>
<programlisting>
<![CDATA[
-{include file="db:/extras/navigation.tpl"}
+{include file='db:/extras/navigation.tpl'}
]]>
</programlisting>
</example>