void smarty_function_name( |
$params, | |
&$smarty); |
array $params;object &$smarty;
Tutti gli attributi passati dai template alle funzioni relative sono
contenuti in $params nella forma di un array
associativo.
L'output (valore di ritorno) della funzione sostituirà il tag della
funzione nel template (ad esempio con la funzione fetch).
In alternativa, la funzione potrebbe semplicemente svolgere qualche
altro compito, senza produrre output (funzione assign).
Se la funzione deve assegnare variabili al template, o usare qualche
altra funzionalità di Smarty, può usare per questo l'oggetto
$smarty che le viene passato.
Vedere anche: register_function(), unregister_function().
Example 16.1. plugin funzione con output
<?php
/*
* Smarty plugin
* -------------------------------------------------------------
* File: function.eightball.php
* Type: function
* Name: eightball
* Purpose: outputs a random magic answer
* -------------------------------------------------------------
*/
function smarty_function_eightball($params, &$smarty)
{
$answers = array('Yes',
'No',
'No way',
'Outlook not so good',
'Ask again soon',
'Maybe in your reality');
$result = array_rand($answers);
return $answers[$result];
}
?>
che può essere usata così nel template:
Question: Will we ever have time travel?
Answer: {eightball}.
Example 16.2. funzione plugin senza output
<?php
/*
* Smarty plugin
* -------------------------------------------------------------
* File: function.assign.php
* Type: function
* Name: assign
* Purpose: assign a value to a template variable
* -------------------------------------------------------------
*/
function smarty_function_assign($params, &$smarty)
{
if (empty($params['var'])) {
$smarty->trigger_error("assign: missing 'var' parameter");
return;
}
if (!in_array('value', array_keys($params))) {
$smarty->trigger_error("assign: missing 'value' parameter");
return;
}
$smarty->assign($params['var'], $params['value']);
}
?>