smarty/docs/fr/appendixes.sgml

<part id="appendixes">
 <title>Appendices</title>
<chapter id="troubleshooting">
   <title>Diagnostic des erreurs</title>
   <para></para>
   <sect1 id="smarty.php.errors">
       <title>Erreurs Smarty/PHP</title>
       <para>
       Smarty peut identifier de nombreuses erreurs comme des attributs de
       balises manquants ou de noms de variables malform<72>s. Dans ce cas-l<>,
       vous verrez appara<72>tre une erreur semblable <20> :
       </para>
<example>
<title>erreurs Smarty</title>
<programlisting>
Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah'
        in /path/to/smarty/Smarty.class.php on line 1041

Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name
        in /path/to/smarty/Smarty.class.php on line 1041</programlisting>
</example>

       <para>
       Smarty vous indique le nom du template, le num<75>ro de la ligne et l'erreur.
       Apr<70>s cela, vous pouvez conna<6E>tre le num<75>ro de ligne o<> il y a eu erreur dans
       la d<>finition de la classe Smarty.
       </para>
       
       <para>
       Il y a certaines erreurs que Smarty ne peut pas d<>tecter, comme les 
       balises fermantes manquantes. Ce type d'erreurs est la plupart du temps
       rep<65>r<EFBFBD> dans la phase de compilation PHP du template compil<69>.
       </para>              
       
<example>
<title>erreur d'analyse PHP</title>
<programlisting>
Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75</programlisting>
</example>
       
       <para>
       Quand vous rencontrez une erreur d'analyse PHP, le num<75>ro de la ligne
       indiqu<71> est celui du fichier PHP compil<69> et non du template. Vous pouvez alors
       regarder le template et d<>tecter l'erreur. Voici quelques erreurs fr<66>quentes :
       balises fermantes pour {if}{/if} ou {section}{/section} manquantes, ou 
       syntaxe logique incorrecte dans une instruction {if}. Si vous ne trouvez pas l'erreur,
       vous devrez alors ouvrir le fichier PHP compil<69> et aller <20> la ligne correspondante pour
       trouver d'o<> vient l'erreur.
       </para>
   </sect1>
</chapter>
<chapter id="tips">
   <title>Trucs et astuces</title>
   <para>
   </para>
   <sect1 id="tips.blank.var.handling">
		<title>Gestion des variables non-assign<67>es</title>
		<para>
		Peut-<2D>tre voudrez-vous des fois afficher une valeur par d<>faut pour
		une variable qui n'a pas <20>t<EFBFBD> assign<67>e, comme pour afficher "&amp;nbsp;"
		afin que les couleurs de fond des tableaux fonctionnent. Beaucoup utiliseraient
		une instruction {if} pour g<>rer cela, mais il existe un moyen plus facile dans
		Smarty, l'utilisation du modificateur de variable <emphasis>default</emphasis>.
		</para>		
<example>
<title>afficher &amp;nbsp; quand une variable est vide</title>
<programlisting>

{* la m<>thode pas adapt<70>e *}

{if $title eq ""}
	&amp;nbsp;
{else}
	{$title}
{/if}


{* la bonne m<>thode *}

{$title|default:"&amp;nbsp;"}</programlisting>
</example>
	</sect1>

    <sect1 id="tips.default.var.handling">
		<title>Gestion des variables par d<>faut</title>
		<para>
		Si une variable est utilis<69>e fr<66>quemment dans vos templates,
		lui appliquer le modificateur par d<>faut peut <20>tre un peu fastidieux.
		Vous pouvez rem<65>dier <20> cela en lui assignant une valeur par d<>faut
		avec la fonction <link linkend="language.function.assign">assign</link>.
		</para>
