Концепция плагинов префильтров и постфильтров очень проста; они отличаются местом исполнения, или, точнее, временем их исполнения.
string smarty_prefilter_name( |
$source, | |
&$smarty); |
string $source;object &$smarty;Префильтры используются для обработки исходного кода шаблона непосредственно перед компиляцией. Первый параметр функции префильтра - это исходный код шаблона, который, возможно, уже изменен другими префильтрами. Такой плагин возвращает модифицированый исходный код. Заметьте, что этот исходный код нигде не сохраняется, он используется только для компиляции.
string smarty_postfilter_name( |
$compiled, | |
&$smarty); |
string $compiled;object &$smarty;Постфильтры используются для обработки скомпилированного вывода шаблона (по сути - PHP-кода) сразу по завершению компиляции, но перед сохранением откомпилированного шаблона в файловой системе. Первым параметром функции постфильтра является скомпилированный код шаблона, возможно уже модифицированый другими постфильтрами. Плагин возвращает модифицированную версию этого кода.
Example 16.7. Плагин префильтра
<?php
/*
* Smarty plugin
* -------------------------------------------------------------
* Файл: prefilter.pre01.php
* Тип: prefilter
* Имя: pre01
* Назначение: Перевести все тэги html в нижний регистр.
* -------------------------------------------------------------
*/
function smarty_prefilter_pre01($source, &$smarty)
{
return preg_replace('!<(\w+)[^>;]+>!e', 'strtolower("$1")', $source);
}
?>
Example 16.8. Плагин постфильтра
<?php
/*
* Smarty plugin
* -------------------------------------------------------------
* Файл: postfilter.post01.php
* Тип: postfilter
* Имя: post01
* Назначение: Вывести код, перечисляющий все текущие
* переменные шаблона.
* -------------------------------------------------------------
*/
function smarty_postfilter_post01($compiled, &$smarty)
{
$compiled = "<pre>\n<?php print_r(\$this->get_template_vars()); ?>\n</pre>" . $compiled;
return $compiled;
}
?>