Smarty - die kompilierende PHP Template-Engine
Zurück	Kapitel 16. Smarty durch Plugins erweitern	Nach vorne

Template-Funktionen

void smarty_function_name (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().

Beispiel 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}.

Beispiel 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']);
}
?>

Zurück	Zum Anfang	Nach vorne
Plugins schreiben	Nach oben	Variablen-Modifikatoren