<example>
<title>assigner une valeur par d<>faut <20> une variable de template</title>
<programlisting>
{* faites cela qq 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>
</example>
	</sect1>
    <sect1 id="tips.passing.vars">
		<title>Passage du titre <20> un template d'en-t<>te</title>
		<para>
		Quand la majorit<69> de vos templates utilisent les m<>mes en-t<>te et pied-de-page,
		il est d'usage de les mettre dans leurs propres templates et de les inclure.
		Mais comment faire si l'en-t<>te doit avoir un titre diff<66>rent, selon la page
		d'o<> on vient ? Vous pouvez passer le titre <20> l'en-t<>te quand il est inclus.
		</para>
<example>
<title>passer le titre au template d'en-t<>te</title>
<programlisting>

mainpage.tpl
------------

{include file="header.tpl" title="Main Page"}
{* le corps du template va ici *}
{include file="footer.tpl"}


archives.tpl
------------

{config_load file="archive_page.conf"}
{include file="header.tpl" title=#archivePageTitle#}
{* le corps du template va ici *}
{include file="footer.tpl"}


header.tpl
----------
&lt;HTML&gt;
&lt;HEAD&gt;
&lt;TITLE&gt;{$title|default:"BC News"}&lt;/TITLE&gt;
&lt;/HEAD&gt;
&lt;BODY&gt;


footer.tpl
----------
&lt;/BODY&gt;
&lt;/HTML&gt;</programlisting>
</example>
	<para>
	Quand la page principale est con<6F>ue, le titre "Main page" est pass<73> <20> header.tpl
	et sera donc utilis<69> pour le titre. Quand la page d'archive est con<6F>ue,
	le titre sera "Archives". Notez que dans l'exemple des archives, on utilise
	le fichier archives_page.conf plut<75>t que des variables cod<6F>es en dur.
	Remarquez aussi que "BC News" est affich<63>e si la variable $title
	n'est pas d<>finie, gr<67>ce au modificateur de variable <emphasis>default</emphasis>.
	</para>	
	</sect1>
    <sect1 id="tips.dates">
       <title>Dates</title>
       <para>
       De fa<66>on g<>n<EFBFBD>rale, essayez de toujours passer les dates <20> Smarty
       sous forme de timestamp. Cela permet aux designers de templates d'utiliser
       <link linkend="language.modifier.date.format">date_format</link>
       pour avoir un contr<74>le total sur le formatage des dates et de comparer
       facilement les dates entre elles.
       </para>
       <para>
       NOTE : <20> 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>
<example>
<title>utilisation de date_format</title>
<programlisting>
{$startDate|date_format}

OUTPUT:

Jan 4, 2001


{$startDate|date_format:"%Y/%m/%d"}

OUTPUT:

2001/01/04


{if $date1 &lt; $date2}
	...
{/if}</programlisting>
</example>
      <para>
      En utilisant la fonction {html_select_date} dans un template, le programmeur
      veut en g<>n<EFBFBD>ral convertir le r<>sultat d'un formulaire en un timestamp.
      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>
// cela suppose que vos <20>l<EFBFBD>ments de formulaire soient nomm<6D>s
// startDate_Day, startDate_Month, startDate_Year

$startDate = makeTimeStamp($startDate_Year,$startDate_Month,$startDate_Day);

function makeTimeStamp($year="",$month="",$day="")
{
	if(empty($year))
		$year = strftime("%Y");
	if(empty($month))
		$month = strftime("%m");
	if(empty($day))
		$day = strftime("%d");

	return mktime(0,0,0,$month,$day,$year);
}</programlisting>
</example>
	</sect1>
    <sect1 id="tips.wap">
		<title>WAP/WML</title>
		<para>
		Les templates WAP/WML n<>cessitent un en-t<>te "Content-Type" qui doit <20>tre
		pass<73> avec le template. Le moyen le plus facile de faire cela est d'<27>crire
		une fonction utilisateur qui <20>crit l'en-t<>te. Si vous utilisez le cache,
		cela ne fonctionnera pas. Nous utiliserons donc une balise d'insertion
    (rappelez-vous que les balises d'insertion ne sont pas mises en cache !).
    Assurez-vous qu'aucune sortie
		rien n'est transmise au navigateur avant l'appel du template, sans quoi
    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>
// assurez-vous que Apache est configur<75> pour les extensions .wml !
// mettez cette fonction qq part dans votre applications
// ou dans Smarty.addons.php
function insert_header() {
    // cette fonction attend un argument $content
    extract(func_get_arg(0));
    if(empty($content))
        return;
    header($content);
    return;
}

// votre template Smarty DOIT commencer avec la balise d'insertion

&lt;?xml version="1.0"?&gt;  
&lt;!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml"&gt; 

&lt;!-- begin new wml deck --&gt; 
&lt;wml&gt; 
&lt;!-- begin first card --&gt; 
&lt;card&gt; 
&lt;do type="accept"&gt; 
&lt;go href="#two"/&gt; 
&lt;/do&gt;  
&lt;p&gt; 
Welcome to WAP with Smarty!
Press OK to continue...  
&lt;/p&gt; 
&lt;/card&gt;  
&lt;!-- begin second card --&gt; 
&lt;card id="two"&gt;  
&lt;p&gt; 
Pretty easy isn't it?
&lt;/p&gt; 
&lt;/card&gt; 
&lt;/wml&gt;</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
      dans l'application PHP (peut-<2D>tre avec des requ<71>tes en base de donn<6E>es), puis
      vous instanciez votre objet Smarty, assignez les variables et affichez le
      template. Disons par exemple que nous avons un t<>l<EFBFBD>scripteur dans
      notre template. Nous r<>cup<75>rerions les donn<6E>es dans notre application,
      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.
		</para>
		<para>
		Vous pouvez int<6E>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.
		</para>
<example>
<title>template composant</title>
<programlisting>
{* Smarty *}

{php}

   // notre fonction pour r<>cup<75>rer les donn<6E>es
	function fetch_ticker($symbol,&amp;$ticker_name,&amp;$ticker_price) {
      // du traitement qui r<>cup<75>re $ticker_name
      // $ticker_price
	}

   // 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);

{/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>
<programlisting>
load_ticker.php
---------------

&lt;?php
	// notre fonction pour r<>cup<75>rer les donn<6E>es
	function fetch_ticker($symbol,&amp;$ticker_name,&amp;$ticker_price) {
		// put logic here that fetches $ticker_name
		// and $ticker_price from some resource
	}

	// 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);
?&gt;


index.tpl
---------

{* Smarty *}

{include_php file="load_ticker.php"}

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
		adresses est de parcourir les pages Web. Voici une fa<66>on de rem<65>dier
		<09> 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>
<programlisting>

index.tpl
---------

Send inquiries to
{mailto address=$EmailAddress encode="javascript" subject="Hello"}

</programlisting>
</example>
	<note>
	<title>Note technique</title>
	<para>
	Cette m<>thode n'est pas infaillible. Un spammer peut programmer son
	collecteur d'email pour passer outre cette astuce, mais c'est cependant
	peu probable.
	</para>
	</note>
	</sect1>
</chapter>
<chapter id="resources">
	<title>Ressources</title>
	<para>
	La page Web de Smarty se trouve <20> l'adresse suivante : http://smarty.php.net/.
	Vous pouvez souscrire <20> la mailing liste en envoyant un email <20>
	smarty-general-subscribe@lists.php.net.
	Les archives de la mailing list se trouvent <20> l'adresse suivante :
	http://marc.theaimsgroup.com/?l=smarty&amp;r=1&amp;w=2
	</para>
</chapter>
<chapter id="bugs">
	<title>BUGS</title>
	<para>
	V<>rifiez le fichier de BUGS fourni avec la derni<6E>re version de Smarty ou
	consultez le site Web.
	</para>
</chapter>
</part>