|
|
|
Risorse
I template possono arrivare da varie risorse. Quando fate la display o la
fetch di un template, o quando fate la include da un altro template,
fornite un tipo di risorsa, seguito dal percorso appropriato e dal nome
del template. Se non viene esplicitamente indicato un tipo di risorsa,
viene utilizzato il valore di $default_resource_type.
Template della $template_dir
I template provenienti dalla $template_dir non hanno bisogno che
indichiate un tipo di risorsa, sebbene possiate indicare file: per
coerenza. Basta che forniate il percorso per il template che volete
usare, relativo alla directory radice $template_dir.
Esempio 15-6. uso dei template della $template_dir
<?php
$smarty->display("index.tpl");
$smarty->display("admin/menu.tpl");
$smarty->display("file:admin/menu.tpl"); // equivale al precedente
?>
|
And from within Smarty template:
{include file="index.tpl"}
{include file="file:index.tpl"} {* equivale al precedente *} |
|
Template da qualsiasi directory
I template che si trovano al di fuori della $template_dir richiedono
obbligatoriamente che indichiate il tipo di risorsa file: seguito
dal percorso assoluto e dal nome del template.
Esempio 15-7. uso dei template da qualsiasi directory
<?php
$smarty->display("file:/export/templates/index.tpl");
$smarty->display("file:/path/to/my/templates/menu.tpl");
?>
|
And from within Smarty template:
{include file="file:/usr/local/share/templates/navigation.tpl"} |
|
Percorsi su Windows
Se usate una macchina Windows, i percorsi di solito comprendono
una lettera di drive (C:) all'inizio del percorso. Accertatevi
di usare "file:" nel path, per evitare conflitti di namespace e
ottenere i risultati voluti.
Esempio 15-8. uso di template da percorsi di Windows
<?php
$smarty->display("file:C:/export/templates/index.tpl");
$smarty->display("file:F:/path/to/my/templates/menu.tpl");
?>
{* dall'interno di un template *}
{include file="file:D:/usr/local/share/templates/navigation.tpl"}
|
|
Template da altre risorse
Potete ottenere template da qualsiasi risorsa alla quale sia
possibile accedere con PHP: database, socket, directory LDAP, e
così via. Potete farlo scrivendo una funzione plugin per le
risorse e registrandola a Smarty.
Consultate la sezione plugin
risorse per maggiori informazioni sulle funzioni che
dovrete creare.
Nota:
Notate che non è possibile modificare il comportamento della risorsa
file, ma potete fornire una risorsa che legge i
template dal filesystem in maniera diversa registrandola con un altro
nome di risorsa.
Esempio 15-9. uso di risorse personalizzate
<?php
// mettete queste funzioni da qualche parte nell'applicazione
function db_get_template ($tpl_name, &$tpl_source, &$smarty_obj)
{
// fate qui le chiamate al database per ottenere il template
// e riempire $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)
{
// qui facciamo una chiamata al db per riempire $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)
{
// ipotizziamo che tutti i template siano sicuri
return true;
}
function db_get_trusted($tpl_name, &$smarty_obj)
{
// non usata per i template
}
// register the resource name "db"
$smarty->register_resource("db", array("db_get_template",
"db_get_timestamp",
"db_get_secure",
"db_get_trusted"));
// uso della risorsa dallo script php
$smarty->display("db:index.tpl");
?>
|
And from within Smarty template:
{include file="db:/extras/navigation.tpl"} |
|
Funzione di gestione dei template di default
Potete specificare una funzione da usare per ottenere i contenuti
del template nel caso in cui non sia possibile leggerlo dalla
risorsa appropriata. Un uso possibile di questa funzione è di
creare al volo template che non esistono.
Esempio 15-10. uso della funzione di gestione dei template di default
<?php
// mettete questa funzione da qualche parte nell'applicazione
function make_template ($resource_type, $resource_name, &$template_source, &$template_timestamp, &$smarty_obj)
{
if( $resource_type == 'file' ) {
if ( ! is_readable ( $resource_name )) {
// create il file del template e restituite il contenuto.
$template_source = "This is a new template.";
$template_timestamp = time();
$smarty_obj->_write_file($resource_name,$template_source);
return true;
}
} else {
// non è un file
return false;
}
}
// impostate il gestore di default
$smarty->default_template_handler_func = 'make_template';
?>
|
|
|
|
|
