Inhaltsverzeichnis Weiterführende Möglichkeiten Eigene Smarty-Funktionen erstellen

Eigene Smarty-Funktionen erstellen

Gelegentlich werden in Templates eigene Smarty-Funktionen benötigt, die in der gewünschten Form nicht verfügbar sind.

Eigene Smarty-Funktionen können Verzeichnis /site/IhrMandant/plugins/smarty/ jeweils als function.meineFunktion.php definiert werden (wobei meineFunktion für den Namen der Funktion steht).

Beispiel 1

QuelltextPHP Code:
  1. // benötigtes Skript einbinden
  2. require_once('smarty/plugins/arg_smarty_functions.php');

  4. // neue Funktion definieren
  5. function smarty_function_meineFunktion($params, &$smarty)
  6. {
  7.     if(!$param['timestamp'])  // wenn der Parameter 'timestamp' nicht gesetzt wurde
  8.     {
  9.         $param['timestamp'] = time(); // die aktuelle Zeit verwenden
  10.     }
  11.     $result = date("d.m.Y",$param['timestamp']);

  13.     // am Ende des Skripts wird an die var-Variable das Ergebnis übergeben
  14.     $smarty->assign($params['var'], $result');
  15. }

Alle an die Smarty-Funktion übergebenen Parameter können innerhalb der Funktion über das Array $param verwenden werden. Die Beispiel-Funktion gibt ein formatiertes Datum aus. Als Parameter kann ein gewünschter Unix-Zeitstempel angegeben werden.

QuelltextSmarty Code:
  1. {* Aufruf der Funktion *}
  2. {meineFunktion timestamp=1261132764 var="datum_formatiert"}

  4. {* Verwenden des Ergebnisses *}
  5. Die Funktion gab als Ergebnis das Datum {$datum_formatiert} zurück.

Beispiel 2

QuelltextPHP Code:
  1. /**
  2. * Smarty Plugin für Ausgabe von News-Einträgen
  3. *
  4. * Datei: site/Mandant/plugins/smarty/function.get_news.php
  5. *
  6. * Gibt alle Unterseite vom Typ "news/entry" aus.
  7. * Beispiel: {get_news var=VARNAME page=PAGE-Object anzahl=ANZAHL}
  8. */

  10. require_once('smarty/plugins/arg_smarty_functions.php');

  12. function smarty_function_get_news($params, &$smarty)
  13. {
  14.     // Ist Anzahl angegeben?
  15.     $params['anzahl'] ? $params['anzahl'] : 10; // Standard = 10

  17.     // Kinder-Seiten auslesen
  18.     $kinder = $params['page']->getChildren(array('where' => "type='news/entry'",array('limit' => $params['anzahl'])));
  19.    
  20.     // Ergebnis an entsprechende Var-Variable übergeben
  21.     $smarty->assign($params['var'], $kinder);
  22. }
QuelltextSmarty Code:
  1. {* Funktionsaufruf im Template *}
  2. {get_news page=$page anzahl=5 var="news_eintraege"}

  4. {* Ausgabe der News *}
  5. {foreach from=$news_eintraege item="news"}
  6.     {$news->field.name} <br />
  8.    Leider existieren zur Zeit keine News
  9. {/foreach}