smarty/docs/fr/programmers/advanced-features/template-resources.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
<sect1 id="template.resources">
 <title>Ressources</title>
 <para>
  Les templates peuvent provenir d'une grande vari<72>t<EFBFBD> de ressources. Quand vous
  affichez (<link linkend="api.display">display()</link>) ou 
  r<>cup<75>rez (<link linkend="api.fetch">fetch()</link>) un template, ou quand vous incluez un template
  dans un autre template, vous fournissez un type de ressource, suivi
  par le chemin appropri<72> et le nom du template. Si une ressource n'est pas
  explicitement donn<6E>e, la valeur de la variable <link
  linkend="variable.default.resource.type">$default_resource_type</link>
  sera utilis<69>e.
 </para>
 <sect2 id="templates.from.template.dir">
  <title>Templates depuis $template_dir</title>
  <para>
   Les templates du r<>pertoire 
   <link linkend="variable.template.dir">$template_dir</link> n'ont pas
   besoin d'une ressource template, bien que vous puissiez utiliser
   la ressource "file" pour <20>tre coh<6F>rent. Vous n'avez qu'<27> fournir
   le chemin vers le template que vous voulez utiliser, relatif
   au r<>pertoire racine <link linkend="variable.template.dir">$template_dir</link>.
  </para>
  <example>
   <title>Utilisation de templates depuis $template_dir</title>
   <programlisting role="php">
<![CDATA[
<?php
$smarty->display("index.tpl");
$smarty->display("admin/menu.tpl");
$smarty->display("file:admin/menu.tpl"); // le m<>me que ci-dessus
?>

{* le template Smarty *}
{include file="index.tpl"}
{include file="file:index.tpl"} {* le m<>me que ci-dessus *}
]]>
   </programlisting>
  </example>
 </sect2>
 <sect2 id="templates.from.any.dir">
  <title>Templates <20> partir de n'importe quel r<>pertoire</title>
  <para>
   Les templates en-dehors du r<>pertoire 
   <link linkend="variable.template.dir">$template_dir</link> n<>cessitent
   le type de ressource template, suivi du chemin absolu et du nom du
   template.
  </para>
  <example>
   <title>Utilisation d'un template depuis n'importe quel r<>pertoire</title>
   <programlisting role="php">
<![CDATA[
<?php
$smarty->display("file:/export/templates/index.tpl");
$smarty->display("file:/path/to/my/templates/menu.tpl");
?>
]]>
   </programlisting>
   <para>
    Le template Smarty :
   </para>
   <programlisting>
<![CDATA[
{include file="file:/usr/local/share/templates/navigation.tpl"}
]]>
   </programlisting>
  </example>

  <sect3 id="templates.windows.filepath">
   <title>Chemin de fichiers Windows</title>
   <para>
    Si vous utilisez Windows, les chemins de fichiers sont la plupart
    du temps sur un disque identifi<66> par une lettre (c:) au d<>but du chemin.
    Assurez-vous de bien mettre "file:" dans le chemin pour <20>viter des
    conflits d'espace de noms et obtenir les r<>sultats escompt<70>s.
   </para>
   <example>
    <title>Utilisation de templates avec des chemins de fichiers Windows</title>
    <programlisting role="php">
<![CDATA[
<?php
$smarty->display("file:C:/export/templates/index.tpl");
$smarty->display("file:F:/path/to/my/templates/menu.tpl");
?>
]]>
    </programlisting>
    <para>
     Le template Smarty :
    </para>
    <programlisting>
