void smarty_function_name( |
$params, | |
&$smarty); |
array $params;object &$smarty;
Alle einer Funktion übergebenen Parameter werden in der Variable
$params als assoziatives Array abgelegt. Sie können
auf diese Werte entweder direkt mit $params['start'] zugreifen
oder sie mit extract($params) in die Symbol-Tabelle importieren.
Die Ausgabe der Funktion wird verwendet, um das Funktions-Tag im Template
(fetch Funktion, zum Beispiel) zu ersetzen.
Alternativ kann sie auch etwas tun, ohne eine Ausgabe zurückzuliefern
(assign Funktion, zum Beispiel).
Falls die Funktion dem Template Variablen zuweisen oder
auf eine andere Smarty-Funktionalität zugreifen möchte, kann dazu das
übergebene $smarty Objekt verwendet werden.
Sehen Sie dazu: register_function(), unregister_function().
Example 16.1. Funktionsplugin mit Ausgabe
<?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];
}
?>
Es kann im Template wie folgt angewendet werden:
Question: Will we ever have time travel?
Answer: {eightball}.
Example 16.2. Funktionsplugin ohne Ausgabe
<?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']);
}
?>