e544ed6d9a
Comparing changes: https://github.com/smarty-php/smarty/compare/v4.3.1...v4.4.1 It is noticeable that Smarty 4.3.1 does not officially support PHP 8.3. Is only supported with 4.4.0. Remark: During tests with Smarty 4.5.1, it was noticed that the following warning occurs: Deprecated: Using the unregistered function "function_exists" in a template is deprecated and will be removed in a future version. Use Smarty::registerPlugin to explicitly register a custom modifier. As of Smarty 5.X.X, templates must be revised again. The Smarty release 5.0.2 is already officially available. However, integration into FlatPress is not entirely trivial.
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` and `cache_attrs` can be omitted in most cases. See
|
|
[controlling cacheability of plugins output](#caching.cacheable) on
|
|
how to use them 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.
|