registerPlugin()

registerPlugin()
Prev	Chapter 14. Smarty成员方法	Next

Name

registerPlugin() — 注册插件

说明

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

该函数将以插件的形式来注册函数或者方法。参数如下：

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 和 cache_attrs可被省略。参见缓存能力设置它们的值。

Example 14.39. 注册函数


<?php
$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());
}
?>

在模板中：


{date_now}

{* 或定义时间格式 *}
{date_now format="%Y/%m/%d"}

Example 14.40. 注册块函数


<?php
// 函数定义
function do_translation ($params, $content, $smarty, &$repeat, $template)
{
  if (isset($content)) {
    $lang = $params["lang"];
    // 这里可以放置翻译 $content 的代码
    return $translation;
  }
}

// 注册到Smarty
$smarty->registerPlugin("block","translate", "do_translation");
?>

模板中：


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

Example 14.41. 注册修饰器


<?php

// 我们将PHP的stripslashes函数映射成一个Smarty的修饰器
$smarty->registerPlugin("modifier","ss", "stripslashes");

?>

模板中可使用ss来过滤反斜线。


<?php
{$var|ss}
?>

参见 unregisterPlugin(), 插件函数, 块函数, 编译函数, 和修饰器。

Prev	Up	Next
registerFilter()	Home	registerObject()