Las funciones compiladoras solo son llamadas durante la compilación del template. Estas son útiles para inyectar codigo PHP o contenido estático time-sensitive dentro del template. Si existen ambas, una función compiladora y una función habitual registrada bajo el mismo nombre, la función compiladora tiene precedencia.
mixed smarty_compiler_name( |
$tag_arg, | |
&$smarty); |
string $tag_arg;object &$smarty;En las funciones compiladoras son pasados dos parámetros: la etiqueta string del argumento de la etiqueta - basicamente, todo a partir del nombre de la función hasta el delimitador del cierre, y el objeto del Smarty. Es supuesto que retorna el codigo PHP para ser inyectado dentro del template compilado.
Vea también register_compiler_function(), unregister_compiler_function().
Example 16.6. Función compiladora simple
<?php
/*
* Smarty plugin
* -------------------------------------------------------------
* File: compiler.tplheader.php
* Type: compiler
* Name: tplheader
* Purpose: Output header containing the source file name and
* the time it was compiled.
* -------------------------------------------------------------
*/
function smarty_compiler_tplheader($tag_arg, &$smarty)
{
return "\necho '" . $smarty->_current_file . " compiled at " . date('Y-m-d H:M'). "';";
}
?>
Esta función puede ser llamada en un template de la siguiente forma:
{* esta función es ejecutada solamente en tiempo de compilación *}
{tplheader}
El codigo PHP resultante en el template compilado seria algo asi:
<?php
echo 'index.tpl compiled at 2002-02-20 20:02';
?>