mirror of
https://github.com/smarty-php/smarty.git
synced 2025-10-19 07:25:20 +02:00
253 lines
7.4 KiB
XML
253 lines
7.4 KiB
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été de ressources. Quand vous
|
|
affichez (<link linkend="api.display">display()</link>) ou
|
|
récupé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é et le nom du template. Si une ressource n'est pas
|
|
explicitement donnée, la valeur de la variable <link
|
|
linkend="variable.default.resource.type">$default_resource_type</link>
|
|
sera utilisé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 être cohérent. Vous n'avez qu'à 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 à 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é par une lettre (c:) au début du chemin.
|
|
Assurez-vous de bien mettre "file:" dans le chemin pour éviter des
|
|
conflits d'espace de noms et obtenir les résultats escompté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érer les templates à partir de n'importe quelle
|
|
source à laquelle vous avez accès avec PHP : base de données,
|
|
sockets, LDAP et ainsi de suite. Il suffit d'écrire les fonctions
|
|
de ressource plugins et de les enregistrer auprès de Smarty.
|
|
</para>
|
|
|
|
<para>
|
|
Reportez-vous à la section <link linkend="plugins.resources">ressource plugins</link>
|
|
pour plus d'informations sur les fonctions que vous êtes censé fournir.
|
|
</para>
|
|
|
|
<note>
|
|
<para>
|
|
Notez que vous ne pouvez pas écraser la ressource <literal>file</literal> native,
|
|
toutefois, vous pouvez fournir une ressource qui récupère un template depuis
|
|
le systè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ête BD pour récupé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ê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é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écifier une fonction qui sera utilisée pour
|
|
récupérer le contenu d'un template dans le cas où le template
|
|
ne peut pas être récupéré depuis sa ressource. Une utilisation possible est
|
|
la création de templates à la volé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é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
|
|
--> |