Ressources
Les templates peuvent provenir d'une grande variété de ressources. Quand vous
affichez (display()) ou
récupérez (fetch()) 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 $default_resource_type
sera utilisée.
Templates depuis $template_dir
Les templates du répertoire
$template_dir 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 $template_dir.
Utilisation de templates depuis $template_dir
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 *}
]]>
Templates à partir de n'importe quel répertoire
Les templates en-dehors du répertoire
$template_dir nécessitent
le type de ressource template, suivi du chemin absolu et du nom du
template.
Utilisation d'un template depuis n'importe quel répertoire
display("file:/export/templates/index.tpl");
$smarty->display("file:/path/to/my/templates/menu.tpl");
?>
]]>
Le template Smarty :
Chemin de fichiers Windows
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.
Utilisation de templates avec des chemins de fichiers Windows
display("file:C:/export/templates/index.tpl");
$smarty->display("file:F:/path/to/my/templates/menu.tpl");
?>
]]>
Le template Smarty :
Templates depuis d'autres sources
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.
Reportez-vous à la section ressource plugins
pour plus d'informations sur les fonctions que vous êtes censé fournir.
Notez que vous ne pouvez pas écraser la ressource file 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.
Utilisation de ressources utilisateurs
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");
?>
]]>
Le template Smarty :
Fonction de gestion de template par défaut
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.
utilisation de la fonction de gestion de template par défaut
_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';
?>
]]>