What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
Table of Contents
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)}