smarty/docs/fr/appendixes/tips.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.12 Maintainer: didou Status: ready -->

<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 <literal>&amp;nbsp;</literal> afin que les couleurs
   de fond des tableaux fonctionnent. Beaucoup utiliseraient une
   instruction <link linkend="language.function.if"><varname>{if}</varname></link> 
   pour g<>rer cel<65>, mais il existe un moyen
   plus facile dans Smarty : l'utilisation du modificateur
   de variable
   <link linkend="language.modifier.default"><varname>default</varname></link>.
   <note>
    <para>Les erreurs <quote>de variable ind<6E>finie</quote> seront affich<63>s si
     la fonction PHP
     <ulink url="&url.php-manual;error_reporting">
      <varname>error_reporting()</varname></ulink> vaut <constant>E_ALL</constant>
     et qu'une variable n'a pas <20>t<EFBFBD> assign<67>e <20> Smarty.
    </para>
    </note>
  </para>
  <example>
   <title>Afficher &amp;nbsp; quand une variable est vide</title>
   <programlisting>
<![CDATA[
{* la m<>thode pas adapt<70>e *}
{if $title eq ''}
   &nbsp;
{else}
   {$title}
{/if}


{* la bonne m<>thode *}
{$title|default:'&nbsp;'}
]]>
   </programlisting>
  </example>
  <para>
   Voir aussi
   <link linkend="language.modifier.default"><varname>default</varname></link> et
   <link linkend="tips.default.var.handling">la gestion des variables par d<>faut</link>.
  </para>
 </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
   <link linkend="language.modifier.default"><varname>default</varname></link>
   peut <20>tre un peu fastidieux.
   Vous pouvez rem<65>dier <20> cel<65> en lui assignant une valeur par d<>faut
   avec la fonction <link linkend="language.function.assign"><varname>{assign}</varname></link>.
  </para>
  <example>
   <title>Assigner une valeur par d<>faut <20> une variable de template</title>
<programlisting>
<![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 la valeur "no title" *}
{$title}
]]>
   </programlisting>
  </example>
  <para>
   Voir aussi
   <link linkend="language.modifier.default"><varname>default</varname></link> et
   <link linkend="tips.blank.var.handling">la gestion des variables non-assign<67>es</link>.
  </para>
 </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
   (<link linkend="language.function.include"><varname>{include}</varname></link>).
   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 en tant qu'
   <link linkend="language.syntax.attributes">attribut</link> quand il est inclus.
  </para>

  <example>
   <title>Passer le titre au template d'en-t<>te</title>

   <para>
    <filename>mainpage.tpl</filename> - Lorsque la page principal est construite,
    le titre <quote>Man Page</quote> est pass<73> au <filename>header.tpl</filename> et sera utilis<69>
    en tant que titre.
   </para>
   <programlisting>
<![CDATA[
{include file='header.tpl' title='Main Page'}
{* le corps du template va ici *}
{include file='footer.tpl'}
]]>
   </programlisting>

   <para>
    <filename>archives.tpl</filename> - Lorsque la page principal est construite, le titre
    sera <quote>Archives</quote>. Notez que dans cet exemple, nous utilisons une variable du fichier
    <filename>archives_page.conf</filename> au lieu d'une variable classique.
   </para>
   <programlisting>
