Smarty Icon

You may use the Smarty logo according to the trademark notice.

Smarty Template Engine Smarty Template Engine

For sponsorship, advertising, news or other inquiries, contact us at:

Sites Using Smarty

Advertisement

Chapter 15. Caracteristicas Avanzadas

Objetos

El Smarty permite acceso a objetos de PHP a través de sus templates. Hay dos formas de accesarlos. Una forma es registrando objetos para el template, entonces acceselos mediante sintaxis similar a las funciones habituales. La otra es asignar objetos al template y accesarlos como si fueran una variable asignada. El primer método tiene una sintaxis de template mucho mas agradable. Y también mas segura, a medida que un objeto registrado puede ser reescrito a ciertos métodos y propiedades. Sin embargo tanto, un objeto registrado no puede ser puesto en loop o ser asignado en arreglos de objetos, etc. El método que usted escoja sera determinado por sus necesidades, pero utilice el primero método si es posible para mantener un minimo de sintaxis en el template.

Si $security esta habilitada, ninguno de los dos métodos privados o funciones pueden ser accesados (comenzando con "_"). Si un metodo y propiedades de un mismo nombre existe, el método será usado.

Usted puede restringir los métodos y propiedades que pueden ser accesados listandolos en un arreglo como el tercer parámetro de registro.

Por default, los parámetros pasados a los objetos a a través de los templates son pasados de la misma forma en que las funciones de costumbre los obtienen. Un arreglo asociativo es pasado como el primer parámetro, y el objeto smarty como el segundo. Si usted quiere que los parámetros pasados uno de cada vez por cada argumento pasen como parámetros de un objeto tradicional, defina el cuarto parámetro de registro en falso.

El quinto parámetro opcional solo tiene efecto con format siendo true y conteniendo una lista de métodos de ob que seran tratados como bloques. Esto significa que estos métodos tienen una etiqueta de cierre en el template ({foobar->meth2}...{/foobar->meth2}) y los parámetros para los métodos tienen la misma sinopsis como los parámetros de block-function-plugins: Ellos reciben 4 parámetros $params, $content, &$smarty y &$repeat también se comportan como block-function-plugins.

Example 15.1. usando un objeto registrado o atribuido


<?php
// el objeto

class My_Object {
 function meth1($params, &$smarty_obj) {
  return "this is my meth1";
 }
}

$myobj = new My_Object;
// registrando el objeto (será por referencia)
$smarty->register_object("foobar",$myobj);
// Si usted quiere restringir acceso a ciertos metodos o propriedades, listelos
$smarty->register_object("foobar",$myobj,array('meth1','meth2','prop1'));
// Si usted quiere usar el formato de parámetro del objeto tradicional, pase un booleano en false
$smarty->register_object("foobar",$myobj,null,false);

// también puede asignar ojetos. Posible cuando se asignan por referencia.
$smarty->assign_by_ref("myobj", $myobj);

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

  

y como debera accesar a su objeto en index.tpl


{* accesando a nuestro objeto registrado *}
{foobar->meth1 p1="foo" p2=$bar}

{* usted también puede asignar la salida *}
{foobar->meth1 p1="foo" p2=$bar assign="output"}
the output was {$output}

{* accesando a nuestro objeto asignado *}
{$myobj->meth1("foo",$bar)}