mirror of
https://github.com/smarty-php/smarty.git
synced 2025-10-07 01:30:58 +02:00
cdf1ed2a50
- removing support for $cache_attrs for registered plugins,
- removing the undocumented {make_nocache} tag and the deprecated {insert} tag and associated code
- removing support for a compile_id property on include tags.
Fixes a bug in extends: resources by propagating the nocache-hashes between a master template and it's subtemplates in \Smarty\Template::_subTemplateRender. This might need further improvement.
111 lines
1.8 KiB
Markdown
111 lines
1.8 KiB
Markdown
registerPlugin()
|
|
|
|
dynamically register plugins
|
|
|
|
Description
|
|
===========
|
|
|
|
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:
|
|
|
|
- `cacheable` can be omitted in most cases. See
|
|
[controlling cacheability of plugins output](#caching.cacheable) on
|
|
how to use this properly.
|
|
|
|
<!-- -->
|
|
|
|
|
|
<?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());
|
|
}
|
|
?>
|
|
|
|
|
|
|
|
And in the template
|
|
|
|
|
|
{date_now}
|
|
|
|
{* or to format differently *}
|
|
{date_now format="%Y/%m/%d"}
|
|
|
|
|
|
<?php
|
|
// 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}
|
|
|
|
|
|
|
|
|
|
<?php
|
|
|
|
// let's map PHP's stripslashes function to a Smarty modifier.
|
|
$smarty->registerPlugin("modifier","ss", "stripslashes");
|
|
|
|
?>
|
|
|
|
In the template, use `ss` to strip slashes.
|
|
|
|
|
|
<?php
|
|
{$var|ss}
|
|
?>
|
|
|
|
See also [`unregisterPlugin()`](#api.unregister.plugin), [plugin
|
|
functions](#plugins.functions), [plugin block
|
|
functions](#plugins.block.functions), [plugin compiler
|
|
functions](#plugins.compiler.functions), and the [creating plugin
|
|
modifiers](#plugins.modifiers) section.
|