smarty/docs/fr/programmers/plugins/plugins-compiler-functions.xml

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

<sect1 id="plugins.compiler.functions">
 <title>Fonctions de compilation</title>
 <para>
  Les fonctions de compilation sont appel<65>es durant la compilation du template.
  Elles sont utiles pour injecter du code PHP ou du contenu "statique variant
  avec le temps" (bandeau de pub par ex.). Si une fonction de compilation et
  une <link linkend="language.custom.functions">fonction personnalis<69>e</link>
  ont le m<>me nom, la fonction de compilation a priorit<69>.
 </para>
 <funcsynopsis>
  <funcprototype>
   <funcdef>mixed <function>smarty_compiler_<replaceable>name</replaceable></function></funcdef>
   <paramdef>string <parameter>$tag_arg</parameter></paramdef>
   <paramdef>object <parameter>&amp;$smarty</parameter></paramdef>
  </funcprototype>
 </funcsynopsis>
 <para>
  Les fonctions de compilation ont deux param<61>tres : une cha<68>ne contenant
  la balise - en gros, tout, depuis le nom de la fonction jusqu'au d<>limiteur de fin - et
  l'objet Smarty. Elles sont cens<6E>es retourner le code PHP qui doit <20>tre
  inject<63> dans le template compil<69>.
 </para>
 <example>
  <title>Fonction de compilation simple</title>
  <programlisting role="php">
<![CDATA[
<?php
/*
 * Smarty plugin
 * -------------------------------------------------------------
 * Fichier :   compiler.tplheader.php
 * Type :      compilation
 * Nom :       tplheader
 * R<>le :      Renvoie l'en-t<>te contenant le nom du fichier
 *             source et le temps de compilation.
 * -------------------------------------------------------------
 */
function smarty_compiler_tplheader($tag_arg, &amp;$smarty)
{
    return "\necho '" . $smarty-&gt;_current_file . " compiled at " . date('Y-m-d H:M'). "';";
}
?>
]]>
  </programlisting>
  <para>
   Cette fonction peut-<2D>tre appel<65>e depuis le template comme suivant :
  </para>
  <programlisting>
<![CDATA[
{* cette fonction n'est execut<75>e que lors de la compilation *}
{tplheader}
]]>
  </programlisting>
  <para>
   Le code PHP r<>sultant dans les templates compil<69>s ressemblerait <20> <20>a :
  </para>
  <programlisting role="php">
<![CDATA[
<?php
echo 'index.tpl compiled at 2002-02-20 20:02';
?>
]]>
  </programlisting>
 </example>
 <para>
  Voir aussi :
  <link linkend="api.register.compiler.function"><varname>register_compiler_function()</varname></link> et
  <link linkend="api.unregister.compiler.function"><varname>unregister_compiler_function()</varname></link>.
 </para>
</sect1>
 <!-- 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
 -->