Controlando salida de Cacheabilidad de plugins

Desde Smarty-2.6.0 los caches de plugins pueden ser declarados o registrados. El tercer parámetro para register_block(), register_compiler_function() y register_function() es llamado $cacheable y el default es true que es también el comportamiento de plugins en la versiones anteriores a Smarty 2.6.0.

Cuando registre un plugin con $cacheable=false el plugin es llamado todo el tiempo en la pagina que está siendo mostrada, aun si la pagina viene desde el cache. La función de plugin tiene un comportamiento parecido al de la función insert.

En contraste con {insert} el atributo para el plugin no está en cache por default. Ellos pueden ser declarados para ser cacheados con el cuarto parámetro $cache_attrs. $cache_attrs es un arreglo de nombres de atributos que deben ser cacheados, entonces la función de plugin pega el valor como si fuera el tiempo en que la pagina fue escrita para el cache todo el tiempo este es traido desde el cache.

Ejemplo 14-10. Previniendo que una saída de plugin de ser cacheada

<?php
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->caching true;

function 
remaining_seconds($params, &$smarty) {
    
$remain $params['endtime'] - time();
    if (
$remain >=0)
        return 
$remain " second(s)";
    else
        return 
"done";
}

$smarty->register_function('remaining''remaining_seconds'false, array('endtime'));

if (!
$smarty->is_cached('index.tpl')) {
    
// fetch $obj from db and assign...
    
$smarty->assign_by_ref('obj'$obj);
}

$smarty->display('index.tpl');
?>

Donde index.tpl es:

Time Remaining: {remaining endtime=$obj->endtime}

El número en segundos hasta el endtime del $obj este sufre cambios en cada display de la pagina, aun si la pagina esta en cache. Desde que el atributo endtime sea cacheado el objeto solamente tiene que ser jalado de la base de datos cuando la pagina esta escrita en la cache mas no en requisiciones de la pagina.

Ejemplo 14-11. Previniendo una pasada entera del template para el cache

index.php:

<?php
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->caching true;

function 
smarty_block_dynamic($param$content, &$smarty) {
    return 
$content;
}
$smarty->register_block('dynamic''smarty_block_dynamic'false);

$smarty->display('index.tpl');
?>

Donde index.tpl es:

Page created: {"0"|date_format:"%D %H:%M:%S"}

{dynamic}

Now is: {"0"|date_format:"%D %H:%M:%S"}

... do other stuff ...

{/dynamic}

Cuando recarga la pagina usted notara que ambas fechas son diferentes. Una es "dinamica" y la otra es "estática". Usted puede hacer todo entre las etiquetas {dynamic}...{/dynamic} y tener la certeza de que no sera cacheado como el resto de la pagina.