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

sync with EN & typo

Browse Source
This commit is contained in:
yannick
2004-12-26 17:02:12 +00:00
parent 42fd57727b
commit ee6a5a5cf2
38 changed files with 1211 additions and 835 deletions
Download Patch File Download Diff File Expand all files Collapse all files

77
docs/fr/programmers/api-functions/api-append-by-ref.xml
View File

@@ -1,49 +1,44 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.append.by.ref">
<title>append_by_ref</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>append_by_ref</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>void <function>append_by_ref</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
<paramdef>boolean <parameter>merge</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<69>e pour ajouter des valeurs a un template par r<>f<EFBFBD>rence plut(t que
par copie. Si vous ajoutez une variable par r<>f<EFBFBD>rence puis changez sa
valeur, le changement est aussi r<>percut<75> sur la valeur assign<67>e.
Pour les objets, append_by_ref ne fait pas de copie en m<>moire de l'objet
assign<67>. Voir la documentation PHP pour plus d'informations sur les
r<>f<EFBFBD>rences de variable.
Si vous passez le troisi<73>me param<61>tre a vrai, la valeur sera fusionn<6E>e
avec le tableau courant plut(t que d'<27>tre ajout<75>e.
</para>
<note>
<title>Note technique</title>
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
<refentry id="api.append.by.ref">
<refnamediv>
<refname>append_by_ref</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>append_by_ref</methodname>
<methodparam><type>string</type><parameter>varname</parameter></methodparam>
<methodparam><type>mixed</type><parameter>var</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>merge</parameter></methodparam>
</methodsynopsis>
<para>
Le param<61>tre de fusion respecte les cl<63>s des tableaux, ainsi si vous
fusionnez deux tableaux index<65>s num<75>riquement, ils pourront s'<27>craser
l'un l'autre ou donner des cl<63>s qui ne se suivent pas. Cela diff<66>re
donc de la fonction PHP array_merge() qui supprime les cl<63>s num<75>riques
et les renum<75>rote.
Utilis<EFBFBD>e pour ajouter des valeurs <20> un template par r<>f<EFBFBD>rence plut<75>t que
par copie. Si vous ajoutez une variable par r<>f<EFBFBD>rence puis changez sa
valeur, le changement est aussi r<>percut<75> sur la valeur assign<67>e.
Pour les objets, append_by_ref ne fait pas de copie en m<>moire de l'objet
assign<EFBFBD>. Voir la documentation PHP pour plus d'informations sur les
r<>f<EFBFBD>rences de variable.
Si vous passez le troisi<73>me param<61>tre <20> <literal>true</literal>, la valeur
sera fusionn<6E>e avec le tableau courant plut<75>t que d'<27>tre ajout<75>e.
</para>
</note>
<example>
<title>append_by_ref</title>
<programlisting>
&note.parameter.merge;
<example>
<title>Exemple avec append_by_ref</title>
<programlisting role="php">
<![CDATA[
<?php
// ajoute des paires nom/valeur
$smarty->append_by_ref("Name",$myname);
$smarty->append_by_ref("Address",$address);</programlisting>
</example>
</sect1>
$smarty->append_by_ref("Nom",$myname);
$smarty->append_by_ref("Adresse",$address);
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

83
docs/fr/programmers/api-functions/api-append.xml
View File

@@ -1,54 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.append">
<title>append</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>append</function></funcdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>void <function>append</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>void <function>append</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
<paramdef>boolean <parameter>merge</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<69>e pour ajouter un <20>l<EFBFBD>ment a un tableau assign<67>. Si vous utilisez
cette fonction avec une cha<68>ne de caract<63>res, elle est convertie en
tableau auquel on ajoute ensuite l'<27>l<EFBFBD>ment. Vous pouvez explicitement passer
des paires nom/valeur. Si vous passez le troisi<73>me param<61>tre
(optionel) a vrai, la valeur sera fusionn<6E>e avec le tableau plut(t que
d'<27>tre ajout<75>e.
</para>
<note>
<title>Note technique</title>
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
<refentry id="api.append">
<refnamediv>
<refname>append</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>append</methodname>
<methodparam><type>mixed</type><parameter>var</parameter></methodparam>
</methodsynopsis>
<methodsynopsis>
<type>void</type><methodname>append</methodname>
<methodparam><type>string</type><parameter>varname</parameter></methodparam>
<methodparam><type>mixed</type><parameter>var</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>merge</parameter></methodparam>
</methodsynopsis>
<para>
Le param<61>tre de fusion respecte les cl<63>s des tableaux, ainsi si vous
fusionnez deux tableaux index<65>s num<75>riquement, ils pourront s'<27>craser
l'un l'autre ou donner des cl<63>s qui ne se suivent pas. Cela diff<66>re
donc de la fonction PHP array_merge() qui supprime les cl<63>s num<75>riques
et les renum<75>rote.
Utilis<EFBFBD>e pour ajouter un <20>l<EFBFBD>ment <20> un tableau assign<67>. Si vous utilisez
cette fonction avec une cha<68>ne de caract<63>res, elle est convertie en
tableau auquel on ajoute ensuite l'<27>l<EFBFBD>ment. Vous pouvez explicitement
passer des paires nom/valeur. Si vous passez le troisi<73>me param<61>tre
(optionel) <20> <literal>true</literal>, la valeur sera fusionn<6E>e avec le
tableau plut<75>t que d'<27>tre ajout<75>e.
</para>
</note>
<example>
<title>append</title>
<programlisting>
&note.parameter.merge;
<example>
<title>Exemple avec append</title>
<programlisting role="php">
<![CDATA[
<?php
// passe des paires nom/valeur
$smarty->append("Name","Fred");
$smarty->append("Address",$address);
$smarty->append("Nom","Fred");
$smarty->append("Adresse",$address);
// passe un tableau associatif
$smarty->append(array("city" => "Lincoln","state" => "Nebraska"));</programlisting>
</example>
</sect1>
$smarty->append(array("Ville" => "Lincoln","Pays" => "Nebraska"));
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

45
docs/fr/programmers/api-functions/api-assign-by-ref.xml
View File

@@ -1,17 +1,20 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.assign.by.ref">
<title>assign_by_ref</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>assign_by_ref</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour assigner des valeurs aux templates par r<>f<EFBFBD>rence plut(t
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.assign.by.ref">
<refnamediv>
<refname>assign_by_ref</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>assign_by_ref</methodname>
<methodparam><type>string</type><parameter>varname</parameter></methodparam>
<methodparam><type>mixed</type><parameter>var</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour assigner des valeurs aux templates par r<>f<EFBFBD>rence plut<75>t
que par copie. R<>f<EFBFBD>rez-vous au manuel PHP pour une explication plus pr<70>cise
sur les r<>f<EFBFBD>rences des variables.
</para>
@@ -26,13 +29,19 @@
</para>
</note>
<example>
<title>assign_by_ref</title>
<programlisting>
<title>Exemple avec assign_by_ref</title>
<programlisting role="php">
<![CDATA[
<?php
// passe des paires noms/valeurs
$smarty->assign_by_ref("Name",$myname);
$smarty->assign_by_ref("Address",$address);</programlisting>
</example>
</sect1>
$smarty->assign_by_ref("Nom",$myname);
$smarty->assign_by_ref("Adresse",$address);
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

63
docs/fr/programmers/api-functions/api-assign.xml
View File

@@ -1,35 +1,44 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.assign">
<title>assign</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>assign</function></funcdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>void <function>assign</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>mixed <parameter>var</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour assigner des valeurs aux templates. Vous pouvez
explicitement passer des paires nom/valeur, ou des tableaux
associatifs contenant des paires nom/valeur.
</para>
<example>
<title>assign</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.assign">
<refnamediv>
<refname>assign</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>assign</methodname>
<methodparam><type>mixed</type><parameter>var</parameter></methodparam>
</methodsynopsis>
<methodsynopsis>
<type>void</type><methodname>assign</methodname>
<methodparam><type>string</type><parameter>varname</parameter></methodparam>
<methodparam><type>mixed</type><parameter>var</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour assigner des valeurs aux templates. Vous pouvez
explicitement passer des paires nom/valeur, ou des tableaux
associatifs contenant des paires nom/valeur.
</para>
<example>
<title>Exemple avec assign</title>
<programlisting role="php">
<![CDATA[
<?php
// passe des paires nom/valeur
$smarty->assign("Name","Fred");
$smarty->assign("Address",$address);
$smarty->assign("Nom","Fred");
$smarty->assign("Adresse",$address);
// passe un tableau associatif
$smarty->assign(array("city" => "Lincoln","state" => "Nebraska"));</programlisting>
</example>
</sect1>
$smarty->assign(array("Ville" => "Lincoln","Pays" => "Nebraska"));
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

45
docs/fr/programmers/api-functions/api-clear-all-assign.xml
View File

@@ -1,24 +1,33 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.clear.all.assign">
<title>clear_all_assign</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>clear_all_assign</function></funcdef>
<paramdef><parameter></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour effacer les valeurs de toutes les variables assign<67>es.
</para>
<example>
<title>clear_all_assign</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.clear.all.assign">
<refnamediv>
<refname>clear_all_assign</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>clear_all_assign</methodname>
<void />
</methodsynopsis>
<para>
Utilis<69>e pour effacer les valeurs de toutes les variables assign<67>es.
</para>
<example>
<title>Exemple avec clear_all_assign</title>
<programlisting role="php">
<![CDATA[
<?php
// efface toutes les variables assign<67>es
$smarty->clear_all_assign();</programlisting>
</example>
</sect1>
$smarty->clear_all_assign();
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

49
docs/fr/programmers/api-functions/api-clear-all-cache.xml
View File

@@ -1,26 +1,35 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.clear.all.cache">
<title>clear_all_cache</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>clear_all_cache</function></funcdef>
<paramdef>int <parameter>expire time</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour effacer les fichiers de cache des templates. Vous pouvez passer un
param<EFBFBD>tre optionnel afin d'indiquer l'Gge minimun que doivent avoir
les fichiers de cache pour qu'ils soient effac<61>s.
</para>
<example>
<title>clear_all_cache</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.clear.all.cache">
<refnamediv>
<refname>clear_all_cache</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>clear_all_cache</methodname>
<methodparam choice="opt"><type>int</type><parameter>expire_time</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour effacer les fichiers de cache des templates. Vous pouvez passer un
param<61>tre optionnel afin d'indiquer l'<27>ge minimun que doivent avoir
les fichiers de cache pour qu'ils soient effac<61>s.
</para>
<example>
<title>Exemple avec clear_all_cache</title>
<programlisting role="php">
<![CDATA[
<?php
// efface le cache
$smarty->clear_all_cache();</programlisting>
</example>
</sect1>
$smarty->clear_all_cache();
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

47
docs/fr/programmers/api-functions/api-clear-assign.xml
View File

@@ -1,28 +1,37 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.clear.assign">
<title>clear_assign</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>clear_assign</function></funcdef>
<paramdef>string <parameter>var</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Efface la valeur d'une variable assign<67>e. Il peut s'agir
d'une simple valeur ou d'un tableau de valeur.
</para>
<example>
<title>clear_assign</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.clear.assign">
<refnamediv>
<refname>clear_assign</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>clear_assign</methodname>
<methodparam><type>mixed</type><parameter>var</parameter></methodparam>
</methodsynopsis>
<para>
Efface la valeur d'une variable assign<67>e. Il peut s'agir
d'une simple valeur ou d'un tableau de valeur.
</para>
<example>
<title>Exemple avec clear_assign</title>
<programlisting role="php">
<![CDATA[
<?php
// efface une variable
$smarty->clear_assign("Name");
// efface plusieurs variables
$smarty->clear_assign(array("Name","Address","Zip"));</programlisting>
</example>
</sect1>
$smarty->clear_assign(array("Name","Address","Zip"));
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

66
docs/fr/programmers/api-functions/api-clear-cache.xml
View File

@@ -1,38 +1,50 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.clear.cache">
<title>clear_cache</title>
<methodsynopsis>
<type>void</type><methodname>clear_cache</methodname>
<methodparam choice="opt"><type>string</type><parameter>template</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>cache id</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>compile id</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>expire time</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<EFBFBD>e pour nettoyer le(s) fichier(s) de cache d'un template en particulier.
Si vous avez plusieurs fichiers de cache pour ce template vous
pouvez en sp<73>cifier un en particulier en passant son identifiant
en deuxi<78>me param<61>tre. Vous pouvez aussi passer un identifiant
de compilation en troisi<73>me param<61>tre. Vous pouvez grouper des
templates ensemble afin qu'ils puissent <20>tre supprim<69>s en groupe.
R<EFBFBD>f<EFBFBD>rez-vous a la section sur le
<link linkend="caching">cache</link>
pour plus d'informations. Vous pouvez passer un quatri<EFBFBD>me param<61>tre
pour indiquer un Gge minimum en secondes que le fichier en cache doit
avoir avant d'<27>tre effac<61>.
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.clear.cache">
<refnamediv>
<refname>clear_cache</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>clear_cache</methodname>
<methodparam><type>string</type><parameter>template</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>expire_time</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour nettoyer le(s) fichier(s) de cache d'un
<parameter>template</parameter> en particulier.
Si vous avez plusieurs fichiers de cache pour ce template, vous
pouvez en sp<73>cifier un en particulier en passant son identifiant
<parameter>cache_id</parameter> en deuxi<78>me param<61>tre.
Vous pouvez aussi passer un identifiant de compilation
<parameter>compile_id</parameter> en troisi<73>me param<61>tre.
Vous pouvez grouper des templates ensemble afin qu'ils puissent
<20>tre supprim<69>s en groupe. R<>f<EFBFBD>rez-vous a la section sur le
<link linkend="caching">cache</link> pour plus d'informations.
Vous pouvez passer un quatri<72>me param<61>tre pour indiquer un <20>ge
minimum en secondes que le fichier en cache doit avoir avant d'<27>tre effac<61>.
</para>
<example>
<title>clear_cache</title>
<programlisting>
<title>Exemple avec clear_cache</title>
<programlisting role="php">
<![CDATA[
<?php
// efface le fichier de cache de ce template
$smarty->clear_cache("index.tpl");
// efface un fichier de cache grGce a son identifiant de cache
$smarty->clear_cache("index.tpl","CACHEID");</programlisting>
// efface un fichier de cache gr<EFBFBD>ce <EFBFBD> son identifiant de cache
$smarty->clear_cache("index.tpl","CACHEID");
?>
]]>
</programlisting>
</example>
</sect1>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

56
docs/fr/programmers/api-functions/api-clear-compiled-tpl.xml
View File

@@ -1,29 +1,45 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.clear.compiled.tpl">
<title>clear_compiled_tpl</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>clear_compiled_tpl</function></funcdef>
<paramdef>string <parameter>tpl_file</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour effacer la version compil<69>e du template sp<73>cifi<66> ou
de tous les templates si aucun n'est sp<73>cifi<66>. Cette fonction
est destin<69>e a un usage avanc<6E> et n'est pas habituellement utilis<69>e.
</para>
<example>
<title>clear_compiled_tpl</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.clear.compiled.tpl">
<refnamediv>
<refname>clear_compiled_tpl</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>clear_compiled_tpl</methodname>
<methodparam choice="opt"><type>string</type><parameter>tpl_file</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>exp_time</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour effacer la version compil<69>e du template sp<73>cifi<66> ou
de tous les templates si aucun n'est sp<73>cifi<66>.
Si vous passez uniquement un compile_id, le template compil<69>
correspondant <20> ce compile_id sera effac<61>. Si vous passez un
exp_time, les templates compil<69>s plus vieux que exp_time secondes
seront effac<61>s, par d<>faut, tous les templates compil<69>s seront
effac<61>s au v<> de leurs <20>ges. Cette fonction est destin<69>e <20> un usage
avanc<6E> et n'est habituellement pas utilis<69>e.
</para>
<example>
<title>Exemple avec clear_compiled_tpl</title>
<programlisting role="php">
<![CDATA[
<?php
// efface la version compil<69>e du template sp<73>cifi<66>
$smarty->clear_compiled_tpl("index.tpl");
// efface tout le contenu du r<>pertoire des templates compil<69>s
$smarty->clear_compiled_tpl();</programlisting>
</example>
</sect1>
$smarty->clear_compiled_tpl();
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

46
docs/fr/programmers/api-functions/api-clear-config.xml
View File

@@ -1,27 +1,37 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.clear.config">
<title>clear_config</title>
<methodsynopsis>
<type>void</type><methodname>clear_config</methodname>
<methodparam choice="opt"><type>string</type><parameter>var</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<EFBFBD>e pour effacer toutes les variables de configuration s'<27>tant
vues assigner une valeur. Si une variable est sp<73>cifi<66>e, seule cette
variable est effac<61>e.
</para>
<example>
<title>clear_config</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.clear.config">
<refnamediv>
<refname>clear_config</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>clear_config</methodname>
<methodparam choice="opt"><type>string</type><parameter>var</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour effacer toutes les variables de configuration assign<67>es.
Si un nom de variable est sp<73>cifi<66>, seule cette variable sera effac<61>e.
</para>
<example>
<title>Exemple avec clear_config</title>
<programlisting role="php">
<![CDATA[
<?php
// efface toutes les variables de configuration assign<67>es
$smarty->clear_config();
// efface une seule variable
$smarty->clear_config('foobar');</programlisting>
</example>
</sect1>
$smarty->clear_config('foobar');
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

71
docs/fr/programmers/api-functions/api-config-load.xml
View File

@@ -1,41 +1,52 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.config.load">
<title>config_load</title>
<methodsynopsis>
<type>void</type><methodname>config_load</methodname>
<methodparam><type>string</type><parameter>file</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>section</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<EFBFBD>e pour charger des donn<6E>es d'un fichier de config et les
assigner a un template. Cette fonction fonctionne exactement comme
la fonction de template <link
linkend="language.function.config.load">config_load</link>.
</para>
<note>
<title>Note technique</title>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.config.load">
<refnamediv>
<refname>config_load</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>config_load</methodname>
<methodparam><type>string</type><parameter>file</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>section</parameter></methodparam>
</methodsynopsis>
<para>
Comme pour Smarty 2.4.0, les variables de templates assign<67>es
sont conserv<72>es entre chaque appel a fetch et display.
Les variables de configuration charg<72>es avec config_load sont
globales. Les fichiers de config sont aussi compil<69>s pour une
ex<65>cution plus rapide et respecte les r<>glages de <link
linkend="variable.force.compile">force_compile</link> et de <link
linkend="variable.compile.check">compile_check</link>.
Utilis<EFBFBD>e pour charger des donn<6E>es d'un fichier <parameter>file</parameter>
de configuration et les assigner a un template. Cette fonction fonctionne
exactement comme la fonction de template <link
linkend="language.function.config.load">config_load</link>.
</para>
</note>
<example>
<title>config_load</title>
<programlisting>
<note>
<title>Note technique</title>
<para>
Comme pour Smarty 2.4.0, les variables de templates assign<67>es
sont conserv<72>es entre chaque appel <20> fetch() et display().
Les variables de configuration charg<72>es avec config_load() sont
globales. Les fichiers de configuration sont aussi compil<69>s pour une
ex<65>cution plus rapide et respecte les r<>glages de <link
linkend="variable.force.compile">force_compile</link> et de <link
linkend="variable.compile.check">compile_check</link>.
</para>
</note>
<example>
<title>Exemple avec config_load</title>
<programlisting role="php">
<![CDATA[
<?php
// charge les variables de configuration et les assigne
$smarty->config_load('my.conf');
// charge une section
$smarty->config_load('my.conf','foobar');</programlisting>
</example>
</sect1>
$smarty->config_load('my.conf','foobar');
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

97
docs/fr/programmers/api-functions/api-display.xml
View File

@@ -1,86 +1,89 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.display">
<title>display</title>
<methodsynopsis>
<type>void</type><methodname>display</methodname>
<methodparam><type>string</type><parameter>template</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<EFBFBD>e pour afficher un template. Il faut fournir un type et un
chemin de <link
linkend="template.resources">ressource template</link>
valides. Vous pouvez passer en second param<61>tre un identifiant
de fichier de cache. Reportez-vous a la section
<link linkend="caching">cache</link> pour plus de renseignements.
</para>
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
<refentry id="api.display">
<refnamediv>
<refname>display</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>display</methodname>
<methodparam><type>string</type><parameter>template</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
</methodsynopsis>
<para>
Le troisi<73>me param<61>tre optionnel est un identifiant de compilation.
Cela s'av<61>re utile quand vous voulez compiler diff<66>rentes versions
d'un m<>me template, pour par exemple avoir des templates
compil<EFBFBD>s s<>par<61>s pour diff<66>rents langages. Une autre utilit<69> de ce
param<EFBFBD>tre est le cas o<> vous utilisez plus d'un $template_dir mais un seul
$compile_dir, car certains templates avec le m<>me nom s'<27>craseraient
entre eux. Vous pouvez aussi r<>gler la variable <link
linkend="variable.compile.id">$compile_id</link> une seule
fois au lieu de la passer a chaque appel.
Utilis<EFBFBD>e pour afficher un template. Il faut fournir un type et un
chemin de <link
linkend="template.resources">ressource template</link>
valides. Vous pouvez passer en second param<61>tre un identifiant
de fichier de cache. Reportez-vous <20> la section
<link linkend="caching">cache</link> pour plus de renseignements.
</para>
&parameter.compileid;
<example>
<title>affichage</title>
<programlisting>
<title>Exemple avec display</title>
<programlisting role="php">
<![CDATA[
<?php
include("Smarty.class.php");
$smarty = new Smarty;
$smarty->caching = true;
// ne fait un appel a la base de donn<6E>es que si le fichier
// ne fait un appel <EFBFBD> la base de donn<6E>es que si le fichier
// de cache n'existe pas
if(!$smarty->is_cached("index.tpl"))
{
if(!$smarty->is_cached("index.tpl")) {
// quelques donn<6E>es
$address = "245 N 50th";
$db_data = array(
"City" => "Lincoln",
"State" => "Nebraska",
"Zip" = > "68502"
);
"Ville" => "Lincoln",
"Pays" => "Nebraska",
"Code postal" = > "68502"
);
$smarty->assign("Name","Fred");
$smarty->assign("Address",$address);
$smarty->assign("Nom","Fred");
$smarty->assign("Adresse",$address);
$smarty->assign($db_data);
}
// display the output
$smarty->display("index.tpl");</programlisting>
$smarty->display("index.tpl");
?>
]]>
</programlisting>
</example>
<para>
Utilisez la syntaxe des <link
linkend="template.resources">ressources templates</link>
pour afficher des fichiers en-dehors du r<>pertoire
$template_dir
$template_dir.
</para>
<example>
<title>exemples de fonction d'affichage de ressources templates</title>
<programlisting>
<title>Exemples de fonction d'affichage de ressources templates</title>
<programlisting role="php">
<![CDATA[
<?php
// chemin absolu
$smarty->display("/usr/local/include/templates/header.tpl");
// chemin absolu (pareil)
// chemin absolu (m<EFBFBD>m chose)
$smarty->display("file:/usr/local/include/templates/header.tpl");
// chemin absolu Windows (on DOIT utiliser le pr<70>fixe "file:")
$smarty->display("file:C:/www/pub/templates/header.tpl");
// inclue a partir de la ressource template "db"
$smarty->display("db:header.tpl");</programlisting>
// inclue <EFBFBD> partir de la ressource template nomm<EFBFBD>e "db"
$smarty->display("db:header.tpl");
?>
]]>
</programlisting>
</example>
</sect1>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

85
docs/fr/programmers/api-functions/api-fetch.xml
View File

@@ -1,42 +1,40 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.fetch">
<title>fetch</title>
<methodsynopsis>
<type>string</type><methodname>fetch</methodname>
<methodparam><type>string</type><parameter>template</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<EFBFBD>e pour renvoyer le r<>sultat du template plut(t que de l'afficher.
Il faut passer un type et un chemin de <link
linkend="template.resources">ressource template</link>
valides. Vous pouvez passer un identifiant de cache en deuxi<78>me
param<EFBFBD>tre. Reportez-vous a la section <link linkend="caching">cache
</link> pour plus de renseignements.
</para>
<para>
Un troisi<73>me param<61>tre optionnel est un identifiant de compilation.
Cela s'av<61>re utile quand vous voulez compiler diff<66>rentes versions
d'un m<>me template, pour par exemple avoir des templates
compil<EFBFBD>s s<>par<61>s pour diff<66>rents langages. Une autre utilit<69> de ce
param<EFBFBD>tre est le cas o<> vous utilisez plus d'un $template_dir
mais un seul $compile_dir, car certains templates avec le m<>me nom
s'<27>craseraient entre eux. Vous pouvez aussi r<>gler la variable <link
linkend="variable.compile.id">$compile_id</link> une seule
fois plut(t que de la passer a chaque appel.
</para>
<example>
<title>fetch</title>
<programlisting>
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
<refentry id="api.fetch">
<refnamediv>
<refname>fetch</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>string</type><methodname>fetch</methodname>
<methodparam><type>string</type><parameter>template</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour renvoyer le r<>sultat du template plut<75>t que de l'afficher.
Il faut passer un type et un chemin de <link
linkend="template.resources">ressource template</link>
valides. Vous pouvez passer un identifiant de cache en deuxi<78>me
param<61>tre. Reportez-vous <20> la section <link linkend="caching">cache
</link> pour plus de renseignements.
</para>
&parameter.compileid;
<para>
<example>
<title>Exemple avec fetch</title>
<programlisting role="php">
<![CDATA[
<?php
include("Smarty.class.php");
$smarty = new Smarty;
$smarty->caching = true;
// ne fait un appel a la base de donn<6E>es que si le fichier
// ne fait un appel <EFBFBD> la base de donn<6E>es que si le fichier
// de cache n'existe pas
if(!$smarty->is_cached("index.tpl"))
{
@@ -44,13 +42,13 @@ if(!$smarty->is_cached("index.tpl"))
// quelques donn<6E>es
$address = "245 N 50th";
$db_data = array(
"City" => "Lincoln",
"State" => "Nebraska",
"Zip" = > "68502"
);
"Ville" => "Lincoln",
"Pays" => "Nebraska",
"Code postal" = > "68502"
);
$smarty->assign("Name","Fred");
$smarty->assign("Address",$address);
$smarty->assign("Nom","Fred");
$smarty->assign("Adresse",$address);
$smarty->assign($db_data);
}
@@ -60,9 +58,14 @@ $output = $smarty->fetch("index.tpl");
// fait quelque chose avec $output
echo $output;</programlisting>
</example>
</sect1>
echo $output;
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

47
docs/fr/programmers/api-functions/api-get-config-vars.xml
View File

@@ -1,20 +1,27 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.get.config.vars">
<title>get_config_vars</title>
<methodsynopsis>
<type>array</type><methodname>get_config_vars</methodname>
<methodparam choice="opt"><type>string</type><parameter>varname</parameter></methodparam>
</methodsynopsis>
<para>
Retourne la valeur de la variable de configuration pass<73>e en param<61>tre.
Si aucun param<61>tre n'est donn<6E>, un tableau de toutes les variables de
configuration charg<72>es est renvoy<6F>.
</para>
<example>
<title>get_config_vars</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.get.config.vars">
<refnamediv>
<refname>get_config_vars</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>array</type><methodname>get_config_vars</methodname>
<methodparam choice="opt"><type>string</type><parameter>varname</parameter></methodparam>
</methodsynopsis>
<para>
Retourne la valeur de la variable de configuration pass<73>e en param<61>tre.
Si aucun param<61>tre n'est donn<6E>, un tableau de toutes les variables de
configuration charg<72>es est retourn<72>.
</para>
<example>
<title>Exemple avec get_config_vars</title>
<programlisting role="php">
<![CDATA[
<?php
// r<>cup<75>re la variable de configuration charg<72>e 'foo'
$foo = $smarty->get_config_vars('foo');
@@ -22,9 +29,13 @@ $foo = $smarty->get_config_vars('foo');
$config_vars = $smarty->get_config_vars();
// les affiche a l'<27>cran
print_r($config_vars);</programlisting>
</example>
</sect1>
print_r($config_vars);
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

62
docs/fr/programmers/api-functions/api-get-registered-object.xml
View File

@@ -1,31 +1,41 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.get.registered.object">
<title>get_registered_object</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>get_registered_object</function></funcdef>
<paramdef>string <parameter>object_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Retourne la r<>f<EFBFBD>rence d'un objet enregistr<74>. Utile quand vous
voulez acc<63>der directement a un objet enregistr<74> avec une
fonction utilisateur.
</para>
<example>
<title>get_registered_object</title>
<programlisting>
function smarty_block_foo($params, &amp;$smarty) {
if (isset[$params['object']]) {
// r<>cup<75>re la r<>f<EFBFBD>rence de l'objet enregistr<74>
$obj_ref =&amp; $smarty->get_registered_object($params['object']);
// $obj_ref est maintenant une r<>f<EFBFBD>rence vers l'objet
}
}</programlisting>
</example>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.get.registered.object">
<refnamediv>
<refname>get_registered_object</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>array</type><methodname>get_registered_object</methodname>
<methodparam><type>string</type><parameter>object_name</parameter></methodparam>
</methodsynopsis>
<para>
Retourne la r<>f<EFBFBD>rence d'un objet enregistr<74>. Utile quand vous
voulez acc<63>der directement <20> un objet enregistr<74> avec une
fonction utilisateur.
</para>
<example>
<title>Exemple avec get_registered_object</title>
<programlisting role="php">
<![CDATA[
<?php
function smarty_block_foo($params, &amp;$smarty)
{
if (isset[$params['object']]) {
// r<>cup<75>re la r<>f<EFBFBD>rence de l'objet enregistr<74>
$obj_ref =&amp; $smarty->get_registered_object($params['object']);
// $obj_ref est maintenant une r<>f<EFBFBD>rence vers l'objet
}
}
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

47
docs/fr/programmers/api-functions/api-get-template-vars.xml
View File

@@ -1,20 +1,27 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.get.template.vars">
<title>get_template_vars</title>
<methodsynopsis>
<type>array</type><methodname>get_template_vars</methodname>
<methodparam choice="opt"><type>string</type><parameter>varname</parameter></methodparam>
</methodsynopsis>
<para>
Retourne la valeur assign<67>e pass<73>e en param<61>tre. Si aucun param<61>tre
n'est donn<6E>, un tableau de toutes les variables assign<67>es est
renvoy<EFBFBD>.
</para>
<example>
<title>get_template_vars</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.get.template.vars">
<refnamediv>
<refname>get_template_vars</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>array</type><methodname>get_template_vars</methodname>
<methodparam choice="opt"><type>string</type><parameter>varname</parameter></methodparam>
</methodsynopsis>
<para>
Retourne la valeur assign<67>e pass<73>e en param<61>tre. Si aucun param<61>tre
n'est donn<6E>, un tableau de toutes les variables assign<67>es est
retourn<72>.
</para>
<example>
<title>Exemple avec get_template_vars</title>
<programlisting role="php">
<![CDATA[
<?php
// r<>cup<75>re la variable 'foo' assign<67>e au template
// get assigned template var 'foo'
$foo = $smarty->get_template_vars('foo');
@@ -23,9 +30,13 @@ $foo = $smarty->get_template_vars('foo');
$tpl_vars = $smarty->get_template_vars();
// les affiche a l'<27>cran
print_r($tpl_vars);</programlisting>
</example>
</sect1>
print_r($tpl_vars);
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

80
docs/fr/programmers/api-functions/api-is-cached.xml
View File

@@ -1,22 +1,26 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: gerald Status: partial -->
<sect1 id="api.is.cached">
<title>is_cached</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>is_cached</function></funcdef>
<paramdef>string <parameter>template</parameter></paramdef>
<paramdef>[string <parameter>cache_id</parameter>]</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Retourne vrai s'il y a un fichier de cache valide pour ce template.
Cela fonctionne seulement si <link
linkend="variable.caching">caching</link> est a vrai.
</para>
<example>
<title>is_cached</title>
<!-- EN-Revision: 1.3 Maintainer: gerald Status: ready -->
<refentry id="api.is.cached">
<refnamediv>
<refname>is_cached</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>bool</type><methodname>is_cached</methodname>
<methodparam><type>string</type><parameter>template</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
</methodsynopsis>
<para>
Retourne &true; s'il y a un fichier de cache valide pour ce template.
Cel<65> fonctionne seulement si <link
linkend="variable.caching">caching</link> est d<>fini <20> <literal>true</literal>.
</para>
<example>
<title>Exemple avec is_cached</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -30,11 +34,11 @@ $smarty->display("index.tpl");
?>
]]>
</programlisting>
</example>
</example>
<para>
Vous pouvez aussi passer en second param<61>tre un identifiant
de cache au cas o<> vous voudriez plusieurs fichiers de cache
pour ce template.
Vous pouvez aussi passer en second param<61>tre un identifiant
de cache au cas o<> vous voudriez plusieurs fichiers de cache
pour ce template.
</para>
<para>
Vous pouvez donner un identifiant de compilation en tant que troisi<73>me param<61>tre.
@@ -45,8 +49,8 @@ $smarty->display("index.tpl");
Si vous voulez utiliser un identifiant de compilation sans utilisez d'identifiant de cache,
mettez <literal>null</literal> pour l'identifiant de cache.
</para>
<example>
<title>is_cached avec plusieurs templates</title>
<example>
<title>Exemple avec is_cached et plusieurs templates</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -60,21 +64,25 @@ $smarty->display("index.tpl", "FrontPage");
?>
]]>
</programlisting>
</example>
</example>
<note>
<title>Note technique</title>
<para>
Si <literal>is_cached</literal> retourne vrai, il charge en fait le cache existant et
le stocke en interne. Tout appel suppl<70>mentaire <20> <link linkend="api.display">display()</link> ou
<link linkend="api.fetch">fetch()</link> retournera ce contenu stock<63> en interne
sans tenter de recharger le fichier en cache. Cela <20>vite des probl<62>matiques d'acc<63>s concurents,
lorsqu'un second processus efface le cache entre l'appel de is_cached et l'appel <20> display dans
l'un de nos exemples ci-dessus. Cela signifie <20>galement que les appels <20> <link linkend="api.clear.cache">clear_cache()</link>
et les changements de param<61>tres du cache peuvent n'avoir aucun effet alors que <literal>is_cached</literal>
<EFBFBD> retourn<72> vrai.
</para>
<title>Note technique</title>
<para>
Si <literal>is_cached</literal> retourne vrai, il charge en fait le cache existant et
le stocke en interne. Tout appel suppl<70>mentaire <20>
<link linkend="api.display">display()</link> ou
<link linkend="api.fetch">fetch()</link> retournera ce contenu stock<63> en interne
sans tenter de recharger le fichier en cache. Cel<EFBFBD> <20>vite des probl<62>matiques d'acc<63>s concurents,
lorsqu'un second processus efface le cache entre l'appel de is_cached et l'appel <20> display
comme dans l'un de nos exemples ci-dessus. Cela signifie <20>galement que les appels <20>
<link linkend="api.clear.cache">clear_cache()</link>
et les changements de param<61>tres du cache peuvent n'avoir aucun effet alors que
<literal>is_cached</literal> a retourn<72> vrai.
</para>
</note>
</sect1>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

55
docs/fr/programmers/api-functions/api-load-filter.xml
View File

@@ -1,30 +1,39 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.load.filter">
<title>load_filter</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>load_filter</function></funcdef>
<paramdef>string <parameter>type</parameter></paramdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Cette fonction peut <20>tre utilis<69>e pour charger un plugin
de filtrage. Le premier argument sp<73>cifie le type du filtre
et peut prendre l'une des valeurs suivantes : 'pre', 'post'
ou 'output'. Le second argument sp<73>cifie le nom du plugin
de filtrage, par exemple 'trim'.
</para>
<example>
<title>Chargement de plugins de filtrage</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.load.filter">
<refnamediv>
<refname>load_filter</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>load_filter</methodname>
<methodparam><type>string</type><parameter>type</parameter></methodparam>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
</methodsynopsis>
<para>
Cette fonction peut <20>tre utilis<69>e pour charger un plugin
de filtrage. Le premier argument sp<73>cifie le type du filtre
et peut prendre l'une des valeurs suivantes : 'pre', 'post'
ou 'output'. Le second argument sp<73>cifie le nom du plugin
de filtrage, par exemple 'trim'.
</para>
<example>
<title>Chargement de plugins de filtrage</title>
<programlisting role="php">
<![CDATA[
<?php
$smarty->load_filter('pre', 'trim'); // charge le filtre 'trim' de type 'pre'
$smarty->load_filter('pre', 'datefooter'); // charge un autre filtre de type 'pre' appel<65> 'datefooter'
$smarty->load_filter('output', 'compress'); // charge le filtre 'compress' de type 'output'</programlisting>
</example>
</sect1>
$smarty->load_filter('output', 'compress'); // charge le filtre 'compress' de type 'output'
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

81
docs/fr/programmers/api-functions/api-register-block.xml
View File

@@ -1,24 +1,47 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.register.block">
<title>register_block</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_block</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
<paramdef>string <parameter>impl</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>clarrer dynamiquement des plugins de fonction
de blocs. Il faut passer en param<61>tre le nom de la fonction
de blocs, suivi du nom de la fonction PHP qui l'impl<70>mente.
</para>
<example>
<title>register_block</title>
<programlisting>
/* PHP */
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
<refentry id="api.register.block">
<refnamediv>
<refname>register_block</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>register_block</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
<methodparam><type>mixed</type><parameter>impl</parameter></methodparam>
<methodparam><type>bool</type><parameter>cacheable</parameter></methodparam>
<methodparam><type>mixed</type><parameter>cache_attrs</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>clarer dynamiquement des plugins de fonction
de blocs. Il faut passer en param<61>tre le nom de la fonction
de blocs, suivi du nom de la fonction PHP qui l'impl<70>mente.
</para>
<para>
La fonction PHP <parameter>impl</parameter> peut <20>tre soit (a) une
cha<68>ne de caract<63>res contenant le nom de la fonction, soit (b) un tableau
de la forme <literal>array(&amp;$object, $method)</literal> o<>
<literal>&amp;$object</literal> est une r<>f<EFBFBD>rence <20> un objet et
<literal>$method</literal> est le nom de la m<>thode, soit (c) un
tableau de la forme <literal>array(&amp;$class, $method)</literal> o<>
<literal>$class</literal> est le nom de la classe et
<literal>$method</literal> est une m<>thode de cette classe.
</para>
<para>
Les param<61>tre <parameter>cacheable</parameter> et
<parameter>cache_attrs</parameter> peuvent <20>tre omis dans la plupart
des cas. Voir <link
linkend="caching.cacheable">Contr<EFBFBD>ler la mise en cache des sorties des Plugins</link>
pour plus d'informations concernant cette utilisation.
</para>
<example>
<title>Exemple avec register_block</title>
<programlisting role="php">
<![CDATA[
<?php
$smarty->register_block("translate", "do_translation");
function do_translation ($params, $content, &amp;$smarty) {
@@ -28,13 +51,23 @@ function do_translation ($params, $content, &amp;$smarty) {
echo $translation;
}
}
?>
]]>
</programlisting>
<para>
Le template Smarty :
</para>
<programlisting>
<![CDATA[
{* template *}
{translate lang="br"}
Hello, world!
{/translate}</programlisting>
</example>
</sect1>
Hello, world!
{/translate}
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

55
docs/fr/programmers/api-functions/api-register-compiler-function.xml
View File

@@ -1,22 +1,43 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.register.compiler.function">
<title>register_compiler_function</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_compiler_function</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
<paramdef>string <parameter>impl</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>clarer dynamiquement un plugin de fonction
de compilation. Il faut passer en param<61>tres le nom de la fonction
de compilation, suivi par la fonction PHP qui
l'impl<70>mente.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.register.compiler.function">
<refnamediv>
<refname>register_compiler_function</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>bool</type><methodname>register_compiler_function</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
<methodparam><type>mixed</type><parameter>impl</parameter></methodparam>
<methodparam><type>bool</type><parameter>cacheable</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>clarer dynamiquement un plugin de fonction
de compilation. Il faut passer en param<61>tres le nom de la fonction
de compilation, suivi par la fonction PHP qui
l'impl<70>mente.
</para>
<para>
La fonction PHP <parameter>impl</parameter> peut <20>tre soit (a) une
cha<68>ne de caract<63>res contenant le nom de la fonction, soit (b) un tableau
de la forme <literal>array(&amp;$object, $method)</literal> o<>
<literal>&amp;$object</literal> est une r<>f<EFBFBD>rence <20> un objet et
<literal>$method</literal> est le nom de la m<>thode, soit (c) un
tableau de la forme <literal>array(&amp;$class, $method)</literal> o<>
<literal>$class</literal> est le nom de la classe et
<literal>$method</literal> est une m<>thode de cette classe.
</para>
<para>
Le param<61>tre <parameter>cacheable</parameter> peut <20>tre omis dans la
plupart des cas. Voir <link
linkend="caching.cacheable">Contr<EFBFBD>ler la mise en cache des sorties des Plugins</link>
pour plus d'informations concernant cette utilisation.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

70
docs/fr/programmers/api-functions/api-register-function.xml
View File

@@ -1,23 +1,47 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.register.function">
<title>register_function</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_function</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
<paramdef>string <parameter>impl</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>clarer dynamiquement des plugins de fonction
de templates. Il faut passer en param<61>tres le nom de la fonction
de templates, suivi par le nom de la fonction PHP qui l'impl<70>mente.
</para>
<example>
<title>register_function</title>
<programlisting>
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
<refentry id="api.register.function">
<refnamediv>
<refname>register_function</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>register_function</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
<methodparam><type>mixed</type><parameter>impl</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>cacheable</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>cache_attrs</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>clarer dynamiquement des plugins de fonction
de templates. Il faut passer en param<61>tres le nom de la fonction
de templates, suivi par le nom de la fonction PHP qui l'impl<70>mente.
</para>
<para>
La fonction PHP <parameter>impl</parameter> peut <20>tre soit (a) une
cha<68>ne de caract<63>res contenant le nom de la fonction, soit (b) un tableau
de la forme <literal>array(&amp;$object, $method)</literal> o<>
<literal>&amp;$object</literal> est une r<>f<EFBFBD>rence <20> un objet et
<literal>$method</literal> est le nom de la m<>thode, soit (c) un
tableau de la forme <literal>array(&amp;$class, $method)</literal> o<>
<literal>$class</literal> est le nom de la classe et
<literal>$method</literal> est une m<>thode de cette classe.
</para>
<para>
Les param<61>tres <parameter>cacheable</parameter> et
<parameter>cache_attrs</parameter> peut <20>tre omis dans la
plupart des cas. Voir <link
linkend="caching.cacheable">Contr<EFBFBD>ler la mise en cache des sorties des Plugins</link>
pour plus d'informations concernant cette utilisation.
</para>
<example>
<title>Exemple avec register_function</title>
<programlisting role="php">
<![CDATA[
<?php
$smarty->register_function("date_now", "print_current_date");
function print_current_date ($params) {
@@ -29,9 +53,13 @@ function print_current_date ($params) {
// vous pouvez maintenant utiliser ceci dans Smarty pour afficher
// la date actuelle : {date_now} ou {date_now format="%Y/%m/%d"}
// pour la formater</programlisting>
</example>
</sect1>
// pour la formater
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

61
docs/fr/programmers/api-functions/api-register-modifier.xml
View File

@@ -1,30 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.register.modifier">
<title>register_modifier</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_modifier</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
<paramdef>string <parameter>impl</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>clarer dynamiquement un plugin de modificateur.
Il faut passer en param<61>tre le nom du modificateur de variables,
suivi de la fonction PHP qui l'impl<70>mente.
</para>
<example>
<title>register_modifier</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.register.modifier">
<refnamediv>
<refname>register_modifier</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>register_modifier</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
<methodparam><type>mixed</type><parameter>impl</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>clarer dynamiquement un plugin de modificateur.
Il faut passer en param<61>tre le nom du modificateur de variables,
suivi de la fonction PHP qui l'impl<70>mente.
</para>
<para>
La fonction PHP <parameter>impl</parameter> peut <20>tre soit (a) une
cha<68>ne de caract<63>res contenant le nom de la fonction, soit (b) un tableau
de la forme <literal>array(&amp;$object, $method)</literal> o<>
<literal>&amp;$object</literal> est une r<>f<EFBFBD>rence <20> un objet et
<literal>$method</literal> est le nom de la m<>thode, soit (c) un
tableau de la forme <literal>array(&amp;$class, $method)</literal> o<>
<literal>$class</literal> est le nom de la classe et
<literal>$method</literal> est une m<>thode de cette classe.
</para>
<example>
<title>register_modifier</title>
<programlisting role="php">
<![CDATA[
<?php
// associons la fonction PHP stripslashes a un modificateur Smarty.
$smarty->register_modifier("sslash","stripslashes");
// vous pouvez maintenant utiliser {$var|sslash} pour supprimer les slash des variables</programlisting>
</example>
</sect1>
// vous pouvez maintenant utiliser {$var|sslash} pour supprimer les slash des variables
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

39
docs/fr/programmers/api-functions/api-register-object.xml
View File

@@ -1,24 +1,29 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.register.object">
<title>register_object</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_object</function></funcdef>
<paramdef>string <parameter>object_name</parameter></paramdef>
<paramdef>object <parameter>$object</parameter></paramdef>
<paramdef>array <parameter>allowed methods/properties</parameter></paramdef>
<paramdef>boolean <parameter>format</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour enregistrer un objet a utiliser dans un template.
Reportez-vous a la section
<link linkend="advanced.features.objects">objet</link> de
<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
<refentry id="api.register.object">
<refnamediv>
<refname>register_object</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>register_object</methodname>
<methodparam><type>string</type><parameter>object_name</parameter></methodparam>
<methodparam><type>object</type><parameter>object</parameter></methodparam>
<methodparam><type>array</type><parameter>allowed_methods_properties</parameter></methodparam>
<methodparam><type>boolean</type><parameter>format</parameter></methodparam>
<methodparam><type>array</type><parameter>block_methods</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour enregistrer un objet <20> utiliser dans un template.
Reportez-vous a la section
<link linkend="advanced.features.objects">objet</link> de
ce manuel pour des exemples.
</para>
</sect1>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

46
docs/fr/programmers/api-functions/api-register-outputfilter.xml
View File

@@ -1,21 +1,35 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.register.outputfilter">
<title>register_outputfilter</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_outputfilter</function></funcdef>
<paramdef>string <parameter>function_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>clarer dynamiquement des filtres de sortie, pour
agir sur la sortie d'un template avant qu'elle ne soit affich<63>e.
Reportez-vous a la section <link linkend="advanced.features.outputfilters">
filtres de sortie</link> pour plus d'information sur le sujet.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.register.outputfilter">
<refnamediv>
<refname>register_outputfilter</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>register_outputfilter</methodname>
<methodparam><type>mixed</type><parameter>function</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>clarer dynamiquement des filtres de sortie, pour
agir sur la sortie d'un template avant qu'il ne soit affich<63>.
Reportez-vous <20> la section <link linkend="advanced.features.outputfilters">
filtres de sortie</link> pour plus d'information sur le sujet.
</para>
<para>
La fonction PHP <parameter>function</parameter> peut <20>tre soit (a) une
cha<68>ne de caract<63>res contenant le nom de la fonction, soit (b) un tableau
de la forme <literal>array(&amp;$object, $method)</literal> o<>
<literal>&amp;$object</literal> est une r<>f<EFBFBD>rence <20> un objet et
<literal>$method</literal> est le nom de la m<>thode, soit (c) un
tableau de la forme <literal>array(&amp;$class, $method)</literal> o<>
<literal>$class</literal> est le nom de la classe et
<literal>$method</literal> est une m<>thode de cette classe.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

46
docs/fr/programmers/api-functions/api-register-postfilter.xml
View File

@@ -1,23 +1,37 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.register.postfilter">
<title>register_postfilter</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_postfilter</function></funcdef>
<paramdef>string <parameter>function_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>clarer dynamiquement des filtres de post-compilation pour y faire
passer des templates une fois qu'ils ont <20>t<EFBFBD> compil<69>s. Reportez-vous
a la section
<link linkend="advanced.features.postfilters">filtres de post-compilation de templates</link>
pour avoir plus de renseignements sur la faton de param<61>trer les fonctions
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.register.postfilter">
<refnamediv>
<refname>register_postfilter</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>register_postfilter</methodname>
<methodparam><type>mixed</type><parameter>function</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>clarer dynamiquement des filtres de post-compilation pour y faire
passer des templates une fois qu'ils ont <20>t<EFBFBD> compil<69>s. Reportez-vous
<20> la section
<link linkend="advanced.features.postfilters">filtres de post-compilation de templates</link>
pour avoir plus de renseignements sur la fa<66>on de param<61>trer les fonctions
de post-compilation.
</para>
</sect1>
<para>
La fonction PHP <parameter>function</parameter> peut <20>tre soit (a) une
cha<68>ne de caract<63>res contenant le nom de la fonction, soit (b) un tableau
de la forme <literal>array(&amp;$object, $method)</literal> o<>
<literal>&amp;$object</literal> est une r<>f<EFBFBD>rence <20> un objet et
<literal>$method</literal> est le nom de la m<>thode, soit (c) un
tableau de la forme <literal>array(&amp;$class, $method)</literal> o<>
<literal>$class</literal> est le nom de la classe et
<literal>$method</literal> est une m<>thode de cette classe.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

46
docs/fr/programmers/api-functions/api-register-prefilter.xml
View File

@@ -1,23 +1,37 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.register.prefilter">
<title>register_prefilter</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_prefilter</function></funcdef>
<paramdef>string <parameter>function_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>clarer dynamiquement des filtres de pr<70>-compilation pour y faire
passer des templates avant qu'ils ne soient compil<69>s. Reportez-vous
a la section
<link linkend="advanced.features.postfilters">filtres de pr<70>-compilation de templates</link>
pour avoir plus de renseignements sur la faton de param<61>trer les fonctions
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.register.prefilter">
<refnamediv>
<refname>register_prefilter</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>register_prefilter</methodname>
<methodparam><type>mixed</type><parameter>function</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>clarer dynamiquement des filtres de pr<70>-compilation pour y faire
passer des templates avant qu'ils ne soient compil<69>s. Reportez-vous
<20> la section
<link linkend="advanced.features.postfilters">filtres de pr<70>-compilation de templates</link>
pour avoir plus de renseignements sur la fa<66>on de param<61>trer les fonctions
de pr<70>-compilation.
</para>
</sect1>
<para>
La fonction PHP <parameter>function</parameter> peut <20>tre soit (a) une
cha<68>ne de caract<63>res contenant le nom de la fonction, soit (b) un tableau
de la forme <literal>array(&amp;$object, $method)</literal> o<>
<literal>&amp;$object</literal> est une r<>f<EFBFBD>rence <20> un objet et
<literal>$method</literal> est le nom de la m<>thode, soit (c) un
tableau de la forme <literal>array(&amp;$class, $method)</literal> o<>
<literal>$class</literal> est le nom de la classe et
<literal>$method</literal> est une m<>thode de cette classe.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

81
docs/fr/programmers/api-functions/api-register-resource.xml
View File

@@ -1,32 +1,61 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.register.resource">
<title>register_resource</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>register_resource</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
<paramdef>array <parameter>resource_funcs</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>clarer dynamiquement une ressource plugin
dans Smarty. Il faut passer en param<61>tre le nom de la ressource
et le tableau des fonctions PHP qui l'impl<70>mentent. Reportez-vous
a la section <link linkend="template.resources">ressources templates</link>
pour avoir plus d'informations sur la faton de param<61>trer une fonction
r<EFBFBD>cup<EFBFBD>rant des templates.
</para>
<example>
<title>register_resource</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.register.resource">
<refnamediv>
<refname>register_resource</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>register_resource</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
<methodparam><type>array</type><parameter>resource_funcs</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>clarer dynamiquement une ressource plugin
dans Smarty. Il faut passer en param<61>tre le nom de la ressource
et le tableau des fonctions PHP qui l'impl<70>mentent. Reportez-vous
a la section <link linkend="template.resources">ressources templates</link>
pour avoir plus d'informations sur la faton de param<61>trer une fonction
r<>cup<75>rant des templates.
</para>
<note>
<title>Note technique</title>
<para>
Un nom de ressource doit <20>tre compos<6F> d'au moins deux caract<63>res.
Les noms de ressources d'un seul caract<63>re seront ignor<6F>s et utilis<69>s
comme <20>tant une partie du chemin du fichier, comme avec
$smarty->display('c:/path/to/index.tpl');
</para>
</note>
<para>
Le tableau de fonctions PHP <parameter>resource_funcs</parameter>
doit <20>tre compos<6F> de 4 ou 5 <20>l<EFBFBD>ments. S'il est compos<6F> de 4 <20>l<EFBFBD>ments,
les <20>l<EFBFBD>ments seront les noms de fonctions pour, respectivement,
"source", "timestamp", "secure" et "trusted" de la ressource.
S'il est compos<6F> de 5 <20>l<EFBFBD>ments, le premier <20>l<EFBFBD>ment devra <20>tre une
r<>f<EFBFBD>rence sur un objet ou le nom d'une classe de l'objet ou une classe
impl<70>mentant la ressource et les 4 <20>l<EFBFBD>ments suivants doivent <20>tre
les noms des m<>thodes impl<70>mentant "source", "timestamp",
"secure" et "trusted".
</para>
<example>
<title>Exemple avec register_resource</title>
<programlisting role="php">
<![CDATA[
<?php
$smarty->register_resource("db", array("db_get_template",
"db_get_timestamp",
"db_get_secure",
"db_get_trusted"));</programlisting>
</example>
</sect1>
"db_get_timestamp",
"db_get_secure",
"db_get_trusted"));
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

34
docs/fr/programmers/api-functions/api-template-exists.xml
View File

@@ -1,20 +1,24 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.template.exists">
<title>template_exists</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>template_exists</function></funcdef>
<paramdef>string <parameter>template</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Cette fonction v<>rifie si le template sp<73>cifi<66> existe. Elle accepte
soit un chemin vers le template, soit une ressource de type
chaene de caract<63>res pr<70>cisant le nom du template.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.template.exists">
<refnamediv>
<refname>template_exists</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>bool</type><methodname>template_exists</methodname>
<methodparam><type>string</type><parameter>template</parameter></methodparam>
</methodsynopsis>
<para>
Cette fonction v<>rifie si le template sp<73>cifi<66> existe. Elle accepte
soit un chemin vers le template, soit une ressource de type
cha<68>ne de caract<63>res sp<73>cifiant le nom du template.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

40
docs/fr/programmers/api-functions/api-trigger-error.xml
View File

@@ -1,23 +1,27 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.trigger.error">
<title>trigger_error</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>trigger_error</function></funcdef>
<paramdef>string <parameter>error_msg</parameter></paramdef>
<paramdef>[int <parameter>level</parameter>]</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Cette fonction peut-<2D>tre utilis<69>e pour afficher un message d'erreur
en utilisant Smarty. Le param<61>tre <parameter>level</parameter>
peut prendre l'une des valeures utilis<69>es par la fonction PHP
trigger_error, i.e. E_USER_NOTICE, E_USER_WARNING, etc. Par d<>faut
il s'agit de E_USER_WARNING.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.trigger.error">
<refnamediv>
<refname>trigger_error</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>trigger_error</methodname>
<methodparam><type>string</type><parameter>error_msg</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>level</parameter></methodparam>
</methodsynopsis>
<para>
Cette fonction peut-<2D>tre utilis<69>e pour afficher un message d'erreur
en utilisant Smarty. Le param<61>tre <parameter>level</parameter>
peut prendre l'une des valeures utilis<69>es par la fonction PHP
trigger_error(), i.e. E_USER_NOTICE, E_USER_WARNING, etc. Par d<>faut
il s'agit de E_USER_WARNING.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

32
docs/fr/programmers/api-functions/api-unregister-block.xml
View File

@@ -1,19 +1,23 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.unregister.block">
<title>unregister_block</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>unregister_block</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>sallouer dynamiquement un plugin de fonction
de blocs. Passez en param<61>tre le nom du bloc.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.unregister.block">
<refnamediv>
<refname>unregister_block</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>unregister_block</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>sallouer dynamiquement un plugin de fonction
de blocs. Passez en param<61>tre le nom <parameter>name</parameter> du bloc.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

33
docs/fr/programmers/api-functions/api-unregister-compiler-function.xml
View File

@@ -1,19 +1,24 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.unregister.compiler.function">
<title>unregister_compiler_function</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>unregister_compiler_function</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>sallouer dynamiquement un fonction de compilation.
Passez en param<61>tre le nom de la fonction de compilation.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.unregister.compiler.function">
<refnamediv>
<refname>unregister_compiler_function</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>unregister_compiler_function</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>sallouer dynamiquement un fonction de compilation.
Passez en param<61>tre le nom <parameter>name</parameter> de
la fonction de compilation.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

47
docs/fr/programmers/api-functions/api-unregister-function.xml
View File

@@ -1,27 +1,36 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.unregister.function">
<title>unregister_function</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>unregister_function</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>sallouer dynamiquement un plugin de fonction
de templates. Passez en param<61>tres le nom de la fonction de templates.
</para>
<example>
<title>unregister_function</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.unregister.function">
<refnamediv>
<refname>unregister_function</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>unregister_function</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>sallouer dynamiquement un plugin de fonction
de templates. Passez en param<61>tres le nom de la fonction de templates.
</para>
<example>
<title>Exemple avec unregister_function</title>
<programlisting role="php">
<![CDATA[
<?php
// nous ne voulons pas que les designers de templates aient acc<63>s
// au syst<73>me de fichiers.
$smarty->unregister_function("fetch");</programlisting>
</example>
</sect1>
$smarty->unregister_function("fetch");
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

47
docs/fr/programmers/api-functions/api-unregister-modifier.xml
View File

@@ -1,27 +1,36 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.unregister.modifier">
<title>unregister_modifier</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>unregister_modifier</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>sallouer dynamiquement un plugin modificateur de variable.
Passez en param<61>tre le nom du modificateur de templates.
</para>
<example>
<title>unregister_modifier</title>
<programlisting>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.unregister.modifier">
<refnamediv>
<refname>unregister_modifier</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>unregister_modifier</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>sallouer dynamiquement un plugin modificateur de variable.
Passez en param<61>tre le nom du modificateur de templates.
</para>
<example>
<title>Exemple avec unregister_modifier</title>
<programlisting role="php">
<![CDATA[
<?php
// nous ne voulons pas que les designers de templates
// suppriment les balises des <20>lements
$smarty->unregister_modifier("strip_tags");</programlisting>
</example>
</sect1>
$smarty->unregister_modifier("strip_tags");
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

30
docs/fr/programmers/api-functions/api-unregister-object.xml
View File

@@ -1,18 +1,22 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.unregister.object">
<title>unregister_object</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>unregister_object</function></funcdef>
<paramdef>string <parameter>object_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>sallouer un objet.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.unregister.object">
<refnamediv>
<refname>unregister_object</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>unregister_object</methodname>
<methodparam><type>string</type><parameter>object_name</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>sallouer un objet.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

30
docs/fr/programmers/api-functions/api-unregister-outputfilter.xml
View File

@@ -1,18 +1,22 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.unregister.outputfilter">
<title>unregister_outputfilter</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>unregister_outputfilter</function></funcdef>
<paramdef>string <parameter>function_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>sallouer dynamiquement un filtre de sortie.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.unregister.outputfilter">
<refnamediv>
<refname>unregister_outputfilter</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>unregister_outputfilter</methodname>
<methodparam><type>string</type><parameter>function_name</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>sallouer dynamiquement un filtre de sortie.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

30
docs/fr/programmers/api-functions/api-unregister-postfilter.xml
View File

@@ -1,18 +1,22 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.unregister.postfilter">
<title>unregister_postfilter</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>unregister_postfilter</function></funcdef>
<paramdef>string <parameter>function_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>sallouer dynamiquement un filtre de post-compilation.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.unregister.postfilter">
<refnamediv>
<refname>unregister_postfilter</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>unregister_postfilter</methodname>
<methodparam><type>string</type><parameter>function_name</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>sallouer dynamiquement un filtre de post-compilation.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

30
docs/fr/programmers/api-functions/api-unregister-prefilter.xml
View File

@@ -1,18 +1,22 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.unregister.prefilter">
<title>unregister_prefilter</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>unregister_prefilter</function></funcdef>
<paramdef>string <parameter>function_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>sallouer dynamiquement un filtre de pr<70>-compilation.
</para>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.unregister.prefilter">
<refnamediv>
<refname>unregister_prefilter</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>unregister_prefilter</methodname>
<methodparam><type>string</type><parameter>function_name</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>sallouer dynamiquement un filtre de pr<70>-compilation.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

47
docs/fr/programmers/api-functions/api-unregister-resource.xml
View File

@@ -1,24 +1,33 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="api.unregister.resource">
<title>unregister_resource</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>unregister_resource</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Utilis<EFBFBD>e pour d<>sallouer dynamiquement un plugin ressource.
Passez en param<61>tre le nom de la ressource.
</para>
<example>
<title>unregister_resource</title>
<programlisting>
$smarty->unregister_resource("db");</programlisting>
</example>
</sect1>
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<refentry id="api.unregister.resource">
<refnamediv>
<refname>unregister_resource</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect1>
<title />
<methodsynopsis>
<type>void</type><methodname>unregister_resource</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
</methodsynopsis>
<para>
Utilis<69>e pour d<>sallouer dynamiquement un plugin ressource.
Passez en param<61>tre le nom de la ressource.
</para>
<example>
<title>Exemple avec unregister_resource</title>
<programlisting role="php">
<![CDATA[
<?php
$smarty->unregister_resource("db");
?>
]]>
</programlisting>
</example>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml