Get Smarty

Donate

Paypal

Smarty Icon

You may use the Smarty logo according to the trademark notice.

Smarty Template Engine Smarty Template Engine

For sponsorship, advertising, news or other inquiries, contact us at:

Sites Using Smarty

Advertisement

Template-Funktionen

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

    


Comments
No comments for this page.

Advertisement