mirror of
https://github.com/smarty-php/smarty.git
synced 2025-08-05 19:04:27 +02:00
sync with EN
#Hello all ;)
This commit is contained in:
yannick
@@ -1,6 +1,6 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.3 Maintainer: didou Status: ready -->
|
||||
<!-- EN-Revision: 1.4 Maintainer: didou Status: ready -->
|
||||
<chapter id="resources">
|
||||
<title>Ressources</title>
|
||||
<para>
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.4 Maintainer: didou Status: ready -->
|
||||
<!-- EN-Revision: 1.5 Maintainer: didou Status: ready -->
|
||||
<chapter id="tips">
|
||||
<title>Trucs et astuces</title>
|
||||
<para></para>
|
||||
@@ -47,11 +47,14 @@
|
||||
<example>
|
||||
<title>assigner une valeur par d<>faut <20> une variable de template</title>
|
||||
<programlisting>
|
||||
{* faites cela qq part en haut de votre template *}
|
||||
<![CDATA[
|
||||
{* faites cela quelque part en haut de votre template *}
|
||||
{assign var="title" value=$title|default:"no title"}
|
||||
|
||||
{* si $title est vide, il contiendra alors no "no title" *}
|
||||
{$title}</programlisting>
|
||||
{* si $title est vide, il contiendra alors la valeur "no title" *}
|
||||
{$title}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect1>
|
||||
<sect1 id="tips.passing.vars">
|
||||
@@ -65,7 +68,7 @@
|
||||
<example>
|
||||
<title>passer le titre au template d'en-t<>te</title>
|
||||
<programlisting>
|
||||
|
||||
<![CDATA[
|
||||
mainpage.tpl
|
||||
------------
|
||||
|
||||
@@ -85,17 +88,19 @@ archives.tpl
|
||||
|
||||
header.tpl
|
||||
----------
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>{$title|default:"BC News"}</TITLE>
|
||||
</HEAD>
|
||||
<BODY>
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>{$title|default:"BC News"}</TITLE>
|
||||
</HEAD>
|
||||
<BODY>
|
||||
|
||||
|
||||
footer.tpl
|
||||
----------
|
||||
</BODY>
|
||||
</HTML></programlisting>
|
||||
</BODY>
|
||||
</HTML>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
<para>
|
||||
Quand la page principale est con<6F>ue, le titre "Main page" est pass<73> <20> header.tpl
|
||||
@@ -115,31 +120,48 @@ footer.tpl
|
||||
pour avoir un contr<74>le total sur le formatage des dates et de comparer
|
||||
facilement les dates entre elles.
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
NOTE : <20> partir Smarty 1.4.0, vous pouvez passer les dates <20> Smarty
|
||||
A partir Smarty 1.4.0, vous pouvez passer les dates <20> Smarty
|
||||
sous la forme de timestamps Unix ou MySQL, ou tout autre format de dates
|
||||
que comprend strtotime().
|
||||
</para>
|
||||
</note>
|
||||
<example>
|
||||
<title>utilisation de date_format</title>
|
||||
<title>Utilisation de date_format</title>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{$startDate|date_format}
|
||||
|
||||
OUTPUT:
|
||||
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Affichera :
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
Jan 4, 2001
|
||||
|
||||
|
||||
]]>
|
||||
</screen>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{$startDate|date_format:"%Y/%m/%d"}
|
||||
|
||||
OUTPUT:
|
||||
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
Affichera :
|
||||
</para>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
2001/01/04
|
||||
|
||||
|
||||
{if $date1 < $date2}
|
||||
]]>
|
||||
</screen>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{if $date1 < $date2}
|
||||
...
|
||||
{/if}</programlisting>
|
||||
{/if}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
<para>
|
||||
En utilisant la fonction {html_select_date} dans un template, le programmeur
|
||||
@@ -147,8 +169,11 @@ OUTPUT:
|
||||
Voici une fonction qui devrait vous <20>tre utile.
|
||||
</para>
|
||||
<example>
|
||||
<title>conversion des <20>l<EFBFBD>ments date d'un formulaire en timestamp</title>
|
||||
<programlisting>
|
||||
<title>Conversion des <20>l<EFBFBD>ments date d'un formulaire en timestamp</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
// cela suppose que vos <20>l<EFBFBD>ments de formulaire soient nomm<6D>s
|
||||
// startDate_Day, startDate_Month, startDate_Year
|
||||
|
||||
@@ -156,15 +181,21 @@ $startDate = makeTimeStamp($startDate_Year,$startDate_Month,$startDate_Day);
|
||||
|
||||
function makeTimeStamp($year="", $month="", $day="")
|
||||
{
|
||||
if(empty($year))
|
||||
if(empty($year)) {
|
||||
$year = strftime("%Y");
|
||||
if(empty($month))
|
||||
}
|
||||
if(empty($month)) {
|
||||
$month = strftime("%m");
|
||||
if(empty($day))
|
||||
}
|
||||
if(empty($day)) {
|
||||
$day = strftime("%d");
|
||||
}
|
||||
|
||||
return mktime(0, 0, 0, $month, $day, $year);
|
||||
}</programlisting>
|
||||
}
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect1>
|
||||
<sect1 id="tips.wap">
|
||||
@@ -180,52 +211,62 @@ function makeTimeStamp($year="",$month="",$day="")
|
||||
la modification de l'en-t<>te <20>chouera.
|
||||
</para>
|
||||
<example>
|
||||
<title>utilisation d'insert pour <20>crire un en-t<>te Content-Type WML</title>
|
||||
<programlisting>
|
||||
<title>Utilisation d'insert pour <20>crire un en-t<>te Content-Type WML</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
// assurez-vous que Apache est configur<75> pour les extensions .wml !
|
||||
// mettez cette fonction qq part dans votre applications
|
||||
// mettez cette fonction quelque part dans votre applications
|
||||
// ou dans Smarty.addons.php
|
||||
function insert_header() {
|
||||
function insert_header()
|
||||
{
|
||||
// cette fonction attend un argument $content
|
||||
extract(func_get_arg(0));
|
||||
if(empty($content))
|
||||
if (empty($params['content'])) {
|
||||
return;
|
||||
header($content);
|
||||
}
|
||||
header($params['content']);
|
||||
return;
|
||||
}
|
||||
|
||||
// votre template Smarty DOIT commencer avec la balise d'insertion
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<para>
|
||||
votre template Smarty <emphasis>doit</emphasis> commencer avec la balise d'insertion :
|
||||
</para>
|
||||
<programlisting>
|
||||
<![CDATA[
|
||||
{insert name=header content="Content-Type: text/vnd.wap.wml"}
|
||||
|
||||
<?xml version="1.0"?>
|
||||
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
|
||||
<?xml version="1.0"?>
|
||||
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml">
|
||||
|
||||
<!-- begin new wml deck -->
|
||||
<wml>
|
||||
<!-- begin first card -->
|
||||
<card>
|
||||
<do type="accept">
|
||||
<go href="#two"/>
|
||||
</do>
|
||||
<p>
|
||||
<!-- begin new wml deck -->
|
||||
<wml>
|
||||
<!-- begin first card -->
|
||||
<card>
|
||||
<do type="accept">
|
||||
<go href="#two"/>
|
||||
</do>
|
||||
<p>
|
||||
Welcome to WAP with Smarty!
|
||||
Press OK to continue...
|
||||
</p>
|
||||
</card>
|
||||
<!-- begin second card -->
|
||||
<card id="two">
|
||||
<p>
|
||||
</p>
|
||||
</card>
|
||||
<!-- begin second card -->
|
||||
<card id="two">
|
||||
<p>
|
||||
Pretty easy isn't it?
|
||||
</p>
|
||||
</card>
|
||||
</wml></programlisting>
|
||||
</p>
|
||||
</card>
|
||||
</wml>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect1>
|
||||
<sect1 id="tips.componentized.templates">
|
||||
<title>Templates composants</title>
|
||||
<para>
|
||||
Cette astuce tient plus du hack qu'autre chose mais n'en demeure pas
|
||||
moins une id<69>e plut<75>t chouette. Utilisez-la <20> vos propres risques. ;-)
|
||||
</para>
|
||||
<para>
|
||||
Traditionnellemnt, la programmation avec des templates dans les applications
|
||||
se d<>roule de la fa<66>on suivante : d'abord vous r<>cup<75>rez vos variables
|
||||
@@ -236,101 +277,69 @@ Pretty easy isn't it?
|
||||
puis les assignerions ensuite pour les afficher. Mais ne serait-ce pas
|
||||
mieux de pouvoir ajouter ce t<>l<EFBFBD>scripteur <20> n'importe quelle application
|
||||
en incluant directement le template sans avoir <20> se soucier de la r<>cup<75>ration
|
||||
des donn<6E>es.
|
||||
des donn<6E>es ?
|
||||
</para>
|
||||
<para>
|
||||
Vous pouvez int<EFBFBD>grer du PHP dans vos templates avec les balises
|
||||
{php}{/php}. Avec cette m<>thode, vous pouvez inclure des templates complets,
|
||||
dans la mesure o<> ils r<>cup<75>rent leurs propres donn<6E>es pour les assigner
|
||||
<20> leurs propres variables. Avec le traitement int<6E>gr<67>
|
||||
de cette fa<66>on, vous pouvez garder le template et le traitement ensemble.
|
||||
Ainsi, on ne se soucie plus d'o<> vient le contenu du template,
|
||||
tout vient comme un seul et unique composant.
|
||||
Vous pouvez r<EFBFBD>aliser cel<65> en <20>crivant un plugin personnalis<69> pour r<>cup<75>rer le contenu
|
||||
et l'assigner <20> une variable du template.
|
||||
</para>
|
||||
<example>
|
||||
<title>template composant</title>
|
||||
<programlisting>
|
||||
{* Smarty *}
|
||||
<title>Template composant</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
{php}
|
||||
// Efface le fichier "function.load_ticker.php" dans le r<>pertoire des plugins
|
||||
|
||||
// notre fonction pour r<>cup<75>rer les donn<6E>es
|
||||
function fetch_ticker($symbol,&$ticker_name,&$ticker_price) {
|
||||
function fetch_ticker($symbol,&$ticker_name,&$ticker_price)
|
||||
{
|
||||
// du traitement qui r<>cup<75>re $ticker_name
|
||||
// $ticker_price
|
||||
// depuis la ressource ticker
|
||||
return $ticker_info;
|
||||
}
|
||||
|
||||
// appelle la fonction
|
||||
fetch_ticker("YHOO",$ticker_name,$ticker_price);
|
||||
function smarty_function_load_ticker($params, &$smarty)
|
||||
{
|
||||
// appel de la fonction
|
||||
$ticker_info = fetch_ticker($params['symbol']);
|
||||
|
||||
// assigne les variables
|
||||
$this->assign("ticker_name",$ticker_name);
|
||||
$this->assign("ticker_price",$ticker_price);
|
||||
|
||||
{/php}
|
||||
|
||||
Stock Name: {$ticker_name} Stock Price: {$ticker_price}</programlisting>
|
||||
</example>
|
||||
<para>
|
||||
A partir de Smarty 1.5.0, il y a m<>me un moyen plus propre. Vous
|
||||
pouvez inclure du PHP dans votre template avec la balise {include_php ...}.
|
||||
De cette fa<66>on, vous pouvez garder s<>par<61>e la logique applicative
|
||||
de la logique de pr<70>sentation. Reportez-vous <20> la fonction <link
|
||||
linkend="language.function.include.php">include_php</link> pour plus
|
||||
d'informations.
|
||||
</para>
|
||||
<example>
|
||||
<title>template composant avec include_php</title>
|
||||
// assignation de la variable de template
|
||||
$smarty->assign($params['assign'], $ticker_info);
|
||||
}
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
<programlisting>
|
||||
load_ticker.php
|
||||
---------------
|
||||
<![CDATA[
|
||||
{* in index.tpl *}
|
||||
|
||||
<?php
|
||||
// notre fonction pour r<>cup<75>rer les donn<6E>es
|
||||
function fetch_ticker($symbol,&$ticker_name,&$ticker_price) {
|
||||
// put logic here that fetches $ticker_name
|
||||
// and $ticker_price from some resource
|
||||
}
|
||||
{load_ticker symbol="YHOO" assign="ticker"}
|
||||
|
||||
// appelle la fonction
|
||||
fetch_ticker("YHOO",$ticker_name,$ticker_price);
|
||||
|
||||
// assigne les variables
|
||||
$this->assign("ticker_name",$ticker_name);
|
||||
$this->assign("ticker_price",$ticker_price);
|
||||
?>
|
||||
|
||||
|
||||
index.tpl
|
||||
---------
|
||||
|
||||
{* Smarty *}
|
||||
|
||||
{include_php file="load_ticker.php"}
|
||||
|
||||
Stock Name: {$ticker_name} Stock Price: {$ticker_price}</programlisting>
|
||||
Stock Name: {$ticker.name} Stock Price: {$ticker.price}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect1>
|
||||
<sect1 id="tips.obfuscating.email">
|
||||
<title>Dissimuler les adresses email</title>
|
||||
<para>
|
||||
Vous-<2D>tes vous d<>j<EFBFBD> demand<6E> pourquoi vos adresses emails sont sur autant
|
||||
de mailing listes de spam ? Une fa<66>on pour les spammers de r<>cup<75>rer les
|
||||
de listes de diffusion de spam ? Une fa<66>on pour les spammers de r<>cup<75>rer les
|
||||
adresses est de parcourir les pages Web. Voici une fa<66>on de rem<65>dier
|
||||
<20> ce probl<62>me : mettre votre adresse email dans du Javascript brouill<6C>
|
||||
au milieu de votre source HTML, sans que cela ne g<>ne l'affichage sur le
|
||||
navigateur Web. Cela est fait gr<67>ce au plugin mailto.
|
||||
</para>
|
||||
<example>
|
||||
<title>exemple de dissimulation d'une adresse email</title>
|
||||
<title>Exemple de dissimulation d'une adresse email</title>
|
||||
<programlisting>
|
||||
|
||||
index.tpl
|
||||
---------
|
||||
<![CDATA[
|
||||
{* in index.tpl *}
|
||||
|
||||
Send inquiries to
|
||||
{mailto address=$EmailAddress encode="javascript" subject="Hello"}
|
||||
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
<note>
|
||||
|
||||
@@ -1,25 +1,34 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.5 Maintainer: didou Status: ready -->
|
||||
<!-- EN-Revision: 1.6 Maintainer: didou Status: ready -->
|
||||
<bookinfo id="bookinfo">
|
||||
<title>Smarty - le moteur et compilateur de templates PHP</title>
|
||||
<authorgroup id="authors">
|
||||
<author>
|
||||
<firstname>Monte</firstname><surname>Ohrt <monte@ispi.net></surname>
|
||||
<firstname>Monte</firstname>
|
||||
<surname>Ohrt <monte@ispi.net></surname>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>Andrei</firstname><surname>Zmievski <andrei@php.net></surname>
|
||||
<firstname>Andrei</firstname>
|
||||
<surname>Zmievski <andrei@php.net></surname>
|
||||
</author>
|
||||
</authorgroup>
|
||||
<authorgroup id="translators">
|
||||
<author>
|
||||
<firstname>Arnaud</firstname><surname>Cogolu<EFBFBD>gnes <arnaud.cogoluegnes@free.fr></surname>
|
||||
<firstname>Arnaud</firstname>
|
||||
<surname>Cogolu<EFBFBD>gnes <arnaud.cogoluegnes@free.fr></surname>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>G<EFBFBD>rald</firstname><surname>Cro<EFBFBD>s <gcroes@aston.fr></surname>
|
||||
<firstname>G<EFBFBD>rald</firstname>
|
||||
<surname>Cro<EFBFBD>s <gcroes@aston.fr></surname>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>Mehdi</firstname><surname>Achour <didou@php.net></surname>
|
||||
<firstname>Mehdi</firstname>
|
||||
<surname>Achour <didou@php.net></surname>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>Yannick</firstname>
|
||||
<surname>Yannick <yannick@php.net></surname>
|
||||
</author>
|
||||
</authorgroup>
|
||||
<pubdate>&build-date;</pubdate>
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.3 Maintainer: gerald Status: ready -->
|
||||
<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
|
||||
<chapter id="config.files">
|
||||
<title>Fichiers de configuration</title>
|
||||
<para>
|
||||
@@ -34,7 +34,7 @@ Intro = """Une valeur qui tient sur
|
||||
|
||||
# hidden section
|
||||
[.Database]
|
||||
host=mon.domaine.com
|
||||
host=mon.example.com
|
||||
db=ADDRESSBOOK
|
||||
user=php-user
|
||||
pass=foobar
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
|
||||
<!-- EN-Revision: 1.5 Maintainer: gerald Status: ready -->
|
||||
<chapter id="language.basic.syntax">
|
||||
<title>Bases syntaxiques</title>
|
||||
<para>
|
||||
@@ -17,6 +17,7 @@
|
||||
</para>
|
||||
|
||||
&designers.language-basic-syntax.language-syntax-comments;
|
||||
&designers.language-basic-syntax.language-syntax-variables;
|
||||
&designers.language-basic-syntax.language-syntax-functions;
|
||||
&designers.language-basic-syntax.language-syntax-attributes;
|
||||
&designers.language-basic-syntax.language-syntax-quotes;
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.6 Maintainer: didou Status: ready -->
|
||||
<!-- EN-Revision: 1.7 Maintainer: didou Status: ready -->
|
||||
<part id="getting.started">
|
||||
<title>Pour commencer</title>
|
||||
|
||||
@@ -12,6 +12,8 @@
|
||||
Cela s'explique plus facilement dans une situation o<> le
|
||||
programmeur et le designer de templates jouent des r<>les diff<66>rents, ou,
|
||||
comme la plupart du temps, sont deux personnes distinctes.
|
||||
</para>
|
||||
<para>
|
||||
Supposons par exemple que vous concevez une page Web qui affiche un
|
||||
article de newsletter. Le titre, le sous-titre, l'auteur et le corps
|
||||
sont des <20>l<EFBFBD>ments de contenu, ils ne contiennent aucune information
|
||||
@@ -40,7 +42,8 @@
|
||||
pour l'afficher, etc. sont toutes des actions relatives <20> du traitement
|
||||
de pr<70>sentation. Cela ne signifie pas que Smarty requiert une telle s<>paration
|
||||
de votre part. Smarty ne sais pas quoi est quoi, c'est donc <20> vous de placer
|
||||
la logique de pr<70>sentation dans vos templates. Ainsi, si vous NE d<>sirez PAS
|
||||
la logique de pr<70>sentation dans vos templates. Ainsi, si vous
|
||||
<emphasis>ne d<>sirez pas</emphasis>
|
||||
disposer de logique m<>tier dans vos templates, placez tous vos contenus
|
||||
dans des variables au format texte uniquement.
|
||||
</para>
|
||||
@@ -58,33 +61,80 @@
|
||||
Quelques caract<63>ristiques de Smarty :
|
||||
</para>
|
||||
<itemizedlist>
|
||||
<listitem><para>Il est tr<74>s rapide.</para></listitem>
|
||||
<listitem><para>Il est efficace, le parser PHP s'occupe
|
||||
du sale travail.</para></listitem>
|
||||
<listitem><para>Pas d'analyse de template co<63>teuse, une seule compilation.
|
||||
</para></listitem>
|
||||
<listitem><para>Il sait ne recompiler que les fichiers de templates
|
||||
qui ont <20>t<EFBFBD> modifi<66>s.</para></listitem>
|
||||
<listitem><para>Vous pouvez cr<63>er des <link linkend="language.custom.functions">
|
||||
<listitem>
|
||||
<para>
|
||||
Il est tr<74>s rapide.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Il est efficace, le parser PHP s'occupe du sale travail.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Pas d'analyse de template co<63>teuse, une seule compilation.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Il sait ne recompiler que les fichiers de templates qui ont <20>t<EFBFBD> modifi<66>s.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Vous pouvez cr<63>er des <link linkend="language.custom.functions">
|
||||
fonctions utilisateurs</link> et des <link linkend="language.modifiers">
|
||||
modificateurs de variables</link> personnalis<69>s, le langage de
|
||||
template est donc extr<74>mement extensible.</para></listitem>
|
||||
<listitem><para>Syntaxe des templates configurable, vous
|
||||
pouvez utiliser {}, {{}}, <!--{}-->, etc comme d<>limiteurs.
|
||||
</para></listitem>
|
||||
<listitem><para>Les instructions if/elseif/else/endif
|
||||
template est donc extr<74>mement extensible.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Syntaxe des templates configurable, vous
|
||||
pouvez utiliser {}, {{}}, <!--{}-->, etc. comme d<>limiteurs.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Les instructions if/elseif/else/endif
|
||||
sont pass<73>es au parser PHP, la syntaxe de l'expression {if...}
|
||||
peut <20>tre aussi simple ou aussi complexe que vous
|
||||
le d<>sirez.</para></listitem>
|
||||
<listitem><para>Imbrication illimit<69>e de sections,
|
||||
de 'if', etc. autoris<69>e.</para></listitem>
|
||||
<listitem><para>Il est possible d'inclure du code PHP
|
||||
le d<>sirez.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Imbrication illimit<69>e de sections, de 'if', etc. autoris<69>e.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Il est possible d'inclure du code PHP
|
||||
directement dans vos templates, bien que cela ne soit pas obligatoire
|
||||
(ni conseill<6C>), vu que le moteur est extensible.</para></listitem>
|
||||
<listitem><para>Support de cache int<6E>gr<67>.</para></listitem>
|
||||
<listitem><para>Sources de templates arbitraires.</para></listitem>
|
||||
<listitem><para>Fonctions de gestion de cache personnalisables.</para></listitem>
|
||||
<listitem><para>Architecture de plugins</para></listitem>
|
||||
(ni conseill<6C>), v<EFBFBD> que le moteur est extensible.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Support de cache int<6E>gr<67>.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Sources de templates arbitraires.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Fonctions de gestion de cache personnalisables.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Architecture de plugins
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</chapter>
|
||||
|
||||
@@ -127,9 +177,9 @@ debug.tpl
|
||||
linkend="constant.smarty.dir">SMARTY_DIR</link> qui
|
||||
repr<70>sente le chemin complet de la biblioth<74>que Smarty. En fait,
|
||||
si votre application trouve le fichier
|
||||
<emphasis>Smarty.class.php</emphasis>, vous n'aurez pas
|
||||
<filename>Smarty.class.php</filename>, vous n'aurez pas
|
||||
besoin de d<>finir la variable SMARTY_DIR, Smarty s'en chargera pour vous.
|
||||
En revanche, si <emphasis>Smarty.class.php</emphasis>
|
||||
En revanche, si <filename>Smarty.class.php</filename>
|
||||
n'est pas dans votre r<>pertoire d'inclusion ou que vous ne
|
||||
donnez pas un chemin absolu <20> votre application, vous
|
||||
devez d<>finir SMARTY_DIR explicitement. SMARTY_DIR
|
||||
@@ -154,7 +204,7 @@ $smarty = new Smarty;
|
||||
|
||||
<para>
|
||||
Essayez de lancer le script ci-dessus. Si vous obtenez une erreur indiquant
|
||||
que le fichier <emphasis>Smarty.class.php</emphasis> n'est pas trouv<75>,
|
||||
que le fichier <filename>Smarty.class.php</filename> n'est pas trouv<75>,
|
||||
tentez l'une des actions suivantes :
|
||||
</para>
|
||||
|
||||
@@ -201,19 +251,21 @@ $smarty = new Smarty;
|
||||
Maintenant que les fichiers de la librairie sont en place,
|
||||
il est temps de d<>finir les r<>pertoires de Smarty, pour votre application.
|
||||
Smarty a besoin de quatre r<>pertoires qui sont (par d<>faut)
|
||||
<emphasis>templates</emphasis>,
|
||||
<emphasis>templates_c</emphasis>, <emphasis>configs</emphasis> et
|
||||
<emphasis>cache</emphasis>. Chacun d'entre eux peut <20>tre d<>fini
|
||||
via les attributs <emphasis>$template_dir</emphasis>,
|
||||
<emphasis>$compile_dir</emphasis>, <emphasis>$config_dir</emphasis> et
|
||||
<emphasis>$cache_dir</emphasis> respectivement. Il est vivement
|
||||
<filename class="directory">templates</filename>,
|
||||
<filename class="directory">templates_c</filename>,
|
||||
<filename class="directory">configs</filename> et
|
||||
<filename class="directory">cache</filename>. Chacun d'entre eux peut <20>tre d<>fini
|
||||
via les attributs <varname>$template_dir</varname>,
|
||||
<varname>$compile_dir</varname>, <varname>$config_dir</varname> et
|
||||
<varname>$cache_dir</varname> respectivement. Il est vivement
|
||||
conseill<6C> que vous r<>gliez ces r<>pertoires s<>par<61>ment pour chaque
|
||||
application qui utilise Smarty.
|
||||
</para>
|
||||
<para>
|
||||
Assurez-vous de bien conna<6E>tre chemin de la racine
|
||||
de votre arborescence Web. Dans notre exemple, la racine
|
||||
est "/web/www.mydomain.com/docs". Seul Smarty
|
||||
est <filename
|
||||
class="directory">/web/www.example.com/docs/</filename>. Seul Smarty
|
||||
acc<63>de aux r<>pertoires en question, et jamais le serveur Web.
|
||||
Pour des raisons de s<>curit<69>, il est donc conseill<6C> de
|
||||
sortir ces r<>pertoires dans un r<>pertoire
|
||||
@@ -228,14 +280,15 @@ $smarty = new Smarty;
|
||||
environnement pour n'importe quelle autre application, il suffit de
|
||||
remplacer "livredor" avec le nom de votre application. Nous allons
|
||||
mettre nos r<>pertoires Smarty dans
|
||||
"/web/www.mydomain.com/smarty/livredor/".
|
||||
<filename
|
||||
class="directory">/web/www.example.com/smarty/livredor/</filename>.
|
||||
</para>
|
||||
<para>
|
||||
Vous allez avoir besoin d'au moins un fichier <20> la racine de
|
||||
l'arborescence Web,
|
||||
il s'agit du script auquel l'internaute a acc<63>s. Nous allons l'appeler
|
||||
"index.php" et le placer dans un sous-r<>pertoire
|
||||
appel<65> "/livredor/".
|
||||
<filename>index.php</filename> et le placer dans un sous-r<>pertoire
|
||||
appel<65> <filename class="directory">/livredor/</filename>.
|
||||
</para>
|
||||
|
||||
<note>
|
||||
@@ -244,7 +297,7 @@ $smarty = new Smarty;
|
||||
Il est pratique de configurer le serveur Web de
|
||||
sorte que "index.php" soit identifi<66> comme fichier
|
||||
par d<>faut de ce r<>pertoire. Aicnsi, si l'on tape
|
||||
"http://www.mydomain.com/livredor/", le script index.php soit
|
||||
"http://www.example.com/livredor/", le script index.php soit
|
||||
ex<65>cut<75> sans que "index.php" ne soit sp<73>cifi<66> dans l'URL. Avec Apache
|
||||
vous pouvez r<>gler cela en ajoutant "index.php" <20> la ligne o<> se
|
||||
trouve DirectoryIndex (s<>parez chaque entr<74>e par un espace).
|
||||
@@ -264,12 +317,12 @@ $smarty = new Smarty;
|
||||
/usr/local/lib/php/Smarty/internals/*.php
|
||||
/usr/local/lib/php/Smarty/plugins/*.php
|
||||
|
||||
/web/www.mydomain.com/smarty/livredor/templates/
|
||||
/web/www.mydomain.com/smarty/livredor/templates_c/
|
||||
/web/www.mydomain.com/smarty/livredor/configs/
|
||||
/web/www.mydomain.com/smarty/livredor/cache/
|
||||
/web/www.example.com/smarty/livredor/templates/
|
||||
/web/www.example.com/smarty/livredor/templates_c/
|
||||
/web/www.example.com/smarty/livredor/configs/
|
||||
/web/www.example.com/smarty/livredor/cache/
|
||||
|
||||
/web/www.mydomain.com/docs/livredor/index.php
|
||||
/web/www.example.com/docs/livredor/index.php
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
@@ -290,11 +343,11 @@ $smarty = new Smarty;
|
||||
<title>r<EFBFBD>gler les permissions d'acc<63>s</title>
|
||||
<programlisting role="shell">
|
||||
<![CDATA[
|
||||
chown nobody:nobody /web/www.mydomain.com/smarty/livredor/templates_c/
|
||||
chmod 770 /web/www.mydomain.com/smarty/livredor/templates_c/
|
||||
chown nobody:nobody /web/www.example.com/smarty/livredor/templates_c/
|
||||
chmod 770 /web/www.example.com/smarty/livredor/templates_c/
|
||||
|
||||
chown nobody:nobody /web/www.mydomain.com/smarty/livredor/cache/
|
||||
chmod 770 /web/www.mydomain.com/smarty/livredor/cache/
|
||||
chown nobody:nobody /web/www.example.com/smarty/livredor/cache/
|
||||
chmod 770 /web/www.example.com/smarty/livredor/cache/
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
@@ -316,7 +369,7 @@ chmod 770 /web/www.mydomain.com/smarty/livredor/cache/
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title>Edition de /web/www.mydomain.com/smarty/templates/index.tpl</title>
|
||||
<title>Edition de /web/www.example.com/smarty/templates/index.tpl</title>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
|
||||
@@ -349,7 +402,7 @@ Hello, {$name}!
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title><EFBFBD>dition de /web/www.mydomain.com/docs/livredor/index.php</title>
|
||||
<title><EFBFBD>dition de /web/www.example.com/docs/livredor/index.php</title>
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<?php
|
||||
@@ -358,10 +411,10 @@ Hello, {$name}!
|
||||
|
||||
$smarty = new Smarty;
|
||||
|
||||
$smarty->template_dir = '/web/www.mydomain.com/smarty/livredor/templates/';
|
||||
$smarty->compile_dir = '/web/www.mydomain.com/smarty/livredor/templates_c/';
|
||||
$smarty->config_dir = '/web/www.mydomain.com/smarty/livredor/configs/';
|
||||
$smarty->cache_dir = '/web/www.mydomain.com/smarty/livredor/cache/';
|
||||
$smarty->template_dir = '/web/www.example.com/smarty/livredor/templates/';
|
||||
$smarty->compile_dir = '/web/www.example.com/smarty/livredor/templates_c/';
|
||||
$smarty->config_dir = '/web/www.example.com/smarty/livredor/configs/';
|
||||
$smarty->cache_dir = '/web/www.example.com/smarty/livredor/cache/';
|
||||
|
||||
$smarty->assign('name','Ned');
|
||||
|
||||
@@ -376,8 +429,9 @@ Hello, {$name}!
|
||||
<para>
|
||||
Dans notre exemple, nous avons configur<75> les chemins absolus
|
||||
pour chacun des r<>pertoires Smarty. Si
|
||||
'/web/www.mydomain.com/smarty/livredor/' est dans votre
|
||||
include_path PHP alors ces r<>glages ne sont pas n<>cessaires.
|
||||
<filename
|
||||
class="directory">/web/www.example.com/smarty/livredor/</filename>
|
||||
est dans votre include_path PHP alors ces r<>glages ne sont pas n<>cessaires.
|
||||
Quoi qu'il en soit il est plus efficace et (par exp<78>rience)
|
||||
moins g<>n<EFBFBD>rateur d'erreurs de les d<>finir avec des chemins
|
||||
absolus. Cela nous garantit que Smarty r<>cup<75>rera les bons fichiers.
|
||||
@@ -385,7 +439,7 @@ Hello, {$name}!
|
||||
</note>
|
||||
|
||||
<para>
|
||||
Et maintenant appelez le fichier index.php avec navigateur
|
||||
Et maintenant appelez le fichier <filename>index.php</filename> avec navigateur
|
||||
Web. Vous devriez voir "Hello, Ned!".
|
||||
</para>
|
||||
<para>
|
||||
@@ -406,7 +460,7 @@ Hello, {$name}!
|
||||
propre classe fille et de l'initialiser selon votre environnement.
|
||||
De la sorte, nous n'aurons plus besoin de configurer <20> chaques fois les
|
||||
chemins de notre environnement. Cr<43>ons un nouveau r<>pertoire
|
||||
"/php/includes/livredor/" et un nouveau fichier appel<65> "setup.php".
|
||||
"/php/includes/livredor/" et un nouveau fichier appel<65> <filename>setup.php</filename>.
|
||||
Dans notre exemple d'environnement, "/php/includes" est notre
|
||||
include_path PHP. Assurez-vous de faire la m<>me chose ou alors d'utiliser
|
||||
des chemins absolus.
|
||||
@@ -430,15 +484,15 @@ Hello, {$name}!
|
||||
|
||||
function Smarty_livredor() {
|
||||
|
||||
// Constructeur de la classe. Appel<EFBFBD> automatiquement
|
||||
// <20> l'instanciation de la classe.
|
||||
// Constructeur de la classe.
|
||||
// Appel<65> automatiquement <20> l'instanciation de la classe.
|
||||
|
||||
$this->Smarty();
|
||||
|
||||
$this->template_dir = '/web/www.mydomain.com/smarty/livredor/templates/';
|
||||
$this->compile_dir = '/web/www.mydomain.com/smarty/livredor/templates_c/';
|
||||
$this->config_dir = '/web/www.mydomain.com/smarty/livredor/configs/';
|
||||
$this->cache_dir = '/web/www.mydomain.com/smarty/livredor/cache/';
|
||||
$this->template_dir = '/web/www.example.com/smarty/livredor/templates/';
|
||||
$this->compile_dir = '/web/www.example.com/smarty/livredor/templates_c/';
|
||||
$this->config_dir = '/web/www.example.com/smarty/livredor/configs/';
|
||||
$this->cache_dir = '/web/www.example.com/smarty/livredor/cache/';
|
||||
|
||||
$this->caching = true;
|
||||
$this->assign('app_name', 'Guest Book');
|
||||
@@ -455,7 +509,7 @@ Hello, {$name}!
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title><EFBFBD>dition de /web/www.mydomain.com/docs/livredor/index.php</title>
|
||||
<title>Edition de /web/www.example.com/docs/livredor/index.php</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
|
||||
@@ -11,6 +11,7 @@
|
||||
<person name="G<>rald Cro<72>s" email="gerald@php.net" nick="gerald" cvs="yes" editor="yes" />
|
||||
<person name="Arnaud Cogolu<6C>gnes" email="arnaud@php.net" nick="nono" cvs="yes" />
|
||||
<person name="Mehdi Achour" email="didou@php.net" nick="didou" cvs="yes" />
|
||||
<person name="Yannick Torres" email="yannick@php.net" nick="yannick" cvs="yes" />
|
||||
<person name="Raoul Lourse" email="nobody@php.net" nick="nobody" cvs="yes" />
|
||||
</translators>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user