Get Smarty


Donate Bitcoin Bitcoin

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

Buy cheap glasses from and save up to 80%.

Where to buy prescription glasses? is your best choice!

Where to buy discount wedding dresses and cheap smart dresses free shipping -

Brautkleider auf

Buy New Arrival Cheap Prom Dresses 2015 at JDBRIDAL Prom Dress Store

Find Wedding Dresses Online at Canada from

Cheap bridesmaid dresses - rush delivery only 10 days delivery to Australia at

where cheap prom dresses uk at



registerPlugin() — dynamically register plugins


void registerPlugin(string type,
                    string name,
                    mixed callback,
                    bool cacheable,
                    mixed cache_attrs);

This method registers functions or methods defined in your script as plugin. It uses the following parameters:

  • type defines the type of the plugin. Valid values are "function", "block", "compiler" and "modifier".

  • name defines the name of the plugin.

  • callback defines the PHP callback. it can be either:

    • A string containing the function name

    • An array of the form array($object, $method) with $object being a reference to an object and $method being a string containing the method-name

    • An array of the form array($class, $method) with $class being the class name and $method being a method of the class.

  • cacheable and cache_attrs can be omitted in most cases. See controlling cacheability of plugins output on how to use them properly.

Example 14.39. register a function plugin

$smarty->registerPlugin("function","date_now", "print_current_date");

function print_current_date($params, $smarty)
  if(empty($params["format"])) {
    $format = "%b %e, %Y";
  } else {
    $format = $params["format"];
  return strftime($format,time());


And in the template


{* or to format differently *}
{date_now format="%Y/%m/%d"}

Example 14.40. register block function plugin

// function declaration
function do_translation ($params, $content, $smarty, &$repeat, $template)
  if (isset($content)) {
    $lang = $params["lang"];
    // do some translation with $content
    return $translation;

// register with smarty
$smarty->registerPlugin("block","translate", "do_translation");


Where the template is:

{translate lang="br"}Hello, world!{/translate}


Example 14.41. register modifier plugin


// let's map PHP's stripslashes function to a Smarty modifier.
$smarty->registerPlugin("modifier","ss", "stripslashes");


In the template, use ss to strip slashes.


See also unregisterPlugin(), plugin functions, plugin block functions, plugin compiler functions, and the creating plugin modifiers section.

by Karl on Nov 1, 2011 at 11:48
Example 14.40. register block function plugin
function do_translation ($params, $content, $smarty, &$repeat, $template)
The last parameter ($template) is not used (with 3.1.4 at least)
by raveren on Oct 25, 2011 at 7:43
Note, that this (sadly) does not support closures as the third parameter (v3.1.4): > Object of class Closure could not be converted to string
Post a Comment
All comments are moderated. Support questions are ignored, use the forums instead.
Email: (not shown)
What is 20 plus 1? (Are you human?)