<![CDATA[
{include file="file:D:/usr/local/share/templates/navigation.tpl"}
]]>
    </programlisting>
   </example>
  </sect3>
 </sect2>

 <sect2 id="templates.from.elsewhere">
  <title>Templates depuis d'autres sources</title>
  <para>
   Vous pouvez r<>cup<75>rer les templates <20> partir de n'importe quelle
   source <20> laquelle vous avez acc<63>s avec PHP : base de donn<6E>es,
   sockets, LDAP et ainsi de suite. Il suffit d'<27>crire les fonctions
   de ressource plugins et de les enregistrer aupr<70>s de Smarty.
  </para>

  <para>
   Reportez-vous <20> la section <link linkend="plugins.resources">ressource plugins</link>
   pour plus d'informations sur les fonctions que vous <20>tes cens<6E> fournir.
  </para>

  <note>
   <para>
    Notez que vous ne pouvez pas <20>craser la ressource <literal>file</literal> native,
    toutefois, vous pouvez fournir une ressource qui r<>cup<75>re un template depuis
    le syst<73>me de fichier par un autre moyen en l'enregistrant sous un autre
    nom de ressource.
   </para>
  </note>
  <example>
   <title>Utilisation de ressources utilisateurs</title>
   <programlisting role="php">
<![CDATA[
<?php
// mettez ces fonctions quelque part dans votre application
function db_get_template ($tpl_name, &$tpl_source, &$smarty_obj)
{
    // requ<71>te BD pour r<>cup<75>rer le template
    // et remplir $tpl_source
    $sql = new SQL;
    $sql->query("select tpl_source
                   from my_table
                  where tpl_name='$tpl_name'");
    if ($sql->num_rows) {
        $tpl_source = $sql->record['tpl_source'];
        return true;
    } else {
        return false;
    }
}

function db_get_timestamp($tpl_name, &$tpl_timestamp, &$smarty_obj)
{
    // requ<71>te BD pour remplir $tpl_timestamp
    $sql = new SQL;
    $sql->query("select tpl_timestamp
                   from my_table
                  where tpl_name='$tpl_name'");
    if ($sql->num_rows) {
        $tpl_timestamp = $sql->record['tpl_timestamp'];
        return true;
    } else {
        return false;
    }
}

function db_get_secure($tpl_name, &$smarty_obj)
{
    // on suppose que tous les templates sont svrs
    return true;
}

function db_get_trusted($tpl_name, &$smarty_obj)
{
    // pas utilis<69>e pour les templates dans notre cas
}

// enregistre le nom de ressource "db"
$smarty->register_resource("db", array("db_get_template",
                                       "db_get_timestamp",
                                       "db_get_secure",
                                       "db_get_trusted"));

// utilise la ressource depuis le script PHP
$smarty->display("db:index.tpl");
?>
]]>
   </programlisting>
   <para>
    Le template Smarty :
   </para>
   <programlisting>
<![CDATA[
{include file="db:/extras/navigation.tpl"}
]]>
   </programlisting>
  </example>
 </sect2>

 <sect2 id="default.template.handler.function">
  <title>Fonction de gestion de template par d<>faut</title>
  <para>
   Vous pouvez sp<73>cifier une fonction qui sera utilis<69>e pour
   r<>cup<75>rer le contenu d'un template dans le cas o<> le template
   ne peut pas <20>tre r<>cup<75>r<EFBFBD> depuis sa ressource. Une utilisation possible est
   la cr<63>ation de templates <20> la vol<6F>e.
  </para>
  <example>
   <title>utilisation de la fonction de gestion de template par d<>faut</title>
   <programlisting role="php">
<![CDATA[
<?php
// mettez cette fonction quelque part dans votre application

function make_template ($resource_type, $resource_name, &$template_source, &$template_timestamp, 
&$smarty_obj)
{
  if( $resource_type == 'file' ) {
    if ( ! is_readable ( $resource_name )) {
      // cr<63>e le fichier de template et renvoie le contenu
      $template_source = "Ceci est un nouveau template.";
      $template_timestamp = time();
      $smarty_obj->_write_file($resource_name,$template_source);
      return true;
    }
  } else {
    // pas un fichier
    return false;
  }
}

// r<>gle la fonction par d<>faut
$smarty->default_template_handler_func = 'make_template';
?>
]]>
   </programlisting>
  </example>
 </sect2>
</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
-->