Funciones Compiladoras

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 (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().

Ejemplo 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';
?>