sync with EN

This commit is contained in:
yannick
2006-10-01 11:18:39 +00:00
parent 2a9b76d540
commit 7e4778f53c
6 changed files with 177 additions and 151 deletions

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.10 Maintainer: gerald Status: ready -->
<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
<sect1 id="language.function.include.php">
<title>{include_php}</title>
@@ -8,13 +8,13 @@
<note>
<title>Notes techniques</title>
<para>
{include_php} est presque obsol<6F>te dans Smarty. Vous pouvez obtenir des r<>sultats
<20>quivalents en utilisant les fonctions utilisateur.
La seule raison qui peut vous pousser <20> utiliser {include_php} est que
vous avez besoin de mettre une de vos fonction en quarantaine vis <20> vis du
r<>pertoire des <link linkend="variable.plugins.dir">plugins</link> ou de votre application.
Reportez-vous <20> l'exemple des
<link linkend="tips.componentized.templates"> templates composants</link>
<varname>{include_php}</varname> est presque obsol<6F>te dans Smarty.
Vous pouvez obtenir des r<>sultats <EFBFBD>quivalents en utilisant les fonctions utilisateur.
La seule raison qui peut vous pousser <20> utiliser <varname>{include_php}</varname>
est que vous avez besoin de mettre une de vos fonction en quarantaine vis <20> vis du
r<>pertoire <link linkend="variable.plugins.dir"><filename>plugins/</filename></link>
ou de votre application. Reportez-vous <20> l'exemple des
<link linkend="tips.componentized.templates">templates composants</link>
pour plus de d<>tails.
</para>
</note>
@@ -47,7 +47,7 @@
<entry>once</entry>
<entry>bol<EFBFBD>en</entry>
<entry>Non</entry>
<entry><emphasis>true</emphasis></entry>
<entry><emphasis>&true;</emphasis></entry>
<entry>Inclure plusieurs fois ou non le fichier PHP si
plusieurs demandes d'inclusions sont fa<66>tes.</entry>
</row>
@@ -64,33 +64,35 @@
</informaltable>
<para>
Les balises {include_php} sont utilis<69>es pour inclure directement
un script PHP dans vos templates. Si <link linkend="variable.security">$security</link> est activ<69>,
alors le script <20> ex<65>cuter doit <20>tre plac<61> dans le chemin <link
linkend="variable.trusted.dir">$trusted_dir</link>. La balise
{include_php} attends l'attribut "file", qui contient le chemin du
fichier PHP <20> inclure, relatif <20> <link linkend="variable.trusted.dir">$trusted_dir</link>, ou absolu.
Les balises <varname>{include_php}</varname> sont utilis<69>es pour inclure directement
un script PHP dans vos templates. Si
<link linkend="variable.security"><parameter>$security</parameter></link> est activ<69>,
alors le script <20> ex<65>cuter doit <20>tre plac<61> dans le chemin
<link linkend="variable.trusted.dir"><parameter>$trusted_dir</parameter></link>. La balise
<varname>{include_php}</varname> attends l'attribut <parameter>file</parameter>,
qui contient le chemin du fichier PHP <20> inclure, relatif <20>
<link linkend="variable.trusted.dir"><parameter>$trusted_dir</parameter></link>, ou absolu.
</para>
<para>
Par d<>faut, les fichiers PHP ne sont inclus qu'une seule fois, m<>me si
la demande d'inclusion survient plusieurs fois dans le template.
Vous pouvez demander <20> ce que ce fichier soit inclus <20> chaque demande
gr<67>ce <20> l'attribut <emphasis>once</emphasis>. Mettre l'attribut once <20>
false aura pour effet d'inclure le script PHP <20> chaque fois que demand<6E>
gr<67>ce <20> l'attribut <parameter>once</parameter>. Mettre l'attribut once <20>
&false; aura pour effet d'inclure le script PHP <20> chaque fois que demand<6E>
dans le template.
</para>
<para>
Vous pouvez donner une valeur <20> l'attribut optionnel
<emphasis>assign</emphasis>, pour demander <20> la fonction
<emphasis>{include_php}</emphasis> d'assigner la sortie du script PHP
<parameter>assign</parameter>, pour demander <20> la fonction
<varname>{include_php}</varname> d'assigner la sortie du script PHP
<20> la variable sp<73>cifi<66>e plut<75>t que d'en afficher directement le r<>sultat.
</para>
<para>
L'objet Smarty est disponible en tant que $this dans le script PHP inclus.
L'objet Smarty est disponible en tant que <parameter>$this</parameter> dans le script PHP inclus.
</para>
<example>
<title>Fonction {include_php}</title>
<para>load_nav.php</para>
<para>Le template <filename>load_nav.php</filename></para>
<programlisting role="php">
<![CDATA[
<?php
@@ -105,14 +107,14 @@ $this->assign('sections',$sql->record);
]]>
</programlisting>
<para>
O<> index.tpl est :
O<> le template est :
</para>
<programlisting>
<![CDATA[
{* chemin absolu, ou relatif <20> $trusted_dir *}
{include_php file='/chemin/vers/load_nav.php'}
{foreach item="curr_section" from=$sections}
{foreach item='curr_section' from=$sections}
<a href="{$curr_section.url}">{$curr_section.name}</a><br />
{/foreach}
]]>
@@ -121,11 +123,11 @@ $this->assign('sections',$sql->record);
<para>
Voir aussi
<link linkend="language.function.include">{include}</link>,
<link linkend="language.function.php">{php}</link>,
<link linkend="language.function.capture">{capture}</link>, les
<link linkend="language.function.include"><varname>{include}</varname></link>,
<link linkend="language.function.php"><varname>{php}</varname></link>,
<link linkend="language.function.capture"><varname>{capture}</varname></link>, les
<link linkend="template.resources">ressources de template</link> et les
<link linkend="tips.componentized.templates">"composants templates"</link>.
<link linkend="tips.componentized.templates">composants de templates</link>.
</para>
</sect1>