<![CDATA[
{config_load file='archive_page.conf'}

{include file='header.tpl' title=#archivePageTitle#}
{* corps du template ici *}
{include file='footer.tpl'}
]]>
   </programlisting>

   <para>
    <filename>header.tpl</filename> - Notez que <quote>Smarty News</quote> est affich<63>
    si la variable <literal>$title</literal> n'est pas d<>finie, en utilisant le modificateur de variable par
    <link linkend="language.modifier.default"><varname>default</varname></link>.
   </para>
   <programlisting>
<![CDATA[
<html>
 <head>
  <title>{$title|default:'Smarty News'}</title>
 </head>
 <body>
  ]]>
   </programlisting>

   <para>
    <filename>footer.tpl</filename>
   </para>
   <programlisting>
<![CDATA[
</body>
</html>
]]>
   </programlisting>
  </example>
 </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 <ulink url="&url.php-manual;time">timestamp</ulink>.
   Cela permet aux designers de templates d'utiliser
   <link linkend="language.modifier.date.format"><varname>date_format</varname></link>
    pour avoir un contr<74>le total sur le formatage des dates et de comparer
    facilement les dates entre elles.
   </para>
   <example>
    <title>Utilisation de date_format</title>
    <programlisting>
<![CDATA[
{$startDate|date_format}
]]>
    </programlisting>
    <para>
     Affichera :
    </para>
    <screen>
<![CDATA[
Jan 4, 2009
]]>
    </screen>
    <programlisting>
<![CDATA[
{$startDate|date_format:"%Y/%m/%d"}
]]>
    </programlisting>
    <para>
     Affichera :
    </para>
    <screen>
<![CDATA[
2009/01/04
]]>
     </screen>
     <para>
      Les dates peuvent <20>tre compar<61>es dans le template en utilisant les timestamps, comme ceci :
     </para>
     <programlisting>
<![CDATA[
{if $date1 < $date2}
   ...
{/if}
]]>
    </programlisting>
   </example>
   <para>
    En utilisant la fonction
    <link linkend="language.function.html.select.date"><varname>{html_select_date}</varname></link> 
    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 role="php">
<![CDATA[
<?php

// cel<65> 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>

   <para>
    Voir aussi
    <link linkend="language.function.html.select.date"><varname>{html_select_date}</varname></link>,
    <link linkend="language.function.html.select.time"><varname>{html_select_time}</varname></link>,
    <link linkend="language.modifier.date.format"><varname>date_format</varname></link> et
    <link linkend="language.variables.smarty.now"><parameter>$smarty.now</parameter></link>,
   </para>
  </sect1>

  <sect1 id="tips.wap">
   <title>WAP/WML</title>
   <para>
    Les templates WAP/WML n<>cessitent un en-t<>te
    <ulink url="&url.php-manual;header">Content-Type</ulink> qui doit <20>tre
    pass<73> avec le template. Le moyen le plus facile de faire cel<65> est d'<27>crire
    une fonction utilisateur qui <20>crit l'en-t<>te. Si vous utilisez le 
    <link linkend="caching">cache</link>,
    cel<65> ne fonctionnera pas. Nous utiliserons donc une balise d'insertion
    (<link linkend="language.function.insert">{insert}</link>)
    (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 role="php">
<![CDATA[
<?php

// assurez-vous que Apache est configur<75> pour les extensions .wml !
// mettez cette fonction quelque part dans votre applications
// ou dans Smarty.addons.php
function insert_header() 
{
   // cette fonction attend un argument $content
   if (empty($params['content'])) {
       return;
   }
   header($params['content']);
   return;
}

?>
]]>
    </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">

<!-- 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>
   Pretty easy isn't it?
  </p>
 </card>
</wml>
]]>
    </programlisting>
   </example>
  </sect1>
  <sect1 id="tips.componentized.templates">
   <title>Templates composants</title>
   <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,
    <link linkend="api.assign"><varname>assign()</varname></link>
    les variables et <link linkend="api.display"><varname>display()</varname></link> 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 r<>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>
    <para>
     <filename>function.load_ticker.php</filename> -
     Efface le fichier du r<>pertoire des
     <link linkend="variable.plugins.dir"><parameter>$plugins</parameter></link>
    </para>
    <programlisting role="php">
<![CDATA[
<?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
   // depuis la ressource ticker
   return $ticker_info;
}

function smarty_function_load_ticker($params, &$smarty) 
{
   // appel de la fonction
   $ticker_info = fetch_ticker($params['symbol']);

   // assignation de la variable de template
   $smarty->assign($params['assign'], $ticker_info);
}
?>
]]>
    </programlisting>
    <para>
     <filename>index.tpl</filename>
    </para>
    <programlisting>
<![CDATA[
{load_ticker symbol='SMARTY' assign="ticker"}

Stock Name: {$ticker.name} Stock Price: {$ticker.price}
]]>
    </programlisting>
   </example>
   <para>
    Voir aussi
    <link linkend="language.function.include.php"><varname>{include_php}</varname></link>,
    <link linkend="language.function.include"><varname>{include}</varname></link> et
    <link linkend="language.function.php"><varname>{php}</varname></link>.
   </para>
  </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 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 cel<65> ne g<>ne l'affichage sur le
    navigateur Web. Cela est fait gr<67>ce au plugin 
    <link linkend="language.function.mailto"><varname>{mailto}</varname></link>.
   </para>
   <example>
    <title>Exemple de dissimulation d'une adresse email</title>
<programlisting>
<![CDATA[
<div id="contact">Envoyer une demande <20>
{mailto address=$EmailAddress encode='javascript' subject='Bonjour'}
]]>
    </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>
   <para>
    Voir aussi
    <link linkend="language.modifier.escape"><varname>escape</varname></link> et
    <link linkend="language.function.mailto"><varname>{mailto}</varname></link>.
   </para>
  </sect1>
 </chapter>

 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
 sgml-omittag:t
 sgml-shorttag:t
 sgml-minimize-attributes:nil
 sgml-always-quote-attributes:t
 sgml-indent-step:1
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
 sgml-default-dtd-file:"../../../../manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil
 End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->