SlideShare una empresa de Scribd logo

Smarty 2.6.14 Docs

G
Gina

Smarty es un motor de plantillas para PHP que facilita la separación de la lógica de la aplicación y la presentación del conte- nido. Smarty compila las plantillas en scripts de PHP para que no tengan que ser analizadas gramaticalmente en cada peti- ción, lo que mejora el rendimiento. Permite a los programadores concentrarse en la lógica de la aplicación y a los diseñado- res en el diseño de la presentación mediante etiquetas de plantilla.

Educación
1 de 185
Descargado 79 veces
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
Smarty Manual por Monte Ohrt <monte at ohrt dot com> y Andrei Zmievski <andrei@php.net>
Smarty Manual publicado 07-09-2007 Copyright © 2001-2005 New Digital Group, Inc.
Tabla de contenidos Prólogo .............................................................................................................................................. vi I. Iniciando .......................................................................................................................................... 1 1. Que es Smarty? ......................................................................................................................... 2 2. Instalación ................................................................................................................................ 4 Requerimentos ..................................................................................................................... 4 Instalación Básica ................................................................................................................. 4 Expandiendo la configuración ................................................................................................. 7 II. Smarty For Template Designers ........................................................................................................... 9 3. Basic Syntax ........................................................................................................................... 11 Comentarios ....................................................................................................................... 11 Variables ........................................................................................................................... 11 Funciones .......................................................................................................................... 12 Atributos ........................................................................................................................... 12 Colocando variables entre comillas dobles ............................................................................... 13 Matemáticas ....................................................................................................................... 13 Escaping Smarty Parsing ...................................................................................................... 14 4. Variables ................................................................................................................................ 15 Variables definidas desde PHP .............................................................................................. 15 Variables cargadas desde archivos de configuración ................................................................... 17 La variable reservada {$smarty} ............................................................................................ 18 5. Modificadores de variables ........................................................................................................ 21 capitalize ........................................................................................................................... 22 cat .................................................................................................................................... 22 count_characters ................................................................................................................. 23 count_paragraphs ................................................................................................................ 24 count_sentences .................................................................................................................. 24 count_words ...................................................................................................................... 25 date_format ........................................................................................................................ 25 default .............................................................................................................................. 27 escape ............................................................................................................................... 28 indent ............................................................................................................................... 29 lower ................................................................................................................................ 30 nl2br ................................................................................................................................. 30 regex_replace ..................................................................................................................... 31 replace .............................................................................................................................. 32 spacify .............................................................................................................................. 32 string_format ...................................................................................................................... 33 strip .................................................................................................................................. 34 strip_tags ........................................................................................................................... 34 truncate ............................................................................................................................. 35 upper ................................................................................................................................ 36 wordwrap .......................................................................................................................... 36 6. Combinando Modificadores ....................................................................................................... 38 7. Funciones Integradas ................................................................................................................ 39 capture .............................................................................................................................. 39 config_load ........................................................................................................................ 40 {foreach},{foreachelse} ....................................................................................................... 42 include .............................................................................................................................. 44 {include_php} .................................................................................................................... 45 insert ................................................................................................................................ 46 if,elseif,else ........................................................................................................................ 47 {ldelim},{rdelim} ............................................................................................................... 49 literal ................................................................................................................................ 50 iii
Smarty Manual {php} ............................................................................................................................... 50 section,sectionelse ............................................................................................................... 51 {strip} ............................................................................................................................... 60 8. Custom Functions .................................................................................................................... 61 {assign} ............................................................................................................................ 61 {counter} .......................................................................................................................... 62 cycle ................................................................................................................................. 63 {debug} ............................................................................................................................ 64 {eval} ............................................................................................................................... 64 {fetch} .............................................................................................................................. 65 {html_checkboxes} ............................................................................................................. 66 {html_image} ..................................................................................................................... 68 {html_options} ................................................................................................................... 68 {html_radios} ..................................................................................................................... 70 {html_select_date} .............................................................................................................. 72 {html_select_time} .............................................................................................................. 75 {html_table} ...................................................................................................................... 79 math ................................................................................................................................. 81 {mailto} ............................................................................................................................ 82 {popup_init} ...................................................................................................................... 84 popup ............................................................................................................................... 84 {textformat} ....................................................................................................................... 88 9. Config Files ............................................................................................................................ 92 10. Debugging Console ................................................................................................................ 93 III. Smarty For Programmers ................................................................................................................. 94 11. Constantes ............................................................................................................................ 96 SMARTY_DIR .................................................................................................................. 96 SMARTY_CORE_DIR ........................................................................................................ 96 12. Clase Variables de Smarty ....................................................................................................... 97 $template_dir ..................................................................................................................... 97 $compile_dir ...................................................................................................................... 97 $config_dir ........................................................................................................................ 98 $plugins_dir ....................................................................................................................... 98 $debugging ........................................................................................................................ 98 $debug_tpl ......................................................................................................................... 98 $debugging_ctrl .................................................................................................................. 99 $autoload_filters ................................................................................................................. 99 $compile_check .................................................................................................................. 99 $force_compile ................................................................................................................... 99 $caching ............................................................................................................................ 99 $cache_dir ........................................................................................................................ 100 $cache_lifetime ................................................................................................................. 100 $cache_handler_func .......................................................................................................... 100 $cache_modified_check ...................................................................................................... 100 $config_overwrite .............................................................................................................. 100 $config_booleanize ............................................................................................................ 101 $config_read_hidden .......................................................................................................... 101 $config_fix_newlines .......................................................................................................... 101 $default_template_handler_func ........................................................................................... 101 $php_handling ................................................................................................................... 101 $security .......................................................................................................................... 102 $secure_dir ....................................................................................................................... 102 $security_settings ............................................................................................................... 102 $trusted_dir ....................................................................................................................... 103 $left_delimiter ................................................................................................................... 103 $right_delimiter ................................................................................................................. 103 $compiler_class ................................................................................................................. 103 $request_vars_order ........................................................................................................... 103 iv
Smarty Manual $request_use_auto_globals ................................................................................................... 103 $error_reporting ................................................................................................................. 103 $compile_id ...................................................................................................................... 103 $use_sub_dirs .................................................................................................................... 104 $default_modifiers ............................................................................................................. 104 $default_resource_type ....................................................................................................... 104 13. La clase Methods() de Smarty ................................................................................................. 105 14. Cache ................................................................................................................................. 146 Configurando el Cache ........................................................................................................ 146 Multiples caches por pagina ................................................................................................. 148 Cache Groups .................................................................................................................... 149 Controlando salida de Cacheabilidad de plugins ....................................................................... 150 15. Caracteristicas Avanzadas ....................................................................................................... 152 Objetos ............................................................................................................................ 152 Prefilters .......................................................................................................................... 153 Postfilters ......................................................................................................................... 153 Filtros de salida ................................................................................................................. 154 Función manipuladora de cache ............................................................................................ 154 Recursos .......................................................................................................................... 156 16. Extendiendo Smarty con plugins .............................................................................................. 160 Como funcionan los Plugins ................................................................................................. 160 Nombres convencionales ..................................................................................................... 160 Escribiendo Plugins ............................................................................................................ 161 Funciones de Template ........................................................................................................ 161 Modificadores ................................................................................................................... 163 Block Functions ................................................................................................................. 164 Funciones Compiladoras ..................................................................................................... 165 Prefiltros/Postfiltros ............................................................................................................ 166 Filtros de Salida ................................................................................................................. 167 Fuentes ............................................................................................................................ 167 Inserts .............................................................................................................................. 169 IV. Appendixes .................................................................................................................................. 170 17. Localización de Errores .......................................................................................................... 171 Errores Smarty/PHP ........................................................................................................... 171 18. Consejos y Trucos ................................................................................................................. 173 Manipulación de Variables Vacias ......................................................................................... 173 Manipulación del valor default de una variable ........................................................................ 173 Pasando la variable titulo a la cabecera del template .................................................................. 174 Fechas ............................................................................................................................. 174 WAP/WML ...................................................................................................................... 175 Templates con Componetes .................................................................................................. 176 Ofuscando direcciones de E-mail .......................................................................................... 177 19. Fuentes ............................................................................................................................... 178 20. ERRORES ........................................................................................................................... 179 v
Prólogo Esta es indudablemente una de las preguntas que mas se hacen en las listas de correo de PHP: Como hacer mis scripts de PHP independientes del diseño?. Mientras PHP se encarga de como "incrustar scripts en lenguaje HTML", después de escri- bir los proyectos que mezclan PHP y HTML libremente, esto trae como consecuencia la idea de separar la forma y el conte- nido, muy buena idea[TM]. En adición, en muchas compañias la interpretación de esquema es diseñador y programador por separado. Por consiguiente, la busqueda trae como solución una plantilla(template). Por ejemplo en nuestra compañia, el desarrollo de una aplicación es como sigue: Después de tener la documentación nece- saria, el diseñador de web diseña el prototipo de la interfaz y la entrega al programador. El programador implementa las re- glas de negocio en PHP y usa el prototipo para crear el "esqueleto" de la plantilla. El proyeto esta en manos de la persona responsable del HTML designer/web page que produzca la plantilla para su gloria completa. El proyecto debe ir y regresar entre programación/HTML varias veces. De esa manera, es importante para tener un buen suporte de templates porque los programadores no quieren hacer nada con HTML ni quieren diseño HTML al rededor del codigo PHP. Los diseñadores pre- cisan de soporte para archivos de configuración, bloques dinámicos y otras interfaces usadas, mas ellos no quieren ocuparse con las compejidades del lenguaje de programación PHP. Buscando, actualmente existen muchas soluciones de templates disponibles para PHP, la mayor parte de ellos les provee de una forma rudimentaria de sustitución de variables dentro del template y hace una forma limitada de la funcionalidad diná- mica del bloque. Pero nuestras necesidades requieren mas que eso. Porque no queremos programadores que no quieran tener trato con HTML del todo, pero esto puede ser casi inevitable. Por ejemplo, si un diseñador quiere alternar colores de fondo sobre bloques dinámicos, esto tuvo que trabajarse con el programador anticipadamente. Nosotros necesitamos también que los diseñadores esten capacitados para usar archivos de configuración, y colocar variables de ellos dentro de los templates. La lista continua. Nosotros empezamos escribiendo por fuera una especulación para un motor de plantillas(templates) atrasado de 1999. Des- pués de terminar la especulación, comenzamos a trabajar un motor de plantillas escrito en C que esperanzadoramente fue aceptado para ser incorporado con PHP. No solamente nos encontramos con algunas complicadas barreras tecnicas, si no también hubo acalorados debates sobre lo que exactamente debia de hacer o no un motor de plantillas. De esta experiencia, decidimos que un motor de platillas devería ser escrito en PHP como una clase, para que cualquiera lo use de la misma for- ma como ellos ven. Así nosotros escribimos un motor que es SmartTemplate ™ nunca volvio a existir(nota: esa clase nunca fue enviada al público). Esta era una clase que ralizaba casi todo lo que nosotros necesitabamos: sustitución de variables re- gulares, soporte incluso de otras plantillas, integración con archivos de configuración, incrustación de código PHP, funcio- nalidades 'if' limitada y muchos mas bloques dinámicos robustos que podrían ser anidados muchas veces. Todo esto con ex- presiones regulares y el código producido seria mejor, como diriamos nosotros, impenetrable. Eso era también notoriamente lento en grandes aplicaciones por todas las interpretaciones y expresiones regulares trabajando en cada requisición. El ma- yor problema del punto de vista de un programador era todo el trabajo necesario en el procesamiento del scripts PHP y pro- cesamiento de bloques dinámicos de la plantilla. Como hacemos eso facilmente? Entonces se origino la visión de que finalmente se convirtiera en Smarty. Nosotros sabemos que rápido es el código PHP sin las cabeceras y la interpretación de plantillas(templates). También sabemos que meticuloso y arrogante es el lenguaje PHP su poder debe ser aceptable para un diseñador, y este podría ser enmascarado con una simples sintaxis de planti- llas(templates). Entonces que pasara si nosotros convinamos las dos fuerzas? De esta manera, nacio Smarty... vi
Parte I. Iniciando Tabla de contenidos 1. Que es Smarty? ................................................................................................................................. 2 2. Instalación ........................................................................................................................................ 4 Requerimentos ..................................................................................................................... 4 Instalación Básica ................................................................................................................. 4 Expandiendo la configuración ................................................................................................. 7 1
Capítulo 1. Que es Smarty? Smarty es un motor de plantillas para PHP. Mas especificamente, esta herramienta facilita la manera de separar la aplicación lógica y el contenido en la presentación. La mejor descripción esta en una situación donde la aplicación del programador y la plantilla del diseñador juegan diferentes roles, o en la mayoria de los casos no la misma persona. Por ejemplo: Digamos que usted crea una pagina web, es decir, despliega el articulo de un diario. El encabezado del articu- lo, el rotulo, el autor y el cuerpo son elementos del contenido, estos no contiene información de como quieren ser presenta- dos. Estos son pasados por la aplicación Smarty, donde el diseñador edita la plantilla, y usa una combinación de etiquetas HTML y etiquetas de plantilla para formatear la presentación de estos elementos (HTML, tablas, color de fondo, tamaño de letras, hojas de estilo, etc...). Un día el programador necesita cambiar la manera de recuperar el contenido del articulo(un cambio en la aplicación lógica.). Este cambio no afectara al diseñador de la plantilla, el contenido llegara a la plantilla exac- tamente igual. De la misma manera, si el diseñador de la plantilla quiere rediseñarla en su totalidad, estos cambios no afec- taran la aplicación lógica. Por lo tanto, el programador puede hacer cambios en la aplicación lógica sin que sea necesario restructurar la plantilla. Y el diseñador de la plantilla puede hacer cambios sin que haya rompimiento con la aplicación lógi- ca. One design goal of Smarty is the separation of business logic and presentation logic. This means templates can certainly contain logic under the condition that it is for presentation only. Things such as including other templates, altering table row colors, upper-casing a variable, looping over an array of data and displaying it, etc. are all examples of presentation logic. This does not mean that Smarty forces a separation of business and presentation logic. Smarty has no knowledge of which is which, so placing business logic in the template is your own doing. Also, if you desire no logic in your templates you cer- tainly can do so by boiling the content down to text and variables only. Ahora un pequeño resumen sobre que no hace Smarty. Smarty no intenta separar completamente la lógica de la plantilla. No hay problema entre la lógica y su plantilla bajo la condición que esta lógica sea estrictamente para presentación. Un consejo: mantener la aplicación lógica fuera de la plantilla, y la presentación fuera de la aplicación lógica. Esto tiene como finalidad tener un objeto mas manipulable y escalable para un futuro proximo. Un único aspecto acerca de Smarty es la compilación de la plantilla. De esta manera Smarty lee la plantilla y crea los scripts de PHP. Una vez creados, son executados sobre él. Por consiguiente no existe ningún costo por analizar gramaticalmente cada archivo de template por cada requisición, y cada template puede llevar toda la ventaja del compilador de cache de PHP tal como Zend Accelerator (http://www.zend.com/) o PHP Accelerator (http://www.php-accelerator.co.uk). Algunas de las características de Smarty: • Es extremamente rápido. • Es eficiente ya que puede interpretar el trabajo mas sucio. • No analiza gramaticalmente desde arriba el template, solo compila una vez. • El esta atento para solo recompilar los archivos de plantilla que fueron cambiados. • Usted puede crear funciones habituales y modificadores de variables customizados, de modo que el lenguaje de la plati- lla es altamente extensible. • Sintaxis de etiquetas delimitadoras para configuración de la plantilla, así lo puede usar {}, {{}}, <!--{}-->, etc. • Los construtoress if/elseif/else/endif son pasados por el interpretador de PHP, así la sintaxis de la expresión {if ...} pue- de ser compleja o simple de la forma que usted quiera. • Permite un anidamiento ilimitado de sections, ifs, etc. • Es posible incrustar directamente codigo PHP en los archivos de plantilla, aunque esto puede no ser necesario(no reco- mendado) dado que la herramienta se puede ajustar. 2
Que es Smarty? • Soporte de caching incrustado • Fuentes de Plantilla absoluto • Funciones habituales de manipulación de cache • Arquitectura de Plugin 3
Capítulo 2. Instalación Tabla de contenidos Requerimentos ..................................................................................................................................... 4 Instalación Básica ................................................................................................................................. 4 Expandiendo la configuración ................................................................................................................. 7 Requerimentos Smarty Requiere un servidor web corriendo PHP 4.0.6 o posterior. Instalación Básica Instale los archivos de la libreria de Smarty que estan en el directorio de distribución /libs/. Estos son los archivos PHP que usted NO EDITARA. Estos archivos son toda las aplicaciones comunes y ellos son actualizados cuando usted actualiza a una nueva versión de Smarty. Ejemplo 2.1. Archivos de la libreria Smarty Smarty.class.php Smarty_Compiler.class.php Config_File.class.php debug.tpl /internals/*.php (all of them) /plugins/*.php (all of them) Smarty utiliza una constante de PHP llamada SMARTY_DIR que es la ruta para el directorio de la biblioteca de Smarty 'libs/'. Basicamente, si su aplicación puede encontrar el archivo Smarty.class.php , usted no necesita definir SMARTY_DIR, Smarty lo encontrará. Por consiguiente si, Smarty.class.php no esta incluido en el path, y no es abas- tecido por una ruta absoluta para encontrar su aplicación, entonces usted debe definir SMARTY_DIR manualmente. SMARTY_DIR debe incluir una barra de seguimento. Aquí esta un ejemplo de como se crea una instancia de Smarty en sus scripts PHP: Ejemplo 2.2. Creando una instancia Smarty de Smarty <?php require('Smarty.class.php'); $smarty = new Smarty; ?> Intente correr el script de arriba. Si usted obtiene un error diciendo que el archivo Smarty.class.php no fue encontrado, puedes usar una de las siguientes opciones: 4
Instalación Ejemplo 2.3. Reemplazar por la ruta absulta de la libreria del archivo <?php require('/usr/local/lib/php/Smarty/Smarty.class.php'); $smarty = new Smarty; ?> Ejemplo 2.4. Adicionar el directorio de la libreria para incluirlo en el include_path de PHP <?php // Edite su archivo php.ini, y adicione el directorio de la libreria de Smarty // include_path y reinicie su servidor web. // Entonces lo siguiente debe funcionar: require('Smarty.class.php'); $smarty = new Smarty; ?> Ejemplo 2.5. Defina la constante SMARTY_DIR manualmente <?php define('SMARTY_DIR', '/usr/local/lib/php/Smarty/'); require(SMARTY_DIR . 'Smarty.class.php'); $smarty = new Smarty; ?> Ahora que la libreria de archivos esta en su sitio, es tiempo de configurar los directorios de Smarty para su aplicación. Smarty require cuatro directorios (por defaul) llamados 'templates/', 'templates_c/', 'configs/' y 'cache/'. Cada uno de estos son para definir las propiedades de las clases de Smarty. $template_dir, $compile_dir, $config_dir, y $cache_dir respectivamente. Es altamente recomendado que usted configure un grupo separado de estos directorios para cada aplicación que utilice de Smarty. Asegurece que usted sabe la ubicación del document root de su servidor web. En nuestro ejemplo, el document root esta en /web/www.example.com/docs/. Los directorios de Smarty solo son accesados por la libreria de Smarty y nunca son ac- cesados directamente por el navegador. Por consiguiente para evitar cualquier preocupación con la seguridad, es recomen- dado colocar estos directorios fuera del document root. Para nuestro ejemplo de instalación, configuraremos el ambiente de Smarty para una aplicación de libro de visitas. Escoje- mos una aplicación solo con el proposito de crear un directorio de nombre convencional. Usted puede usar el mismo am- biente para cualquier aplicación, solamente sustituya "guestbook" con el nombre de su aplicación. Nosotros colocaremos nuestros directorios de Smarty dentro de /web/www.example.com/smarty/guestbook/. Usted necesita tener por lo menos un archivo dentro de su document root, y que sea accesado por el navegador. Nosotros llamamos el script de 'index.php', y lo colocamos en un subdirectorio dentro del document root llamado /guestbook/. Nota Técnica: : Es conveniente configurar el servidor de forma que "index.php" pueda ser identificado como el ín- dice del directório padre, de esta manera si usted accesa http://www.example.com/guestbook/, el script index.php será ejecutado sin "index.php" ni la URL. En Apache usted puede definir el sitio adicionando "index.php" en el fi- nal de su configuración del directorio DirectoryIndex (separando cada uno con espacios.) como en el ejemplo de httpd.conf. 5
Instalación DirectoryIndex index.htm index.html index.php index.php3 default.html index.cgi Veamos nuestra estructura de archivos hasta hora: Ejemplo 2.6. Ejemplo de estrutura de archivo /usr/local/lib/php/Smarty/Smarty.class.php /usr/local/lib/php/Smarty/Smarty_Compiler.class.php /usr/local/lib/php/Smarty/Config_File.class.php /usr/local/lib/php/Smarty/debug.tpl /usr/local/lib/php/Smarty/internals/*.php /usr/local/lib/php/Smarty/plugins/*.php /web/www.example.com/smarty/guestbook/templates/ /web/www.example.com/smarty/guestbook/templates_c/ /web/www.example.com/smarty/guestbook/configs/ /web/www.example.com/smarty/guestbook/cache/ /web/www.example.com/docs/guestbook/index.php Smarty necesitara permisos de escritura (usuarios de windows ingnorar) para $compile_dir y $cache_dir, esto garantiza que el usuario del servidor pueda escribir en ellos. Este es generalmente el usuarios "nobody" y el grupo "nobody". Para usuarios con X sistema operativo, el default es "www" y el grupo "www". Si usted esta usando Apache, puede ver en su ar- chivo httpd.conf (normalmente en "/usr/local/apache/conf/") cual es el usuario y grupo que estan siendo usados. Ejemplo 2.7. Configurando permisos de archivos chown nobody:nobody /web/www.example.com/smarty/guestbook/templates_c/ chmod 770 /web/www.example.com/smarty/guestbook/templates_c/ chown nobody:nobody /web/www.example.com/smarty/guestbook/cache/ chmod 770 /web/www.example.com/smarty/guestbook/cache/ Nota Técnica: : chmod 770 puede ser una seguridad bastante fuerte, solo le permite al usuario "nobody" y al grupo "nobody" acesso de lectura/escritura a los directorios. Si usted quiere abrir permiso de lectura a cualquiera (en la mayoria de las veces para su propia conveniencia de querer ver estos archivos), usted puede usar el 775 en lugar del 770. Nosotros necesitamos crear el archivo index.tpl, para que Smarty lo pueda cargar. Este estara localizado en su $template_dir. Ejemplo 2.8. Editando /web/www.example.com/smarty/guestbook/templates/index.tpl {* Smarty *} Hello, {$name}! Nota Técnica:: {* Smarty *} Esto es un comentario en el template. Este no es obligatorio, pero si una buena prac- tica iniciar todos sus archivos de plantilla con estos comentarios. Esto hace facilmente reconocibles a los archivos a pesar la extención del archivo. Por ejemplo, editores de texto pueden reconocer el archivo y habilitar un realce de sintaxis especial. Ahora vamos a editar el index.php. crearemos una instancia de Smarty, daremos valor a las variables del template y mostra- 6
Instalación remos el archivo index.tpl. En el ambiente de nuestro ejemplo, "/usr/local/lib/php/Smarty" esta dentro de include_path. Ase- gurese que exista el mismo, o utilice la ruta absoluta. Ejemplo 2.9. Editando /web/www.example.com/docs/guestbook/index.php <?php // load Smarty library require('Smarty.class.php'); $smarty = new Smarty; $smarty->template_dir = '/web/www.example.com/smarty/guestbook/templates/'; $smarty->compile_dir = '/web/www.example.com/smarty/guestbook/templates_c/'; $smarty->config_dir = '/web/www.example.com/smarty/guestbook/configs/'; $smarty->cache_dir = '/web/www.example.com/smarty/guestbook/cache/'; $smarty->assign('name','Ned'); $smarty->display('index.tpl'); ?> Nota Técnica: : En nuestro ejemplo, estamos configurando rutas absolutas para todos los directorios de Smarty. Si /web/www.example.com/smarty/guestbook/ está dentro de su include_path de PHP, entonces estas declara- ciones no son necesarias. Sin embargo, esto es mas eficiente y (por experiencia) tiene menos tendencia a errores en relación a determinar las rutas absolutas. Esto garantiza que Smarty esta recibiendo los archivos del directorio que usted desea. Ahora carge el archivo index.php desde su navegador web. Usted debera ver "Hello, Ned!" Usted a completado la configuracion basica para el Smarty! Expandiendo la configuración Esta es una continuación de la instalación básica, por favor lea esta primero! Una forma un poco mas flexible de configurar el Smarty, expandir las clases e iniciar su ambiente de Smarty. Es, en vez de configurar rutas de directorios repetidamente, asigne esas mismas a variables, etc., nosotros podemos facilitar eso. Vamos a crear un nuevo directorio en "/php/includes/guestbook/" y llamemos al nuevo archivo setup.php . En nuestro ejemplo, "/ php/includes" está en nuestro include_path. Verifique que usted también lo definio, o utilice rutas absolutas de los archivos. Ejemplo 2.10. Editando /php/includes/guestbook/setup.php <?php // load Smarty library require('Smarty.class.php'); // The setup.php file is a good place to load // required application library files, and you // can do that right here. An example: // require('guestbook/guestbook.lib.php'); class Smarty_GuestBook extends Smarty { function Smarty_GuestBook() { 7
Instalación // Class Constructor. // These automatically get set with each new instance. $this->Smarty(); $this->template_dir = '/web/www.example.com/smarty/guestbook/templates/'; $this->compile_dir = '/web/www.example.com/smarty/guestbook/templates_c/'; $this->config_dir = '/web/www.example.com/smarty/guestbook/configs/'; $this->cache_dir = '/web/www.example.com/smarty/guestbook/cache/'; $this->caching = true; $this->assign('app_name', 'Guest Book'); } } ?> Ahora vamos a modificar el archivo index.php para usar el setup.php: Ejemplo 2.11. Editando /web/www.example.com/docs/guestbook/index.php <?php require('guestbook/setup.php'); $smarty = new Smarty_GuestBook; $smarty->assign('name','Ned'); $smarty->display('index.tpl'); ?> Ahora usted vera que es completamente simple crear una instancia de Smarty, solo use Smarty_GuestBook, que automática- mente inicializa todo para nuestra aplicación. 8
Parte II. Smarty For Template Designers Tabla de contenidos 3. Basic Syntax ................................................................................................................................... 11 Comentarios ....................................................................................................................... 11 Variables ........................................................................................................................... 11 Funciones .......................................................................................................................... 12 Atributos ........................................................................................................................... 12 Colocando variables entre comillas dobles ............................................................................... 13 Matemáticas ....................................................................................................................... 13 Escaping Smarty Parsing ...................................................................................................... 14 4. Variables ........................................................................................................................................ 15 Variables definidas desde PHP .............................................................................................. 15 Variables cargadas desde archivos de configuración ................................................................... 17 La variable reservada {$smarty} ............................................................................................ 18 5. Modificadores de variables ................................................................................................................ 21 capitalize ........................................................................................................................... 22 cat .................................................................................................................................... 22 count_characters ................................................................................................................. 23 count_paragraphs ................................................................................................................ 24 count_sentences .................................................................................................................. 24 count_words ...................................................................................................................... 25 date_format ........................................................................................................................ 25 default .............................................................................................................................. 27 escape ............................................................................................................................... 28 indent ............................................................................................................................... 29 lower ................................................................................................................................ 30 nl2br ................................................................................................................................. 30 regex_replace ..................................................................................................................... 31 replace .............................................................................................................................. 32 spacify .............................................................................................................................. 32 string_format ...................................................................................................................... 33 strip .................................................................................................................................. 34 strip_tags ........................................................................................................................... 34 truncate ............................................................................................................................. 35 upper ................................................................................................................................ 36 wordwrap .......................................................................................................................... 36 6. Combinando Modificadores ............................................................................................................... 38 7. Funciones Integradas ........................................................................................................................ 39 capture .............................................................................................................................. 39 config_load ........................................................................................................................ 40 {foreach},{foreachelse} ....................................................................................................... 42 include .............................................................................................................................. 44 {include_php} .................................................................................................................... 45 insert ................................................................................................................................ 46 if,elseif,else ........................................................................................................................ 47 {ldelim},{rdelim} ............................................................................................................... 49 literal ................................................................................................................................ 50 {php} ............................................................................................................................... 50 section,sectionelse ............................................................................................................... 51 {strip} ............................................................................................................................... 60 9
Smarty For Template Designers 8. Custom Functions ............................................................................................................................ 61 {assign} ............................................................................................................................ 61 {counter} .......................................................................................................................... 62 cycle ................................................................................................................................. 63 {debug} ............................................................................................................................ 64 {eval} ............................................................................................................................... 64 {fetch} .............................................................................................................................. 65 {html_checkboxes} ............................................................................................................. 66 {html_image} ..................................................................................................................... 68 {html_options} ................................................................................................................... 68 {html_radios} ..................................................................................................................... 70 {html_select_date} .............................................................................................................. 72 {html_select_time} .............................................................................................................. 75 {html_table} ...................................................................................................................... 79 math ................................................................................................................................. 81 {mailto} ............................................................................................................................ 82 {popup_init} ...................................................................................................................... 84 popup ............................................................................................................................... 84 {textformat} ....................................................................................................................... 88 9. Config Files .................................................................................................................................... 92 10. Debugging Console ........................................................................................................................ 93 10
Capítulo 3. Basic Syntax Tabla de contenidos Comentarios ....................................................................................................................................... 11 Variables ........................................................................................................................................... 11 Funciones .......................................................................................................................................... 12 Atributos ........................................................................................................................................... 12 Colocando variables entre comillas dobles ............................................................................................... 13 Matemáticas ....................................................................................................................................... 13 Escaping Smarty Parsing ...................................................................................................................... 14 Todas las etiquetas del template deben estar marcadas por delimitadores. Por default , estos delimitadores son { y }, sino es- tos pueden cambiar. Para estos ejemplos, nosotros asumiremos que usted está usando los delimitadores por default. En Smarty, todo el contenido fuera de los delimitadores es mostrado como contenido estatico, o igual(sin cambios). Cuando Smarty encuentra etiquetas en el template, trata de interpretarlos, e intenta mostrar la salida apropiada en su lugar. Comentarios Los comentarios en los templates son cercados por asteriscos, y por los delimitadores, así: {* este es un comentario *}. Los comentarios en Smarty no son mostrados en la salida final del template. semejantes a <!-- HTML comments --> Estos son usados para hacer notas internas dentro del template. Ejemplo 3.1. Comentarios <body> {* this multiline comment is not sent to browser *} {* include the header file here *} {include file="header.tpl"} {* Dev note: $includeFile is assigned foo.php script *} <!-- this html comment is sent to browser --> {include file=$includeFile} {include file=#includeFile#} {* display dropdown lists *} <select name="company"> {html_options options=$vals selected=$selected_id} </select> </body> Variables Las variable de Template que comiencen con signo de pesos. Pueden contener números, letras y guiones bajos, muy pareci- 11
Basic Syntax do a las variables de PHP [http://php.net/language.variables]. Usted también puede hacer referencia a arreglos que puden ser numericos o no-numericos. También puede hacer referencia a métodos y propiedades de objetos. Config file variables es una excepción de la sintaxis del signo de pesos. También puede ser referenciado entre #signos de numeros#, o con la varia- ble especial $smarty.config. Ejemplo 3.2. Variables {$foo} <-- displaying a simple variable (non array/object) {$foo[4]} <-- display the 5th element of a zero-indexed array {$foo.bar} <-- display the "bar" key value of an array, similar to PHP $foo['bar'] {$foo.$bar} <-- display variable key value of an array, similar to PHP $foo[$bar] {$foo->bar} <-- display the object property "bar" {$foo->bar()} <-- display the return value of object method "bar" {#foo#} <-- display the config file variable "foo" {$smarty.config.foo} <-- synonym for {#foo#} {$foo[bar]} <-- syntax only valid in a section loop, see {section} {assign var=foo value="baa"}{$foo} <-- displays "baa", see {assign} Many other combinations are allowed {$foo.bar.baz} {$foo.$bar.$baz} {$foo[4].baz} {$foo[4].$baz} {$foo.bar.baz[4]} {$foo->bar($baz,2,$bar)} <-- passing parameters {"foo"} <-- static values are allowed Vea también $smarty reserved variables y Config Variables. Funciones Cada etiqueta Smarty muestra una variable o utiliza algún tipo de función. Las funciones son procesadas y mostradas colo- cando los atributos de la función entre delimitadores, así: {funcname attr1="val" attr2="val"}. Ejemplo 3.3. Sintaxis de Funciones {config_load file="colors.conf"} {include file="header.tpl"} {if $highlight_name} Welcome, <font color="{#fontColor#}">{$name}!</font> {else} Welcome, {$name}! {/if} {include file="footer.tpl"} Las funciones internas y las funciones habituales, ambas deben tener la misma sintaxis dentro del template. Las funciones internas que funcionan en Smarty, son: {if}, {section} y {strip}. Estas no pueden ser modificadas. Las funciones habituales son funciones adicionales implementadas por plugins. Estas si pueden ser modificadas como usted quiera, o usted también puede adicionar nuevas. {html_options} y {popup} son ejemplos de funciones habituales. Atributos 12
Basic Syntax La mayoria de las funciones llevan atributos que especifican o cambian su funcionamiento. Los atributos para las funciones de Smarty son muy parecidos a los atributos de HTML. Los valores estaticos no necesitan estar entre comillas, pero si es re- comendado para cadenas y literales. Las variables también pueden ser usadas y no precisamente estando entre comillas. Algunos atributos requieren valores boleanos(true o false). Estos pueden ser especificados como cualquier otro valor sin co- millas true, on, y yes, o false, off, y no. Ejemplo 3.4. Sintaxis de atributos de Funciones {include file="header.tpl"} {include file="header.tpl" attrib_name="attrib value"} {include file=$includeFile} {include file=#includeFile# title="Smarty is cool"} {html_select_date display_days=yes} <select name="company"> {html_options options=$choices selected=$selected} </select> Colocando variables entre comillas dobles Smarty puede reconocer variables asignadas entre comillas aunque estas solo tengan números, letras, guiones bajos y cor- chetes[]. Con cualquier otro carácter(puntos, referencia de objetos, etc.) las variables deben estar entre apostrofos. Usted no puede incrustar modificadores, Estos deben ser siempre aplicados fuera de las comillas. Ejemplo 3.5. Sintaxis entre comillas SYNTAX EXAMPLES: {func var="test $foo test"} <-- sees $foo {func var="test $foo_bar test"} <-- sees $foo_bar {func var="test $foo[0] test"} <-- sees $foo[0] {func var="test $foo[bar] test"} <-- sees $foo[bar] {func var="test $foo.bar test"} <-- sees $foo (not $foo.bar) {func var="test `$foo.bar` test"} <-- sees $foo.bar {func var="test `$foo.bar` test"|escape} <-- modifiers outside quotes! PRACTICAL EXAMPLES: {include file="subdir/$tpl_name.tpl"} <-- will replace $tpl_name with value {cycle values="one,two,`$smarty.config.myval`"} <-- must have backticks Ver también escape. Matemáticas Las matemáticas pueden ser aplicadas directamente al los valores de las variables. Ejemplo 3.6. Ejemplos de matemáticas {$foo+1} 13
Basic Syntax {$foo*$bar} {* some more complicated examples *} {$foo->bar-$bar[1]*$baz->foo->bar()-3*7} {if ($foo+$bar.test%$baz*134232+10+$b+10)} {$foo|truncate:"`$fooTruncCount/$barTruncFactor-1`"} {assign var="foo" value="`$foo+$bar`"} Ver también la función{math}. Escaping Smarty Parsing En algunas ocaciones es deseable o hasta necesario que Smarty tenga que ingonar sections o algun otro tipo analisis de sin- taxis. Un ejemplo clasico es con el codigo JavaScript o CSS incrustado en el template. El problema se origina cuando aque- llos lenguajes que utilizan los caracteres { y } los cuales son también los delimitadores por default para Smarty. Esta puede ser una simple situación separando enteramente su codigo JavaScript y CSS dentro de un archivo personal y uti- lizar el metodo standar del HTML para el acceso. Es posible usar literal incluyendo el contenido del bloque {literal} .. {/literal}. Similar a usar entidades HTML, usted puede usar {ldelim},{rdelim} o {$smarty.ldelim} para mostrar los delimitadores actuales. Esto a menudo es conveniente para cambios simples a Smarty's $left_delimiter y $right_delimiter. Ejemplo 3.7. Ejemplo cambiando delimitadores <?php $smarty = new Smarty; $smarty->left_delimiter = '<!--{'; $smarty->right_delimiter = '}-->'; $smarty->assign('foo', 'bar'); $smarty->display('example.tpl'); ?> Donde example.tpl es: <script language="javascript"> var foo = <!--{$foo}-->; function dosomething() { alert("foo is " + foo); } dosomething(); </script> Ver También escape modifier 14
Capítulo 4. Variables Tabla de contenidos Variables definidas desde PHP .............................................................................................................. 15 Variables cargadas desde archivos de configuración ................................................................................... 17 La variable reservada {$smarty} ............................................................................................................ 18 Smarty tiene varios tipos diferentes de variables. El tipo de variable depende de cual simbolo este prefijado(incluido den- tro). Las variables de Smarty no pueden ser mostradas directamente o usadas como argumentos para atributos, funciones y modi- ficadores, dentro de expresiones condicionales, etc. Para mostrar una variable, simplesmente coloque esta entre delimitado- res siendo esta la única cosa entre ellos. Ejemplos: {$Name} {$Contacts[row].Phone} <body bgcolor="{#bgcolor#}"> Variables definidas desde PHP Las variables que son asignadas desde PHP son referenciadas precedidas estas con una señal de cifrado $. Las variables de- finidas dentro del template como una función assign también son mostradas de esta manera. Ejemplo 4.1. variables definidas php script <?php $smarty = new Smarty; $smarty->assign('firstname', 'Doug'); $smarty->assign('lastname', 'Evans'); $smarty->assign('meetingPlace', 'New York'); $smarty->display('index.tpl'); ?> Donde el contenido de index.tpl es: Hello {$firstname} {$lastname}, glad to see you can make it. <br /> {* this will not work as $vars are case sensitive *} This weeks meeting is in {$meetingplace}. {* this will work *} This weeks meeting is in {$meetingPlace}. esta es la salida: 15
Variables Hello Doug Evans, glad to see you can make it. <br /> This weeks meeting is in . This weeks meeting is in New York. Arreglos asociativos Usted también puede referenciar matrices asociativas en variables que son definidas desde PHP especificando la clave des- pués del simbolo '.'(punto). Ejemplo 4.2. Accesando variables de matriz asociativa <?php $smarty->assign('Contacts', array('fax' => '555-222-9876', 'email' => 'zaphod@slartibartfast.com', 'phone' => array('home' => '555-444-3333', 'cell' => '555-111-1234') ) ); $smarty->display('index.tpl'); ?> Donde el contenido de index.tpl es: {$Contacts.fax}<br /> {$Contacts.email}<br /> {* you can print arrays of arrays as well *} {$Contacts.phone.home}<br /> {$Contacts.phone.cell}<br /> esta es la salida: 555-222-9876<br /> zaphod@slartibartfast.com<br /> 555-444-3333<br /> 555-111-1234<br /> Índices de Matrices Usted podra referencia matrizes por su índice, muy semejantes a la sintaxis de PHP. Ejemplo 4.3. Accesando matrices por sus índices <?php $smarty->assign('Contacts', array( '555-222-9876', 'zaphod@slartibartfast.com', array('555-444-3333', '555-111-1234') )); $smarty->display('index.tpl'); ?> 16
Variables Donde index.tpl es: {$Contacts[0]}<br /> {$Contacts[1]}<br /> {* you can print arrays of arrays as well *} {$Contacts[2][0]}<br /> {$Contacts[2][1]}<br /> esta es la salida: 555-222-9876<br /> zaphod@slartibartfast.com<br /> 555-444-3333<br /> 555-111-1234<br /> Objects Las propiedades de los objetos definidos desde PHP pueden ser referenciados especificando el nombre de la propiedad des- pués del simbolo '->'. Ejemplo 4.4. Accesando propiedades de los Objetos name: {$person->name}<br /> email: {$person->email}<br /> esta es la salida: name: Zaphod Beeblebrox<br /> email: zaphod@slartibartfast.com<br /> Variables cargadas desde archivos de configura- ción Las variables que son cargadas de archivos de configuración son referenciadas incluyendo entre ellas el signo(#), o como variables de Smarty $smarty.config. La segunda sintaxis es util para incrustar valores de un atributo dentro de comillas. Ejemplo 4.5. Variables de configuración foo.conf: pageTitle = "This is mine" bodyBgColor = "#eeeeee" tableBorderSize = "3" tableBgColor = "#bbbbbb" rowBgColor = "#cccccc" index.tpl: {config_load file="foo.conf"} <html> <title>{#pageTitle#}</title> 17
Variables <body bgcolor="{#bodyBgColor#}"> <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> <tr bgcolor="{#rowBgColor#}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> index.tpl: (sintaxis alternativa) {config_load file="foo.conf"} <html> <title>{$smarty.config.pageTitle}</title> <body bgcolor="{$smarty.config.bodyBgColor}"> <table border="{$smarty.config.tableBorderSize}" bgcolor="{$smarty.config.tableBgColor}"> <tr bgcolor="{$smarty.config.rowBgColor}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> esta es la salida de ambos ejemplos: <html> <title>This is mine</title> <body bgcolor="#eeeeee"> <table border="3" bgcolor="#bbbbbb"> <tr bgcolor="#cccccc"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> Las variables de un archivo de configuración no pueden ser usadas hasta después de que son cargadas por los archivos de configuración. Este procedimento es explicado posteriormente en este documento en {config_load}. Ver también Variables y $smarty reserved variables La variable reservada {$smarty} La variable reservada {$smarty} puede ser utilizada para accesar a variables especiales del template. A continuación una lis- ta completa. Solicitud de Variables La solicitud de variables [http:/ / php.net/ reserved.variables] como $_GET, $_POST, $_COOKIE, $_SERVER, $_ENV y $_SESSION (Ver $request_vars_order y $request_use_auto_globals) pueden ser accesadas como se muestra en los ejem- plos de abajo: Ejemplo 4.6. Mostrando solicitud de variables 18
Variables {* display value of page from URL (GET) http://www.domain.com/index.php?page=foo *} {$smarty.get.page} {* display the variable "page" from a form (POST) *} {$smarty.post.page} {* display the value of the cookie "username" *} {$smarty.cookies.username} {* display the server variable "SERVER_NAME" *} {$smarty.server.SERVER_NAME} {* display the system environment variable "PATH" *} {$smarty.env.PATH} {* display the php session variable "id" *} {$smarty.session.id} {* display the variable "username" from merged get/post/cookies/server/env *} {$smarty.request.username} nota: Por historicas razones {$SCRIPT_NAME} puede ser accesado directamente sin embargo {$smarty.server.SCRIPT_NAME} es el sugerido para accesar este valor. {$smarty.now} El timestamp [http://php.net/function.time] actual puede ser accesado con {$smarty.now}. El número refleja el número de segundos pasados desde la llamada Epoca (1 de Enero de 1970) y puede ser pasado directamente para el modificador da- te_format para mostrar la fecha. Ejemplo 4.7. Usando {$smarty.now} {* utilice el modificador date_format para mostrar la fecha y hora actual *} {$smarty.now|date_format:"%Y-%m-%d %H:%M:%S"} {$smarty.const} Usted puede accesar al valor de constantes PHP directamente. Ver también smarty constants Ejemplo 4.8. Usando {$smarty.const} {$smarty.const._MY_CONST_VAL} {$smarty.capture} La salida capturada via {capture}..{/capture} puede ser accesada usando la variable {$smarty}. vea la sección {capture} pa- ra un ejemplo. {$smarty.config} La variable {$smarty} puede ser usada para referir variables de configuración cargadas. {$smarty.config.foo} es un sinóni- 19
Variables mo para {#foo#}. vea la sección sobre {config_load} para un ejemplo. {$smarty.section}, {$smarty.foreach} La variable {$smarty} puede ser usada para hacer referencia a las propiedades 'section' y 'foreach' del loop. Ver la documen- tación sobre section y foreach. {$smarty.template} Esta variable contiene el nombre actual del template que esta siendo procesado. {$smarty.version} Esta variable contiene la versión Smarty con que es compilado el template. {$smarty.ldelim}, {$smarty.rdelim} Esta variable es usada para imprimir literalmente el valor left-delimiter y right-delimiter. Ver tambien {ldelim},{rdelim}. Ver también Variables y Config Variables 20
Capítulo 5. Modificadores de variables Tabla de contenidos capitalize ........................................................................................................................................... 22 cat .................................................................................................................................................... 22 count_characters ................................................................................................................................. 23 count_paragraphs ................................................................................................................................ 24 count_sentences .................................................................................................................................. 24 count_words ...................................................................................................................................... 25 date_format ........................................................................................................................................ 25 default .............................................................................................................................................. 27 escape ............................................................................................................................................... 28 indent ............................................................................................................................................... 29 lower ................................................................................................................................................ 30 nl2br ................................................................................................................................................. 30 regex_replace ..................................................................................................................................... 31 replace .............................................................................................................................................. 32 spacify .............................................................................................................................................. 32 string_format ...................................................................................................................................... 33 strip .................................................................................................................................................. 34 strip_tags ........................................................................................................................................... 34 truncate ............................................................................................................................................. 35 upper ................................................................................................................................................ 36 wordwrap .......................................................................................................................................... 36 Los modificadores de variables pueden ser aplicados a variables, funciones habituales o cadenas. Para aplicar un modifica- dor, especifique el valor seguido por |(pipe) y el nombre del modificador. Un modificador necesita parámetros adicionales que afetan en su funcionamento. Estos parámetros siguen al nombre del modificador y son separados por : (dos puntos). Ejemplo 5.1. Ejemplo de modificador {* apply modifier to a variable *} {$title|upper} {* modifier with parameters *} {$title|truncate:40:"..."} {* apply modifier to a function parameter *} {html_table loop=$myvar|upper} {* with parameters *} {html_table loop=$myvar|truncate:40:"..."} {* apply modifier to literal string *} {"foobar"|upper} {* using date_format to format the current date *} {$smarty.now|date_format:"%Y/%m/%d"} {* apply modifier to a custom function *} {mailto|upper address="me@domain.dom"} Si usted aplica un modificador a una matriz en lugar del valor de una variable, el modificador va a ser aplicado en cada uno de los valores de la matriz. Si usted realmente quisiera que el modificador funcionara en una matriz entera, debe colocar el 21
Modificadores de variables simbolo @ antes del nombre del modificador, así como: {$articleTitle|@count} (esto mostrara el número de elemen- tos de la matriz $articleTitle.) Los modificadores pueden ser cargados automáticamente a partir de su $plugins_dir (vea también: Naming Conventions) o pueden ser registrados explicitamente (vea: register_modifier). Adicionalmente, todas las funciones de php pueden ser utili- zadas como modificadores implicitamente. (El ejemplo @count de arriba usa actualmente la función count de php y no un modificador de Smarty). Usar funciones de php como modificadores tiene dos pequeños problemas: Primero, algunas veces al ordenar los parámetros de una función esto no es aconsejable ({"%2.f"|sprintf:$float} actualmente funciona, pero existe algo mas intuitivo Por ejemplo: {$float|string_format:"%2.f"} que es proporcionado con la distribución de Smarty). Segundo: con $security activado, todas las funciones de php que sean utilizadas como modificadores deben ser de- claradas como variables de una matriz $security_settings['MODIFIER_FUNCS'] . Ver también register_modifier(), register_function(), Extending Smarty with plugins y modifiers, capitalize Posicion del Parame- Tipo Requerido Default Descripción tro 1 boolean No false Este determina que pa- labra con digitos no de- be ser convertida Este es usado para convertir a mayuscula la primera letra de todas la palabras de una variable. Ejemplo 5.2. capitalize <?php $smarty->assign('articleTitle', 'next x-men film, x3, delayed.'); ?> Donde el template es: {$articleTitle} {$articleTitle|capitalize} {$articleTitle|capitalize:true} Esta es la salida: next x-men film, x3, delayed. Next X-Men Film, x3, Delayed. Next X-Men Film, X3, Delayed. Ver también lower upper cat Posiscion del Parame- Tipo Requerido cat Descripción tro 1 string No empty Este es el valor para concatenar con la va- 22
Modificadores de variables Posiscion del Parame- Tipo Requerido cat Descripción tro riable dada. Este valor es concatenado con la variable dada. Ejemplo 5.3. cat <?php $smarty->assign('articleTitle', "Psychics predict world didn't end"); ?> Donde el template es: {$articleTitle|cat:" yesterday."} Esta es la salida: Psychics predict world didn't end yesterday. count_characters Posición del Parame- Tipo Requerido Default Descripción tro 1 boolean No false Este determina cuando incluir o no los espa- cios en blanco al con- tar. Este es usado para contar el número de carácteres en una variable. Ejemplo 5.4. count_characters <?php $smarty->assign('articleTitle', 'Cold Wave Linked to Temperatures.'); ?> Donde el template es: {$articleTitle} {$articleTitle|count_characters} {$articleTitle|count_characters:true} esta es la salida: Cold Wave Linked to Temperatures. 29 23
Modificadores de variables 33 ver también count_words, count_sentences y count_paragraphs. count_paragraphs Este es usado para contar el número de parrafos en la variable. Ejemplo 5.5. count_paragraphs <?php $smarty->assign('articleTitle', "War Dims Hope for Peace. Child's Death Ruins Couple's Holiday.nn Man is Fatally Slain. Death Causes Loneliness, Feeling of Isolation." ); ?> Donde el template es: {$articleTitle} {$articleTitle|count_paragraphs} Esta es la salida: War Dims Hope for Peace. Child's Death Ruins Couple's Holiday. Man is Fatally Slain. Death Causes Loneliness, Feeling of Isolation. 2 ver también count_characters, count_sentences y count_words. count_sentences Este es usado para contar el número de frases en la variable. Ejemplo 5.6. count_sentences <?php $smarty->assign('articleTitle', 'Two Soviet Ships Collide - One Dies. Enraged Cow Injures Farmer with Axe.' ); ?> Donde el template es: {$articleTitle} {$articleTitle|count_sentences} 24
Modificadores de variables esta es la salida: Two Soviet Ships Collide - One Dies. Enraged Cow Injures Farmer with Axe. 2 ver también count_characters, count_paragraphs y count_words. count_words Este es usado para contar el número de palabras en la variable. Ejemplo 5.7. count_words <?php $smarty->assign('articleTitle', 'Dealers Will Hear Car Talk at Noon.'); ?> Donde el template es: {$articleTitle} {$articleTitle|count_words} esta es la salida: Dealers Will Hear Car Talk at Noon. 7 ver también count_characters, count_paragraphs y count_sentences. date_format Posición del Parame- Tipo Requerido Default Descripción tro 1 string No %b %e, %Y Este es el formato para la fecha mostrada. 2 string No n/a Este es el default de la fecha si el valor de en- trada es vacio. Estos formatos de fecha y hora estan dentro del formato determinado strftime() [http://php.net/strftime]. Las fechas pueden ser pasadas a Smarty como timestamps [http:/ / php.net/ function.time] unix, timestamps mysql, o como cualquier cadena compuesta de mes dia año (pasada por strtotime() [http://php.net/strtotime]). El diseñador puede usar entonces date_format para tener un control completo del formateo de la fecha. Si la fecha pasada para date_format estuviera vacia y un segundo parámetro fuera pasado, este será usado como la fecha a formatear. Ejemplo 5.8. date_format 25
Modificadores de variables <?php $smarty->assign('yesterday', strtotime('-1 day')); ?> Where template is (uses $smarty.now): {$smarty.now|date_format} {$smarty.now|date_format:"%D"} {$smarty.now|date_format:"%I:%M %p"} {$yesterday|date_format} {$yesterday|date_format:"%A, %B %e, %Y"} {$yesterday|date_format:"%H:%M:%S"} This will output: Feb 6, 2001 02/06/01 02:33 pm Feb 5, 2001 Monday, February 5, 2001 14:33:00 date_format especificadores de conversión: • %a - nombre del día de la semana abreviado de acuerdo al local actual • %A - nombre del día de la semana anterior de acuerdo al local actual • %b - nombre del mes abreviado de acuerdo al local actual • %B - nombre del mes anterior de acuerdo al local actual • %c - Representación preferencial de la fecha y hora local actual • %C - año con dos dígitos (o año dividido por 100 y truncadopara un entero, intervalo de 00 a 99) • %d - día del mes como un número decimal (intervalo de 00 a 31) • %D - Lo mismo que %m/%d/%y • %e - Día del mes como un número decimal, un único dígito y precedido por un espacio (intervalo de 1 a 31) • %g - Año basado en la semana, sin el siglo [00,99] • %G - Año basado en la semana, incluyendo el siglo [0000,9999] • %h - Lo mismo que %b • %H - Hora como un número decimal usando un relój de 24 horas (intervalo de 00 a 23) • %I - Hora como un número decimal usando un relój de 12 horas (intervalo de 01 a 12) • %j - Día del año como um número decimal (intervalo de 001 a 366) • %k - Hora (relój de 24 horas) digítos únicos que son precedidos por un espacio en blanco (intervalo de 0 a 23) • %l - Hora como un número decimal usando un relój de 12 horas, digítos únicos son precedidos por un espacio en blanco 26
Modificadores de variables (intervalo de 1 a 12) • %m - Mes como número decimal (intervalo de 01 a 12) • %M - Minuto como un número decimal • %n - Caracter de nueva linea • %p - Cualquiera `am' o `pm' de acuerdo con el valor de la hora dado, o la cadena correspondiente a la local actual • %r - Hora con notación a.m. y p.m. • %R - Hora con notación de 24 horas • %S - Segundo como número decimal • %t - Caracter tab • %T - Hora actual, igual a %H:%M:%S • %u - Día de la semana como un número decimal [1,7], representando con 1 el lunes • %U - Número de la semana del año actual como un número decimal, comenzando con el primer domingo como primer dia de la primera semana • %V - Número de la semana del año actual como número decimal de acuerdo con el ISO 8601:1988, intervalo de 01 a 53, en donde 1 es la primera semana que tenga por lo menos cuatro dias en el año actual, siendo domingo el primer dia de la semana. • %w - Día de la semana como decimal, siendo domingo 0 • %W - Número de la semana del año actual como número decimal, comenzando con el primer lunes como primer dia de la primera semana • %x - Representación preferida para la fecha local actual sin la hora • %X - Representación preferida de la hora local actual sin la fecha • %y - Año como número decimal sin el siglo(intervalo de 00 a 99) • %Y - Año como número decimal incluyendo el siglo • %Z - Zona horaria, o nombre, o abreviación • %% - Un carácter `%' NOTA PARA PROGRAMADORES:: date_format es escencialmente una envoltura para la función strftime() [http://php.net/strftime] de PHP. Usted debera tener mas o menos especificadores de conversiones disponibles de acuerdo con la función strftime() [http:/ / php.net/ strftime] del sistema operacional en donde PHP fue compilado. Cheque en la pagina del manual de su sistema una lista completa de especificadores validos. Ver también $smarty.now, php function strftime() [http://php.net/strftime], {html_select_date} y date tips. default 27
Modificadores de variables Pocisión del Parame- Tipo Requerido Default Descripción tro 1 string No empty Este es el valor por de- fecto para mostrar una variable que estuviera vacia. Este es usado para definir un valor por defecto para una variable. Si esta variable estuviera vacia o no estuviera definida, el valor por defecto es mostrado. El valor por defecto es usado como argumento. Ejemplo 5.9. default <?php $smarty->assign('articleTitle', 'Dealers Will Hear Car Talk at Noon.'); ?> Donde el template es: {$articleTitle|default:"no title"} {$myTitle|default:"no title"} Esta es la salida: Dealers Will Hear Car Talk at Noon. no title Ver también Default Variable Handling y Blank Variable Handling. escape Posición del Para- Tipo Requerido Posibles Valores Default Description metro 1 string No html,htmlall,url,qu html Este es el formato otes,hex,hexentity,j de escape a utilizar. avascript Este es usado para escapar html, url, comillas simples para escapar una variable que no este escapada, escapar hex, hexen- tity o javascript. Por default, la variable html es escapada. Ejemplo 5.10. escape <?php $smarty->assign('articleTitle', "'Stiff Opposition Expected to Casketless Funeral Plan'" ); ?> 28
Modificadores de variables Donde el template es: {$articleTitle} {$articleTitle|escape} {$articleTitle|escape:"html"} {* escapes & " ' < > *} {$articleTitle|escape:"htmlall"} {* escapes ALL html entities *} {$articleTitle|escape:"url"} {$articleTitle|escape:"quotes"} <a href="mailto:{$EmailAddress|escape:"hex"}">{$EmailAddress|escape:"hexentity"}</a> esta es la salida: 'Stiff Opposition Expected to Casketless Funeral Plan' &#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; &#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; &#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; %27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27 'Stiff Opposition Expected to Casketless Funeral Plan' <a href="mailto:%62%6f%..snip..%65%74">&#x62;&#x6f;&#x62..snip..&#x65;&#x74;</a> Ver también Escaping Smarty Parsing y Obfuscating E-mail Addresses. indent Posición del Parame- Tipo requerido Default Descripción tro 1 integer No 4 Este defíne con cuantos carácteres endentar. 2 string No (un espacio) Este defíne cual carác- ter va a ser usado para endentar. Esta endenta una cadena en cada linea, el default es 4. Como parámetro opcional, usted puede especificar el número de ca- rácteres para endentar. Como segundo parámetro opcional, usted puede especificar el carácter que desea usar para endentar. (Use "t" para tabs.) Ejemplo 5.11. indent <?php $smarty->assign('articleTitle', 'NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25.' ); ?> Donde el template es: {$articleTitle} {$articleTitle|indent} {$articleTitle|indent:10} 29
Modificadores de variables {$articleTitle|indent:1:"t"} esta es la salida: NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25. NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25. NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25. NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25. ver también strip y spacify. lower Esta es usada para convertir a minúsculas una variable. Ejemplo 5.12. lower <?php $smarty->assign('articleTitle', 'Two Convicts Evade Noose, Jury Hung.'); ?> Donde el template es: {$articleTitle} {$articleTitle|lower} esta es la salida: Two Convicts Evade Noose, Jury Hung. two convicts evade noose, jury hung. ver también upper y Capitalize. nl2br Todos los saltos de linea seran convertidos a etiquetas <br /> como datos de la variable. Esto equivale a la función nl2br() [http://php.net/nl2br] de PHP. Ejemplo 5.13. nl2br 30
Modificadores de variables <?php $smarty->assign('articleTitle', "Sun or rain expectedntoday, dark tonight" ); ?> Donde el template es: {$articleTitle|nl2br} esta debe ser la salida: Sun or rain expected<br />today, dark tonight Ver también word_wrap, count_paragraphs y count_sentences. regex_replace Posición del Parame- Tipo requerido Default Descripción tro 1 string Si n/a Esta es la expresión re- gular a ser substituida. 2 string Si n/a Esta es la cadena que sustituira a la expresión regular. Localiza una expresión regular y la remplaza en la variable. Use la sintaxis para preg_replace() [http://php.net/preg_replace] del manual de PHP. Ejemplo 5.14. regex_replace <?php $smarty->assign('articleTitle', "Infertility unlikely tonbe passed on, experts say."); ?> Donde index.tpl es: {* replace each carriage return, tab and new line with a space *} {$articleTitle} {$articleTitle|regex_replace:"/[rtn]/":" "} Esta es la salida: Infertility unlikely to be passed on, experts say. Infertility unlikely to be passed on, experts say. 31
Modificadores de variables Vea también replace y escape. replace Posición del Parame- Tipo Requerido Default Descripción tro 1 string Si n/a Esta es la cadena a ser substituida. 2 string Si n/a Esta es la cadena que ira a substituir. Una simple busqueda y substituir en la variable. Esta es equivalente a la función str_replace() [http://php.net/str_replace] de PHP. Ejemplo 5.15. replace <?php $smarty->assign('articleTitle', "Child's Stool Great for Use in Garden."); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|replace:"Garden":"Vineyard"} {$articleTitle|replace:" ":" "} Esta es la Salida: Child's Stool Great for Use in Garden. Child's Stool Great for Use in Vineyard. Child's Stool Great for Use in Garden. ver también regex_replace y escape. spacify Posición del Parame- Tipo Requerido Default Descripción tro 1 string No one space Este se inserta entre ca- da carácter de la varia- ble. Inserta un espacio entre cada carácter de una variable. Usted puede opcionalmente pasar un carácter (o una cadena) diferen- te para insertar. Ejemplo 5.16. spacify 32
Modificadores de variables <?php $smarty->assign('articleTitle', 'Something Went Wrong in Jet Crash, Experts Say.'); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|spacify} {$articleTitle|spacify:"^^"} Esta es la Salida: Something Went Wrong in Jet Crash, Experts Say. S o m e t h i n g W e n t W r o n g i n J e t C r a s h , E x p e r t s S a y . S^^o^^m^^e^^t^^h^^i^^n^^g^^ ^^W^^e^^n^^t^^ ^^W^^r^^o^^n^^g^^ ^^i^^n^^ ^^J^^e^^t^^ ^^C^^r^^a^^s^^h^^,^^ Ver también wordwrap y nl2br. string_format Posición del Parame- Tipo Requerido Default Descripción tro 1 string Si n/a Este es el formato que debera usar. (sprintf) Esta es una manera de formatear cadenas, como números decimales y otros. Use la sintaxis de sprintf [http://php.net/sprintf] para formatearlo. Ejemplo 5.17. string_format <?php $smarty->assign('number', 23.5787446); ?> Donde index.tpl es: {$number} {$number|string_format:"%.2f"} {$number|string_format:"%d"} Esta es la Salida: 23.5787446 23.58 24 Ver también date_format. 33
Modificadores de variables strip Este substituye todos los espacios repetidos, nuevas lineas y tabs por un unico espacio u otra cadena indicada. Nota: Si usted quiere substituir bloques de texto de un template use la función {strip}. Ejemplo 5.18. strip <?php $smarty = new Smarty; $smarty->assign('articleTitle', "Grandmother ofneight makest hole in one."); $smarty->display('index.tpl'); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|strip} {$articleTitle|strip:"&nbsp;"} Esta es la Salida: Grandmother of eight makes hole in one. Grandmother of eight makes hole in one. Grandmother&nbsp;of&nbsp;eight&nbsp;makes&nbsp;hole&nbsp;in&nbsp;one. strip_tags Posición del Parame- Tipo Requerido Default descripción tro 1 bool No true Este determina cuando las etiquetas seran rem- plazadas por ' ' o por '' Este retira las etiquetas de marcación, basicamente todo entre < y >. Ejemplo 5.19. strip_tags <?php $smarty->assign('articleTitle', "Blind Woman Gets <font face="helvetica">New Kidney</font> from Dad she Hasn't Seen in <b>years</b>."); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|strip_tags} {* same as {$articleTitle|strip_tags:true} *} {$articleTitle|strip_tags:false} 34
Modificadores de variables Esta es la Salida: Blind Woman Gets <font face="helvetica">New Kidney</font> from Dad she Hasn't Seen in <b>years</b>. Blind Woman Gets New Kidney from Dad she Hasn't Seen in years . Blind Woman Gets New Kidney from Dad she Hasn't Seen in years. truncate Posición del Parame- Tipo Requerido Default Desdcripción tro 1 integer No 80 Este determina para cuantos carácteres trun- car. 2 string No ... Este es el texto para adicionar si el trunca- miento ocurre. La lon- gitud NO se incluye pa- ra la logitud del trunca- miento 3 boolean No false Este determina cuando truncar o no o al final de una palabra(false), o un carácter exac- to(true). 3 boolean No false Este determina cuando ocurre el truncamiento al final de la cade- na(false), o en el centro de la cadena(true). No- ta cuando este es true, entonces la palabra li- mite es ignorada. Este trunca la variable en una cantidad de cacarteres, el default es 80. Como segundo parámetro opcional, usted puede espe- cificar una cadena para mostrar al final si la variable fue truncada. Los carácteres en la cadena son incluidos tamando el ori- ginal para el truncamiento. Por default, truncate intentara cortar al final de una palabra. Se usted quisiera cortar una cantidad exacta de carácteres, pase el tercer parámetro, que es opcional, como true. Ejemplo 5.20. truncate <?php $smarty->assign('articleTitle', 'Two Sisters Reunite after Eighteen Years at Checkout Counter.'); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|truncate} {$articleTitle|truncate:30} {$articleTitle|truncate:30:""} {$articleTitle|truncate:30:"---"} 35
Modificadores de variables {$articleTitle|truncate:30:"":true} {$articleTitle|truncate:30:"...":true} Esta es la Salida: Two Sisters Reunite after Eighteen Years at Checkout Counter. Two Sisters Reunite after Eighteen Years at Checkout Counter. Two Sisters Reunite after... Two Sisters Reunite after Two Sisters Reunite after--- Two Sisters Reunite after Eigh Two Sisters Reunite after E... upper Este es usado para convertir a mayusculas una variable. Ejemplo 5.21. upper <?php $smarty->assign('articleTitle', "If Strike isn't Settled Quickly it may Last a While."); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|upper} Esta es la Salida: If Strike isn't Settled Quickly it may Last a While. IF STRIKE ISN'T SETTLED QUICKLY IT MAY LAST A WHILE. Ver también lower y capitalize. wordwrap Posición del Parame- Tipo Requerido Default Descripción tro 1 integer No 80 Este determina en cuantas columnas cor- tar. 2 string No n Esta es la cadena usada para cortar. 3 boolean No false Este determina cuando cortar o no, o al final de una palabra(false), o en un carácter exac- to(true). 36
Modificadores de variables Este wordwrap corta una cadena para un ancho de columna, el default es 80. Como segundo parámetro opcional, usted pue- de especificar la cadena que será usada para cortar el texto para la próxima linea (el default es un retorno de carro n). Por default, (wordwrap) intentara cortar al final de una palabra. Si usted quisiera cortar un tamaño exacto de cacarteres, pase al tercer parámetro, que es opcional, como true. Este es equivalente a la función wordwrap() [http:/ / php.net/ wordwrap] de PHP. Ejemplo 5.22. wordwrap <?php $smarty->assign('articleTitle', "Blind woman gets new kidney from dad she hasn't seen in years."); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|wordwrap:30} {$articleTitle|wordwrap:20} {$articleTitle|wordwrap:30:"<br />n"} {$articleTitle|wordwrap:30:"n":true} Esta es la Salida: Blind woman gets new kidney from dad she hasn't seen in years. Blind woman gets new kidney from dad she hasn't seen in years. Blind woman gets new kidney from dad she hasn't seen in years. Blind woman gets new kidney<br /> from dad she hasn't seen in<br /> years. Blind woman gets new kidney from dad she hasn't seen in years. Ver También nl2br y {textformat}. 37
Capítulo 6. Combinando Modificadores Usted puede aplicar cualquier cantidad de modificadores para una variable. Estos seran aplicados en el orden en el que fue- ron combinados, de izquierda a derecha. Estos deben ser separados con el carácter |(pipe). Ejemplo 6.1. Combinando Modificadores <?php $smarty->assign('articleTitle', 'Smokers are Productive, but Death Cuts Efficiency.'); ?> Donde el template es: {$articleTitle} {$articleTitle|upper|spacify} {$articleTitle|lower|spacify|truncate} {$articleTitle|lower|truncate:30|spacify} {$articleTitle|lower|spacify|truncate:30:". . ."} La salida del ejemplode arriba: Smokers are Productive, but Death Cuts Efficiency. S M O K E R S A R ....snip.... H C U T S E F F I C I E N C Y . s m o k e r s a r ....snip.... b u t d e a t h c u t s... s m o k e r s a r e p r o d u c t i v e , b u t . . . s m o k e r s a r e p. . . 38
Capítulo 7. Funciones Integradas Tabla de contenidos capture .............................................................................................................................................. 39 config_load ........................................................................................................................................ 40 {foreach},{foreachelse} ....................................................................................................................... 42 include .............................................................................................................................................. 44 {include_php} .................................................................................................................................... 45 insert ................................................................................................................................................ 46 if,elseif,else ........................................................................................................................................ 47 {ldelim},{rdelim} ............................................................................................................................... 49 literal ................................................................................................................................................ 50 {php} ............................................................................................................................................... 50 section,sectionelse ............................................................................................................................... 51 {strip} ............................................................................................................................................... 60 Smarty cuenta con varias funciones integradas. Las funciones Integradas forman parte del lenguaje del template. Usted no puede crear funciones personalizadas con el mismo nombre, ni puede modificar las funciones integradas. capture Nombre del Atributo Tipo Requerido Default Descripción name string no default El nombre del bloque capturado assign string No n/a El nombre de la varia- ble para dar valor a la salida capturada {capture} es usado para recolectar toda la salida del template en una variable en lugar de mostrarla. Cualquier contenido en- tre {capture name="foo"} y {/capture} es recoletado en una variable especificada y el atributo name. El contenido capturado puede ser usado en el template a partir de la variable especial $smarty.capture.foo en donde foo es el valor pasado para el atributo name. Si usted no pasa un atributo name, entonces será usado "default". Todos lo comandos {capture} deben estar entre {/capture}. Usted puede anidar(colocar uno dentro de otro) comandos capture. Nota Tecnica: Smarty 1.4.0 - 1.4.4 coloca el contenido capturado dentro de la variable llamada $return. A partir de 1.4.5, este funcionamento fue cambiado para usar el atributo name, entonces en consecuencia actualice sus templa- tes. Atención Tenga cuidado cuando capture la salida del comando {insert}. Si tuviera activo el cache y tuviera comandos {insert} y usted espera que funcione con contenido de cache, no se capturara este contenido. Ejemplo 7.1. capturando contenido de template {* no queremos imprimir la fila de la tabla a menos que exista 39
Funciones Integradas contenido para desplegar *} {capture name=banner} {include file="get_banner.tpl"} {/capture} {if $smarty.capture.banner ne ""} <tr> <td> {$smarty.capture.banner} </td> </tr> {/if} Ver También $smarty.capture, {eval}, {fetch}, fetch() y {assign}. config_load Nombre del Atributo Tipo Requerido Default Descripción file string Si n/a El nombre del archivo de configuración a in- cluir section string No n/a El nombre de la sec- ción a cargar scope string no local Como el scope carga las variables debe ser tratado de manera lo- cal, como padre y no como global. local indi- ca que las variables son cargadas en el contexto del template local. pa- rent indica que las va- riables son cargadas en el contexto actual y en el template que llamo. global indica que las variables estan disponi- bles para todos los tem- plates. global boolean No No Cuando las variables no son vistas en el tem- plate padre (al que lla- mo este), lo mismo que scope=parent. NOTA: este atributo esta obso- leto pero el atributo scope, puede dar el so- porte. Si scope es el in- dicado, este valor es ig- norado. Esta función es usada para cargar las #variables# de un archivo de configuración dentro de un template. Vea Config Files para mayor información. 40
Funciones Integradas Ejemplo 7.2. Función {config_load} ejemplo.conf #this is config file comment # global variables pageTitle = "Main Menu" bodyBgColor = #000000 tableBgColor = #000000 rowBgColor = #00ff00 #customer variables section [Customer] pageTitle = "Customer Info" y el template {config_load file="example.conf"} <html> <title>{#pageTitle#|default:"No title"}</title> <body bgcolor="{#bodyBgColor#}"> <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> <tr bgcolor="{#rowBgColor#}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> Los archivos de configuración pueden contener secciones también. Usted puede cargar variables de una sección adicionando el atributo 'section'. nota: Config file sections es la función integrada de template {section} no tiene nada que ver uno con el otro, ellos justamente por casualidad tiene en común el convensionalismo del nombre. Ejemplo 7.3. Función config_load con section {config_load file="ejemplo.conf" section="Customer"} <html> <title>{#pageTitle#}</title> <body bgcolor="{#bodyBgColor#}"> <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> <tr bgcolor="{#rowBgColor#}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> Vea también Config files, Config variables, $config_dir, get_config_vars() y config_load(). 41
Funciones Integradas {foreach},{foreachelse} Nombre del Atributo Tipo Requerido Default Descripción from array Si n/a El nombre de la matriz a la que usted estara pegando los elementos item string Si n/a El nombre de la varia- ble que es el elemento actual key string No n/a El nombre de la varia- ble que es la llave ac- tual name string No n/a El nombre del ciclo fo- reach para acessar a las propiedades del foreach Los ciclos(loop) foreach son una alternativa para loop {section}. foreach es usado para pegar cada elemento de una matriz asociativa simple. La sintaxis para foreach es mucho mas simple que section, pero tiene una desventaja de que solo puede ser usada en una única matriz. La etiqueta foreach debe tener su par /foreach. Los parámetros requeridos son from e item. El nombre del ciclo(loop) foreach puede ser cualquier cosa que usted quiera, hecho de letras, números y subrayados. Los ci- clos(loop) foreach pueden ser anidados, y el nombre de los ciclos(loop) anidados debe ser diferente uno de otro. La variable from (normalmente una matriz de valores) determina el número de veces del ciclo(loop) foreach. foreachelse y ejecutando cuando no hubieren mas valores en la variable from. Ejemplo 7.4. foreach <?php $arr = array( 1001,1002,1003); $smarty->assign('custid', $arr); ?> {* este ejemplo muestra todos los valores de la matriz $custid *} {foreach from=$custid item=curr_id} id: {$curr_id}<br /> {/foreach} Esta es la salida del ejemplo de arriba: id: 1000<br /> id: 1001<br /> id: 1002<br /> Ejemplo 7.5. foreach key // La llave contiene la llave para cada valor del ciclo(loop) //asignacion fisica de esta manera: <?php $smarty->assign('contacts', array( array('phone' => '1', 'fax' => '2', 'cell' => '3'), array('phone' => '555-4444', 'fax' => '555-3333', 42
Funciones Integradas 'cell' => '760-1234') )); ?> {foreach name=outer item=contact from=$contacts} <hr /> {foreach key=key item=item from=$contact} {$key}: {$item}<br /> {/foreach} {/foreach} Esta es la salida del ejemplo de arriba: <hr /> phone: 1<br /> fax: 2<br /> cell: 3<br /> <hr /> phone: 555-4444<br /> fax: 555-3333<br /> cell: 760-1234<br /> Ejemplo 7.6. Ejemplo de {foreach} - con base de datos (eg PEAR o ADODB) <?php $sql = 'select contact_id, name, nick from contacts order by contact'; $smarty->assign("contacts", $db->getAssoc($sql)); ?> {foreach key=cid item=con from=$contacts} <a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br /> {/foreach} El ciclo(Loop) foreach también tiene sus propias variables para manipular las propiedades del foreach. Estas son indicadas así: {$smarty.foreach.foreachname.varname} con foreachname siendo el nombre especificado del atributo name del foreach. Ver {section} para ejemplos ide las propiedades bajo las cuales son identicos. iteration iteration es usado para mostrar la interación actual del ciclo(loop). iteration siempre comienza en 1 incrementado en uno ca- da interación. first first Toma el valor true si la interación actual del foreach es la primera. last last Toma el valor de true si la interación actual del foreach es la ultima. show 43
Funciones Integradas show Es usado como parámetro para el foreach. show Es un valor booleano, true o false. Si es false, el foreach no será mos- trado. Si tuviera un foreachelse presente, este será alternativamente mostrado. total total Es usado para mostrar el número de interaciones del foreach. Este puede ser usado dentro o después de el. Ver tambien {section} y $smarty.foreach. include Nombre del Atributo Tipo requerido Default Descripción file string Si n/a El nombre del archivo de template a Incluir. assign string No n/a El nombre de una va- riable que contendra to- da la salida del templa- te. [var ...] [var type] No n/a Variable para pasar lo- calmente a el template Las etiquetas {include} son usadas para incluir otros templates en el template actual. Cualquier variable disponible en el template actual, también esta disponible dentro del template incluido. La etiqueta {include} debe tener el atributo "file", el cual contiene la ruta del archivo a incluir. Usted puede opcionalmente pasar el atributo 'assign', el cual especificara el nombre de una variable de template para el cual contendra toda la salida de {include} en vez de mostrarla. Ejemplo 7.7. funcion {include} <html> <head> <title>{$title}</title> </head> <body> {include file="page_header.tpl"} {* el cuerpo del template va aqui *} {include file="/$tpl_name.tpl"} <-- will replace $tpl_name with value {include file="page_footer.tpl"} </body> </html> Usted también puede pasar variables al template incluidas como atributos. Cualquier variable pasada al template incluidas como atributos estan disponibles solamente dentro el espacio del template. Las variables pasadas como atributos sobreescri- ben a las variables del template actual, en el caso en el que estas tengan el mismo nombre. Ejemplo 7.8. Función {include} pasando variables {include file="header.tpl" title="Main Menu" table_bgcolor="#c0c0c0"} 44
Funciones Integradas {* el cuerpo del template va aqui *} {include file="footer.tpl" logo="http://my.example.com/logo.gif"} Donde header.tpl puede ser <table border='1' width='100%' bgcolor='{$table_bgcolor|default:"#0000FF"}'> <tr><td> <h1>{$title}</h1> </td></tr> </table> Ejemplo 7.9. {include} y asignacion de variables En este ejemplo asignan el contenido de nav.tpl en la variable $navbar, entonces la salida hasta arriba y hasta abajo de pagi- na. <body> {include file="nav.tpl" assign="navbar"} {include file="header.tpl" title="Main Menu" table_bgcolor="#c0c0c0"} {$navbar} {* el cuerpo del template va aqui *} {include file="footer.tpl" logo="http://my.example.com/logo.gif"} {$navbar} </body> Use la sintaxis de template resources para incluir archivos fuera del directorio $template_dir. Ejemplo 7.10. Ejemplos de recursos para la función include {* ruta absoluta *} {include file="/usr/local/include/templates/header.tpl"} {* ruta absoluta (lo mismo) *} {include file="file:/usr/local/include/templates/header.tpl"} {* ruta absoluta de windows (DEBE usar el prefijo "file:") *} {include file="file:C:/www/pub/templates/header.tpl"} {* incluir a partir del recurso de template denominado "db" *} {include file="db:header.tpl"} ver también {include_php}, {php}, Template Resources y Componentized Templates. {include_php} Nombre del Atributo Tipo Requerido Default Descripción file string Si n/a El nombre del archivo php a incluir once boolean No true Cuando incluir o no el archivo php mas de una 45
Funciones Integradas Nombre del Atributo Tipo Requerido Default Descripción vez, ser incluido varias veces assign string No n/a El nombre de la varia- ble que recibirá la sali- da del archivo php Nota técnica: {include_php} es muy desaprovechado desde Smarty, usted puede lograr la misma funcionalidad por medio de las funciones de costumbre del template. La unica razón para usar {include_php} es si usted en reali- dad tiene la necesidad de poner en cuarentena la funcion de php fuera del directorio de plugins y su codigo de la aplicación. Vea un ejemplo de templates componentizados para detalles. Las etiquetas {include_php} son usadas para incluir un script PHP dentro de su template. Si la seguridad estuviera activada, entonces el script PHP debe estar localizado en la ruta $trusted_dir. La etiqueta include_php debe tener el atributo "file", el cual contiene la ruta del archivo PHP a ser incluido, o el relativo al $trusted_dir, o una ruta absoluta. Por default, los archivos son incluidos solo una vez a un cuando son incluidos varias veces en el template. Usted puede es- pecificar que este sea incluido todas la veces con un atributo once. Definindo como false incluira el script php cada vez que este sea incluido en el template. Usted puede opcionalmente pasar el atributo assign, el cual especificara una variable del template la cual contendra toda la salida del {include_php} en vez de mostrarla. El objeto smarty esta disponible como $this dentro del script php que usted incluyo. Ejemplo 7.11. funcion {include_php} load_nav.php <?php // carga variables de una base de datos mysql y defíne esta para el template require_once("MySQL.class.php"); $sql = new MySQL; $sql->query("select * from site_nav_sections order by name",SQL_ALL); $this->assign('sections',$sql->record); ?> Donde index.tpl es: {* ruta absoluta o relativa del $trusted_dir *} {include_php file="/path/to/load_nav.php"} {foreach item="curr_section" from=$sections} <a href="{$curr_section.url}">{$curr_section.name}</a><br /> {/foreach} Ver también {include}, {php}, {capture}, Template Resources y Componentized Templates insert Nombre del Atributo Tipo Requerido Default Descripción name string Si n/a El nombre de la fun- ción in- 46
Funciones Integradas Nombre del Atributo Tipo Requerido Default Descripción sert(insert_name) assign string No n/a El nombre de la varia- ble del template que re- cibirá la salida script string No n/a El nombre de un php que será incluido antes que la función insert sea llamada [var ...] [var type] No n/a Variable para pasar a la función insert La etiqueta funciona parecido a las etiquetas {include}, excepto que las etiquetas insert no van para el cache cuando caching esta activado. Esta sera executada a cada invocación del template. Digamos que usted tiene un template con un banner en la parte de arriba de la pagina. El banner puede contener cualquier mezcla de HTML, imagenes, flash, etc. Así nosotros no podemos usar una liga(link) estatica aquí, y nosotros no queremos que este el contenido oculto con la pagina. Aquí vemos la etiqueta {insert}: el template conoce los valores #banner_location_id# y #site_id# (obtenidos de un archivo de configuración), y necesita llamar una función para obtener el contenido del banner. Ejemplo 7.12. función {insert} {* ejemplo de traer un banner *} {insert name="getBanner" lid=#banner_location_id# sid=#site_id#} En este ejemplo, nosotros estamos usando el nombre "getBanner" y pasando los parámetros #banner_location_id# y #site_id#. El Smarty lo buscara en la función llamada insert_getBanner() en su aplicación PHP, pasando los valores de #banner_location_id# y #site_id# como primer argumento en una matriz asociativa. Todos los nombres de las funciones in- sert en su aplicación deben ser precedidas por "insert_" para prevenir posibles problemas con nombres de funciones repeti- dos. Su función insert_getBanner() debe hacer algo con los valores pasados y retornar los resultados. Estos resultados son mostrados en el template en lugar de la etiqueta insert. En este ejemplo, el Smarty llamara esta función: in- sert_getBanner(array("lid" => "12345","sid" => "67890")); y mostrara el resultado retornado en el lugar de la etiqueta in- sert. Si usted proporciona el atributo "assign", la salida de la etiqueta {insert} será dada a esta variable en vez de ser una salida en el template. Nota: definir la salida a una variable no es util cuando el cache esta habilitado. Si usted proporciona el atributo "script", este script php será incluido (solo una vez) antes de la ejecución de la función {insert}. Este es el caso donde la función insert no exista todavia, y el script php debe ser incluido antes para que pueda fun- cionar. La ruta puede ser absuluta o relativa a $trusted_dir. Cuando la seguridad esta activada, el script debe estar en $trusted_dir. El objeto Smarty es pasado como segundo argumento. De este modo puede referenciar y modificar información del objeto Smarty dentro de la función. Nota Tecnica: Es posible tener partes del template fuera de la cache. Si usted tuviera caching activado, la etiqueta insert no podra heredar por la cache. Esta sera ejecutada dinámicamente cada vez que la pagina sea creada, igual con paginas en cache. Esto funciona bien para cosas como banners, encuestas, clima, busqueda de resultados, areas de opinión de usuario, etc. if,elseif,else 47
Funciones Integradas Los comandos {if} del Smarty tiene mucho de la flexibilidad del comando if [http://php.net/if] de php, con algunas adiciones para la herramienta de template. Todo {if} debe tener su {/if}. {else} y {elseif} también son permitidos. Toda las condiciona- les de PHP son reconcidas, tal como ||, or, &&, and, etc. La siguiente es una lista de calificadores reconocidos, los cuales deberan estar separados los dos elementos por espacios. Nota loas articulos pueden listarse [entre corchetes] es opcional. Equivalentes al lugar donde se apliquen en PHP. Calificador Alternativa Ejemplo de Sintaxis Significado == eq $a eq $b Iguales != ne, neq $a neq $b Diferentes > gt $a gt $b Mayor que < lt $a lt $b menor que >= gte, ge $a ge $b mayor que o igual <= lte, le $a le $b menor que o igual === $a === 0 Igual e indentico ! not not $a negación (unary) % mod $a mod $b modulo is [not] div by $a is not div by 4 divisible por is [not] even $a is not even [not] es numero par (unary) is [not] even by $a is not even by $b agrupar niveles pares [not] is [not] odd $a is not odd [not] el numero es impar (unary) is [not] odd by $a is not odd by $b [not] agrupa los niveles impa- res Ejemplo 7.13. sentencia if {if $name eq "Fred"} Welcome Sir. {elseif $name eq "Wilma"} Welcome Ma'am. {else} Welcome, whatever you are. {/if} {* Un ejemplo con "or" logico *} {if $name eq "Fred" or $name eq "Wilma"} ... {/if} {* El mismo que arriba *} {if $name == "Fred" || $name == "Wilma"} ... {/if} {* La siguiente sintaxis no funcionara, el calificador de condición deben estar separados entre ellos por espacios *} {if $name=="Fred" || $name=="Wilma"} ... {/if} {* los parentesis son permitidos *} {if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#} ... 48
Funciones Integradas {/if} {* Usted también puede colocar funciones de PHP *} {if count($var) gt 0} ... {/if} {* checa si el valor es par o impar *} {if $var is even} ... {/if} {if $var is odd} ... {/if} {if $var is not odd} ... {/if} {* checa si la variable var es divisible por 4 *} {if $var is div by 4} ... {/if} {* Checa si la variable var es igual, agrupandola por dos. i.e., 0=even, 1=even, 2=odd, 3=odd, 4=even, 5=even, etc. *} {if $var is even by 2} ... {/if} {* 0=even, 1=even, 2=even, 3=odd, 4=odd, 5=odd, etc. *} {if $var is even by 3} ... {/if} {ldelim},{rdelim} {ldelim} y {rdelim} son usados para escapar delimitadores en el template, en nuestro caso "{" or "}". Usted puede usar solo {literal}{/literal} para escapar bloques de texto. Vea tambien {$smarty.ldelim}. Ejemplo 7.14. {ldelim}, {rdelim} {* Esto mostrara los delimitadores del template *} {ldelim}funcname{rdelim} is how functions look in Smarty! La salida del ejemplo de arriba: {funcname} is how functions look in Smarty! Otros ejemplos con algunos javascript <script language="JavaScript"> function foo() {ldelim} ... code ... {rdelim} </script> esta es la salida <script language="JavaScript"> 49
Funciones Integradas function foo() { .... code ... } </script> Vea también Escaping Smarty Parsing literal Las etiquetas literal permiten que un block de datos sea tomado literalmente, no siendo interpretado por el smarty. Esto es generalmente utilizado alrededor de bloques javascript o stylesheet, en donde pueden haber sintaxis delimitadoras que pue- dan interferir con el template. Cualquer cosa dentro de las etiquetas {literal}{/literal} no es interpretado, si no desplegado tal como esta. Si usted necesita en su template etiquetas incrustadas en su bloque de literal, considere usar {ldelim}{rdelim} para escapar delimitadores individuales en lugar de eso. Ejemplo 7.15. Etiqueta literal {literal} <script type="text/javascript"> <!-- function isblank(field) { if (field.value == '') { return false; } else { document.loginform.submit(); return true; } } // --> </script> {/literal} Ver también Escaping Smarty Parsing. {php} Las etiquetas {php} permiten a suetdd incrustar código php directamente en el template. No será escapado, no importando la definición de $php_handling. Esto es solo para usuario avanzados y normalmente no es necesario. Ejemplo 7.16. Etiqueta {php} {php} // incluyendo un script php // directamente en el template. include("/path/to/display_weather.php"); {/php} Nota técnica: Para poder tener acceso a las variables de PHP puede ser necesario usar la palabra clave global [http://php.net/global] de PHP. 50
Funciones Integradas ver También $php_handling, {include_php}, {include} y Componentized Templates. section,sectionelse Nombre del Atributo Tipo Requerido Default Descripción name string Si n/a El nombre de la section loop mixed Si n/a El nombre de la varia- ble para determinar el número de iteracciones start integer No 0 La posición del índice de la section donde va a comenzar. Si el valor es negativo, la posición del inicio se calculara a partir del final de la matriz. Por ejemplo, si hubieran 7 valores en la matriz y comienza por - 2, el índice inicial es 5. Valores inválidos (valores fuera del tama- ño de la matriz) son au- tomáticamente trunca- dos para el valor valido mas próximo. step integer No 1 El valor del step que sera usado para el loop de la matriz. Por ejem- plo, step=2 realizara el loop con los índices 0,2,4, etc. Si step es ne- gativo, este avanzara en la matriz de atras para adelante. max integer No n/a Defíne el número má- ximo de ciclos(loops) para la section. show boolean No true Determina cuando mostrar o no esta sec- ción Las section del template son usada para realizar un ciclo(loop) de un arreglo de datos. (al agiual que un {foreach}). Todas las etiquetas section deben tener su par /section. Los parámetros requeridos son name y loop. El nombre de la section puede ser el que usted quiera, formado por letras, números y subrayados. Las sections pueden ser anidadas, y los nombres de la section anidadas deben ser diferentes unos de otros. Las variables del loop (normalmente una matriz de valores) determina el número de veces del loop de la section. Cuando estuviera mostrando una variable dentro de una section, el nombre de la section debe estar al lado de la variable dentro de corchetes []. sectionelse es ejecutado cuando no hubiera valores para la variable del loop(ciclo). Ejemplo 7.17. section <?php 51
Funciones Integradas $data = array(1000,1001,1002); $smarty->assign('custid',$data); ?> {* this example will print out all the values of the $custid array *} {section name=customer loop=$custid} id: {$custid[customer]}<br /> {/section} <hr /> {* print out all the values of the $custid array reversed *} {section name=foo loop=$custid step=-1} {$custid[foo]}<br /> {/section} The above example will output: id: 1000<br /> id: 1001<br /> id: 1002<br /> <hr /> id: 1002<br /> id: 1001<br /> id: 1000<br /> Otro par de ejemplos sin un arreglo asignado. {section name=foo start=10 loop=20 step=2} {$smarty.section.foo.index} {/section} <hr /> {section name=bar loop=21 max=6 step=-2} {$smarty.section.bar.index} {/section} Esta es la salida del ejemplo de arriba: 10 12 14 16 18 <hr /> 20 18 16 14 12 10 Ejemplo 7.18. loop(ciclo) de la variable section <?php $id = array(1001,1002,1003); $smarty->assign('custid',$id); $fullnames = array('John Smith','Jack Jones','Jane Munson'); $smarty->assign('name',$fullnames); $addr = array('253 N 45th', '417 Mulberry ln', '5605 apple st'); $smarty->assign('address',$addr); ?> {* la variable del loop solo determina el número de veces del ciclo. Usted puede accesar a cualquier variable del template dentro de la section. Este ejemplo asume que $custid, $name y $address son todas matrizes 52
Funciones Integradas conteniendo el mismo número de valores *} {section name=customer loop=$custid} id: {$custid[customer]}&lt;br&gt; name: {$name[customer]}&lt;br&gt; address: {$address[customer]}&lt;br&gt; &lt;p&gt; {/section} La salida del ajemplo de arriba: <p> id: 1000<br /> name: John Smith<br /> address: 253 N 45th </p> <p> id: 1001<br /> name: Jack Jones<br /> address: 417 Mulberry ln </p> <p> id: 1002<br /> name: Jane Munson<br /> address: 5605 apple st </p> Ejemplo 7.19. Nombres de section {* El nombre de la section puede ser el que usted quiera, y es usado para referenciar los datos dentro de una section *} {section name=anything loop=$custid} <p> id: {$custid[anything]}<br /> name: {$name[anything]}<br /> address: {$address[anything]} </p> {/section} Ejemplo 7.20. sections anidadas <?php $id = array(1001,1002,1003); $smarty->assign('custid',$id); $fullnames = array('John Smith','Jack Jones','Jane Munson'); $smarty->assign('name',$fullnames); $addr = array('253 N 45th', '417 Mulberry ln', '5605 apple st'); $smarty->assign('address',$addr); $types = array( array( 'home phone', 'cell phone', 'e-mail'), array( 'home phone', 'web'), array( 'cell phone') ); $smarty->assign('contact_type', $types); $info = array( 53
Funciones Integradas array('555-555-5555', '666-555-5555', 'john@myexample.com'), array( '123-456-4', 'www.example.com'), array( '0457878') ); $smarty->assign('contact_info', $info); ?> {* Las sections pueden ser anidados tan profundamente como usted quiera. Con las sections anidadas, usted puede accesar a estructuras complejas, como una matriz multi-dimensional. En este ejemplo, $contact_type[customer] es una matriz de tipos de contacto para el cliente actual. *} {section name=customer loop=$custid} <hr> id: {$custid[customer]}<br /> name: {$name[customer]}<br /> address: {$address[customer]}<br /> {section name=contact loop=$contact_type[customer]} {$contact_type[customer][contact]}: {$contact_info[customer][contact]}<br /> {/section} {/section} la salida del ejemplo de arriba: <hr> id: 1000<br /> name: John Smith<br /> address: 253 N 45th<br /> home phone: 555-555-5555<br /> cell phone: 666-555-5555<br /> e-mail: john@myexample.com<br /> <hr> id: 1001<br /> name: Jack Jones<br /> address: 417 Mulberry ln<br /> home phone: 123-456-4<br /> web: www.example.com<br /> <hr> id: 1002<br /> name: Jane Munson<br /> address: 5605 apple st<br /> cell phone: 0457878<br /> Ejemplo 7.21. sections y matrices asociativas <?php $data = array( array('name' => 'John Smith', 'home' => '555-555-5555', 'cell' => '666-555-5555', 'email' => 'john@myexample.com'), array('name' => 'Jack Jones', 'home' => '777-555-5555', 'cell' => '888-555-5555', 'email' => 'jack@myexample.com'), array('name' => 'Jane Munson', 'home' => '000-555-5555', 'cell' => '123456', 'email' => 'jane@myexample.com') ); $smarty->assign('contacts',$data); ?> {* Este es un ejemplo que muestra los datos de una matriz asociativa dentro de una section *} 54
Funciones Integradas {section name=customer loop=$contacts} <p> name: {$contacts[customer].name}<br /> home: {$contacts[customer].home}<br /> cell: {$contacts[customer].cell}<br /> e-mail: {$contacts[customer].email} </p> {/section} Esta es la salida del ejemplo de arriba: <p> name: John Smith<br /> home: 555-555-5555<br /> cell: 666-555-5555<br /> e-mail: john@myexample.com </p> <p> name: Jack Jones<br /> home phone: 777-555-5555<br /> cell phone: 888-555-5555<br /> e-mail: jack@myexample.com </p> <p> name: Jane Munson<br /> home phone: 000-555-5555<br /> cell phone: 123456<br /> e-mail: jane@myexample.com </p> Ejemplo usando una base de datos(eg usando Pear o Adodb) <?php $sql = 'select id, name, home, cell, email from contacts'; $smarty->assign('contacts',$db->getAll($sql) ); ?> {* salida de la base de datos, resultado en una tabla *} <table> <tr><th>&nbsp;</th><th>Name></th><th>Home</th><th>Cell</th><th>Email</th></tr> {section name=co loop=$contacts} <tr> <td><a href="view.php?id={$contacts[co].id}">view<a></td> <td>{$contacts[co].name}</td> <td>{$contacts[co].home}</td> <td>{$contacts[co].cell}</td> <td>{$contacts[co].email}</td> <tr> {/section} </table> Ejemplo 7.22. {sectionelse} {* sectionelse se ejecutara si no hubieran valores en $custid *} {section name=customer loop=$custid} id: {$custid[customer]}<br /> {sectionelse} there are no values in $custid. {/section} 55
Funciones Integradas Las sections también tiene sus propias variables que manipulan las propiedades de section. Estas son indicadas asi: {$smarty.section.sectionname.varname} nota: NOTA: a partir de Smarty 1.5.0, la sintaxis de las variables de las propiedades de section ha sido cambiadas de {%sectionname.varname%} a {$smarty.section.sectionname.varname}. La sintaxis antigua es aun soportada, pero usted puede ver la referencia de la sintaxis nueva en los ejemplos del manual. index index es usado para mostrar el índice actual del cliclo(loop), comenzando en cero (o comienza con el atributo dado), e incre- mentando por uno (o por un atributo de paso dado). Nota Tecnica: Si las propiedades de paso y comienzo del section son modificadas, entonces estas funcionan igual a las propiedades de iteration de la section, exepto que comienzan en 0 en vez de 1. Ejemplo 7.23. {section} propiedades del index {* FYI, $custid[customer.index] y $custid[customer] are identical in meaning *} {section name=customer loop=$custid} {$smarty.section.customer.index} id: {$custid[customer]}<br /> {/section} salida del ejemplo de arriba: 0 id: 1000<br /> 1 id: 1001<br /> 2 id: 1002<br /> index_prev El index_prev es usado para mostrar el índice anterior del loop(ciclo). del primer loop(ciclo) esto es definido como -1. index_next El index_next es usado para mostrar el próximo indice del loop. del último loop, esto es uno mas que el índice actual( respe- tando la definición del atributo step que se a dado.) Ejemplo 7.24. {section} propiedades del index_next y index_prev <?php $data = array(1001,1002,1003,1004,1005); $smarty->assign('custid',$data); ?> {* FYI, $custid[cus.index] and $custid[cus] are identical in meaning *} <table> <tr> <th>index</th><th>id</th> <th>index_prev</th><th>prev_id</th> <th>index_next</th><th>next_id</th> 56
Funciones Integradas </tr> {section name=cus loop=$custid} <tr> <td>{$smarty.section.cus.index}</td><td>{$custid[cus]}</td> <td>{$smarty.section.cus.index_prev}</td><td>{$custid[cus.index_prev]}</td> <td>{$smarty.section.cus.index_next}</td><td>{$custid[cus.index_next]}</td> </tr> {/section} </table> la salida del ejemplo de arriba esta contenido en la siguiente tabla: index id index_prev prev_id index_next next_id 0 1001 -1 1 1002 1 1002 0 1001 2 1003 2 1003 1 1002 3 1004 3 1004 2 1003 4 1005 4 1005 3 1004 5 iteration iteration es usado para mostrar la iteración actual del loop(ciclo). nota: Esto no es afectado por las propiedades del section start, step y max, distinto de las propriedades del index. Iteration también comineza con 1 en vez de 0 como index. rownum es un alias de iteration, estas funcionan de ma- nera identica. Ejemplo 7.25. {section} propiedades de iteration <?php // array of 3000 to 3015 $id = range(3000,3015); $smarty->assign('custid',$id); ?> {section name=cu loop=$custid start=5 step=2} iteration={$smarty.section.cu.iteration} index={$smarty.section.cu.index} id={$custid[cu]}<br /> {/section} salida del ejemplo de arriba: iteration=1 index=5 id=3005<br /> iteration=2 index=7 id=3007<br /> iteration=3 index=9 id=3009<br /> iteration=4 index=11 id=3011<br /> iteration=5 index=13 id=3013<br /> iteration=6 index=15 id=3015<br /> Este ejemplo utiliza la propiedad iteration para salida a una tabla bloqueando el encabezado para cada 5 renglones (utilice {if} con el operador mod). <table> {section name=co loop=$contacts} {if $smarty.section.co.iteration % 5 == 1} <tr><th>&nbsp;</th><th>Name></th><th>Home</th><th>Cell</th><th>Email</th></tr> 57
Funciones Integradas {/if} <tr> <td><a href="view.php?id={$contacts[co].id}">view<a></td> <td>{$contacts[co].name}</td> <td>{$contacts[co].home}</td> <td>{$contacts[co].cell}</td> <td>{$contacts[co].email}</td> <tr> {/section} </table> first first es definido como true se la iteración actual de la section es la primera. last last es definido como true si la iteración actual del section es la ultima. Ejemplo 7.26. {section} propiedades first y last En este ciclo de ejemplo el arreglo $customer, en la salida es bloqueado el encabezado en la primera iteracion y en la ultima la salida es bloqueda para el pie de pagina. (Utilice la propiedad section total) {section name=customer loop=$customers} {if $smarty.section.customer.first} <table> <tr><th>id</th><th>customer</th></tr> {/if} <tr> <td>{$customers[customer].id}}</td> <td>{$customers[customer].name}</td> </tr> {if $smarty.section.customer.last} <tr><td></td><td>{$smarty.section.customer.total} customers</td></tr> </table> {/if} {/section} rownum rownum es usado para mostrar la interación actual del loop(ciclo), comenzando con 1. Es un alias para iteration, estas fun- cionan de modo identico. loop loop es usado para mostrar el ultimo número del índice del loop(ciclo) de esta section. Esto puede ser usado dentro o fuera del section. Ejemplo 7.27. {section} propiedades de index {section name=customer loop=$custid} 58
Funciones Integradas {$smarty.section.customer.index} id: {$custid[customer]}<br /> {/section} There were {$smarty.section.customer.loop} customers shown above. La salida del ejemplo de arriba: 0 id: 1000<br /> 1 id: 1001<br /> 2 id: 1002<br /> There were 3 customers shown above. show showEs usado como parámetro para section. show Es un valor booleano, true o false. Si es false, la section no será mostrada. Si existiera un sectionelse presente, este será alternativamente mostrado. Ejemplo 7.28. section atributos de show {* $show_customer_info debe ser pasado de la aplicacion PHP, para regular cuando mostrar o no esta section shows *} {section name=customer loop=$custid show=$show_customer_info} {$smarty.section.customer.rownum} id: {$custid[customer]}<br /> {/section} {if $smarty.section.customer.show} the section was shown. {else} the section was not shown. {/if} La salida del ejemplo de arriba: 1 id: 1000<br /> 2 id: 1001<br /> 3 id: 1002<br /> the section was shown. total total es usado para mostrar el número de iteraciones que está section tendra. Este puede ser usado dentro o fuera del section. Ejemplo 7.29. {section} propiedades de total {section name=customer loop=$custid step=2} {$smarty.section.customer.index} id: {$custid[customer]}<br /> {/section} There were {$smarty.section.customer.total} customers shown above. 59
Funciones Integradas The above example will output: 0 id: 1000<br /> 2 id: 1002<br /> 4 id: 1004<br /> There were 3 customers shown above. Ver también {foreach} y $smarty.section. {strip} Muchas veces el diseñador de web tiene problemas con los espacios en blanco y retornos de carro que afectan la salida del HTML (browser "features"), si usted tiene que colocar todas sus etiquetas juntas para tener los resultados deseados. Esto normalmente termina en un template ilegible o que no se puede leer. A cualquier cosa dentro de las etiquetas{strip}{/strip} en Smarty le son retirados los espacios en blanco y retornos de carro al inicio y al final de las lineas antes que sean mostrados. De este modo usted puede manter su template legible, y no se peo- cupara de que los espacios en blanco extras le causen problemas. Nota Técnica: {strip}{/strip} no afeta el contenido de las variables del template. Vea la función strip modifier. Ejemplo 7.30. {strip} tags {* El siguiente código se ejecutara todo junto en una sola linea de salida *} {strip} <table border='0'> <tr> <td> <A HREF="{$url}"> <font color="red">This is a test</font> </A> </td> </tr> </table> {/strip} salida del ejemplo de arriba: <table border=0><tr><td><A HREF="http://w... snipped...</td></tr></table> Note que en el ejemplo de arriba, todas las lineas comienzan y termina con etiquetas HTML. Tenga cuidado en que todas las lineas corran conjuntamente. Si usted tuviera textos planos simples en el inicio o en el final de una linea, este estaria junto, y puede no ser el resultado deseado. Vea También strip modifier 60
Capítulo 8. Custom Functions Tabla de contenidos {assign} ............................................................................................................................................ 61 {counter} .......................................................................................................................................... 62 cycle ................................................................................................................................................. 63 {debug} ............................................................................................................................................ 64 {eval} ............................................................................................................................................... 64 {fetch} .............................................................................................................................................. 65 {html_checkboxes} ............................................................................................................................. 66 {html_image} ..................................................................................................................................... 68 {html_options} ................................................................................................................................... 68 {html_radios} ..................................................................................................................................... 70 {html_select_date} .............................................................................................................................. 72 {html_select_time} .............................................................................................................................. 75 {html_table} ...................................................................................................................................... 79 math ................................................................................................................................................. 81 {mailto} ............................................................................................................................................ 82 {popup_init} ...................................................................................................................................... 84 popup ............................................................................................................................................... 84 {textformat} ....................................................................................................................................... 88 Smarty viene con varias funciones personalizadas que usted puede usar en sus templates. {assign} Nombre del Atributo Tipo Requerido Default Descripción var string Si n/a El nombre de la varia- ble que esta ganando el valor value string Si n/a El valor que esta siendo dado {assign} es usado para definir valores a las variables de template durante la ejecución del template. Ejemplo 8.1. {assign} {assign var="name" value="Bob"} The value of $name is {$name}. Salida del ejemplo de arriba: The value of $name is Bob. 61
Custom Functions Ejemplo 8.2. Accesando variables desde un script de PHP. {assign} Puedes accesar {assign} variables desde php usando get_template_vars(). sin embargo, las variables solo estan disponibles despues/durante la ejecución del template como en el siguiente ejemplo {* index.tpl *} {assign var="foo" value="Smarty"} <?php // this will output nothing as the template has not been executed echo $smarty->get_template_vars('foo'); // fetch the template to a dead variable $dead = $smarty->fetch('index.tpl'); // this will output 'smarty' as the template has been executed echo $smarty->get_template_vars('foo'); $smarty->assign('foo','Even smarter'); // this will output 'Even smarter' echo $smarty->get_template_vars('foo'); ?> La siguiente función optionally también puede asignar variables al template. {capture}, {include}, {include_php}, {insert}, {counter}, {cycle}, {eval}, {fetch}, {math}, {textformat} Ver también assign() y get_template_vars(). {counter} Nombre del Atributo Tipo Requerido Default Descripción name string No default El nombre del contador start number No 1 El número inicial para contar a partir de skip number No 1 El intervalo para contar direction string No up La dirección para con- tar (up/down) print boolean No true Cuando mostrar o no el valor assign string No n/a La variable del templa- te que va a recibir la sa- lida {counter} es usada para mostrar un conteo. {counter} va a depender del conteo en cada iteración. Usted puede ajustar el nú- mero, el intervalo y la dirección del conteo, asi como determinar cuando mostrar o no el conteo. Usted puede tener varios contadores al mismo tiempo, dando un nombre único para cada uno. Si usted no da un nombre, sera usado 'default' como nombre. Si usted indica el atributo especial "assign", la salida de la función counter se ira para esa variable del template en vez de ser 62
Custom Functions mostrada en el template. Ejemplo 8.3. counter {* Inicia el conteo *} {counter start=0 skip=2}<br /> {counter}<br /> {counter}<br /> {counter}<br /> Esta es la salida: 0<br /> 2<br /> 4<br /> 6<br /> cycle Nombre del Atributo Tipo Requerido Default Descripción name string No default El nombre del ciclo values mixed Si N/A Los valores del ciclo, o una lista delimitada por coma (vea el atributo delimiter), o una matriz de valores. print boolean No true Cuando mostrar o no el valor advance boolean No true Cuando avanzar o no hacia el siguiente valor delimiter string No , El delimitador para usar el valor del atribu- to. assign string No n/a La variable del templa- te que recibirá la salida reset boolean No false Este coloca al ciclo en el primer valor y no le permite avanzar {Cycle} es usado para hacer un ciclo a través de un conjunto de valores. Esto hace mas fácil alternar entre dos o mas colores en una tabla, o ciclos a travéz de una matriz de valores. Usted puede usar el {cycle} en mas de un conjunto de valores en su template supliendo el atributo name. De cada uno de los conjuntos de valores. Usted puede forzar que el valor actual no sea mostrado definiendo el atributo print en false. Esto es útil para saltarse un va- lor. El atributo advance es usado para repetir un valor. cuando se definido en false, la próxima llamada para cycle mostrara el mismo valor. 63
Custom Functions Si usted indica el atributo especial "assign", la saida de la función cycle ira a la variable del template en vez de ser mostrado ditectamente en el template. Ejemplo 8.4. cycle {section name=rows loop=$data} <tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"> <td>{$data[rows]}</td> </tr> {/section} <tr bgcolor="#eeeeee"> <td>1</td> </tr> <tr bgcolor="#d0d0d0"> <td>2</td> </tr> <tr bgcolor="#eeeeee"> <td>3</td> </tr> {debug} Nombre del Atributo Tipo Requerido Default Descripción output string No javascript Tipo de salida, html o javascript {debug} Muestra el debug de la consola en la pagina. Esto funciona independente de la definición de debug. Ya que este es ejecutado en tiempo de ejecución, este solo puede mostrar las variables definidas, no en el template, es decir en uso. Usted puede ver todas las variables disponibles del template con scope. Ver también Debugging console {eval} Nombre del Atributo Tipo Requerido Default Descripción var mixed Si n/a variable (o cadena) pa- ra evaluar assign string No n/a La variable del templa- te que recibirá la salida {eval} es usado para evaluar una variable como de template. Esto puede ser usado para cosas como incrustar tags(etiquetas)/variables del template dentro de las variables o tags(etiquetas)/variables dentro de las variables de un archivo de configuración. Si usted indica el atributo especial "assign", la salida de la función eval se ira para esta variable de template en vez de apare- cer en el template. Nota Técnica: Al evaluar las variables son tratas igual que el template. Ellas sigen el mismo funcionamiento para escape y seguridad tal como si ellas fueran templates. 64
Custom Functions Nota Técnica: Las variables evaluadas son compiladas en cada invocación, las vesiones compiladas no son salvas. Sin embargo, si usted tiene activado el cache, la salida se va a fijar en la cache junto con el resto del template. Ejemplo 8.5. {eval} setup.conf ---------- emphstart = <strong> emphend = </strong> title = Welcome to {$company}'s home page! ErrorCity = You must supply a {#emphstart#}city{#emphend#}. ErrorState = You must supply a {#emphstart#}state{#emphend#}. Where index.tpl is: {config_load file="setup.conf"} {eval var=$foo} {eval var=#title#} {eval var=#ErrorCity#} {eval var=#ErrorState# assign="state_error"} {$state_error} La salida del ejemplo de arriba: This is the contents of foo. Welcome to Foobar Pub & Grill's home page! You must supply a <strong>city</strong>. You must supply a <strong>state</strong>. {fetch} Nombre del Atributo Tipo Requerido Default Descripción file string Si n/a El archivo, sitio http o ftp para mandar llamar assign string No n/a La variable del templa- te que va a recibir la sa- lida {fetch} es usado para obtener archivos de sistema local, http o ftp, y mostrar el contenido. Si el nombre del archivo comien- za con "http://", la página del web site sera traida y mostrada. Si el nombre del archivo comienza con "ftp://", el archivo será obtenido del servidor ftp y mostrado. Para archivos locales, debe ser dada la ruta completa del sistema de archivos, o una ru- ta relativa de el script php a ejecutar. Si usted indica el atributo especial "assign", la salida de la función {fetch} se ira a una variable de template en vez de ser mostrada en el template. (nuevo en Smarty 1.5.0) Nota Técnica: Esto no soporta redirecionamento http, tenga la certeza de incluirlo en la barra el seguimiento para ir a buscar donde sea necesario. Nota Técnica: Si tiene activada la seguridad en su template y usted estuviera recibiendo un archivo del sistema de archivos local, esto permitira que solo archivos de uno de los directorios estuviera definido como seguro. ($secure_dir) 65
Custom Functions Ejemplo 8.6. fetch {* include some javascript in your template *} {fetch file="/export/httpd/www.example.com/docs/navbar.js"} {* embed some weather text in your template from another web site *} {fetch file="http://www.myweather.com/68502/"} {* fetch a news headline file via ftp *} {fetch file="ftp://user:password@ftp.example.com/path/to/currentheadlines.txt"} {* assign the fetched contents to a template variable *} {fetch file="http://www.myweather.com/68502/" assign="weather"} {if $weather ne ""} <b>{$weather}</b> {/if} Ver también {capture}, {eval} y fetch(). {html_checkboxes} Nombre del Atributo Tipo Requerido Default Descripción name string No checkbox Nombre de la lista checkbox values array Si, a menos que se este n/a Una matriz de valores utilizando el atributo para los botones check- options box output array Si, a menos que estu- n/a una matriz de salida pa- viera usando el atributo ra los botones check- options box selected string/array No empty El(s) elemento(s) checkbox marcado(s) options arreglo asociativo Si, a menos que este n/a Una matriz asociativa usando values y output de valores y salida separator string No empty Cadena de texto para separar cada checkbox labels boolean No true Adicionar la etiqueta <label> para la salida {html_checkboxes} es una función personalizada que crea un grupo de checkbox con datos privistos. Este cuida cuales items(s) estan selecionados por default. Los atributos requeridos son values y output, a menos que usted use options. Toda la salida es compatible con XHTML. Todos los parámetros que no esten en la lista de arriba son mostrados como nombre/valor dentro de cada etiqueta <input> creada. Ejemplo 8.7. {html_checkboxes} <?php $smarty->assign('cust_ids', array(1000,1001,1002,1003)); $smarty->assign('cust_names', array( 66
Custom Functions 'Joe Schmoe', 'Jack Smith', 'Jane Johnson', 'Charlie Brown') ); $smarty->assign('customer_id', 1001); ?> donde el template es {html_checkboxes name="id" values=$cust_ids output=$cust_names selected=$customer_id separator="<br />"} o donde el codigo es: <?php $smarty->assign('cust_checkboxes', array( 1000 => 'Joe Schmoe', 1001 => 'Jack Smith', 1002 => 'Jane Johnson', 1003 => 'Charlie Brown') ); $smarty->assign('customer_id', 1001); ?> y el template es {html_checkboxes name="id" options=$cust_checkboxes selected=$customer_id separator="<br />"} salida de ambos ejemplos: <label><input type="checkbox" name="id[]" value="1000" />Joe Schmoe</label><br /> <label><input type="checkbox" name="id[]" value="1001" checked="checked" />Jack Smith</label> <br /> <label><input type="checkbox" name="id[]" value="1002" />Jane Johnson</label><br /> <label><input type="checkbox" name="id[]" value="1003" />Charlie Brown</label><br /> Ejemplo 8.8. ejemplo de base de datos (eg PEAR o ADODB): <?php $sql = 'select type_id, types from types order by type'; $smarty->assign('types',$db->getAssoc($sql)); $sql = 'select * from contacts where contact_id=12'; $smarty->assign('contact',$db->getRow($sql)); ?> {html_checkboxes name="type" options=$types selected=$contact.type_id separator="<br />"} Vea también {html_radios} y {html_options} 67
Custom Functions {html_image} Nombre del Atributo Tipo Requerido Default Descripción file string Si n/a nombre/ruta de la ima- gen height string No Altura actual de la altura con la cual la imagen imagen debe ser mos- trada width string No Largo actual de la ima- largo con el cual la gen imagen debe ser mos- trada basedir string no document root del ser- ruta relativa para la ba- vidor web se del directorio alt string no "" descripción alternativa de la imagen href string no n/a valor href a donde la imagen será ligada {html_image} es una función habitual que genera una etiqueta HTML para una imagen. La altura y lo largo son automática- mente calculadas a partir del archivo de la imagen si ningún valor suplido. basedir es el directorio base en el cual las rutas relativas de las imagenes estan basados. Si no lo proporciona, el document root del servidor (env variable de ambiente DOCUMENT_ROOT) es usada como el directorio base. Si la $security esta ha- bilitada, la ruta para la imagen debe estar dentro de un directorio seguro. href es el valor href a donde la imagen sera ligada. Si un link es proporcionado, una etiqueta <a href="LINKVALUE"><a> es puesta alrededor de la imagen. Todos los parametros que no esten dentro de la lista de arriba son mostrados como pares de nombre/valor dentro de la eti- queta creada <img>. Nota Técnica: {html_image} requiere un acceso a disco para leer la imagen y calcular la altura y el largo. Si usted no usa cache en el template, generalmente es mejor evitar {html_image} y utilizar las etiquetas de imagen estáticas para un optimo funcionamiento. Ejemplo 8.9. html_image example where index.tpl is: ------------------- {html_image file="pumpkin.jpg"} {html_image file="/path/from/docroot/pumpkin.jpg"} {html_image file="../path/relative/to/currdir/pumpkin.jpg"} la posible saldida puede ser: <img src="pumpkin.jpg" alt="" width="44" height="68" /> <img src="/path/from/docroot/pumpkin.jpg" alt="" width="44" height="68" /> <img src="../path/relative/to/currdir/pumpkin.jpg" alt="" width="44" height="68" /> {html_options} 68
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción values array Si, a menos que use el n/a una matriz de valores atributo options para el menu dropdown output array Si, a menos que use el n/a una matriz de salida pa- atributo options ra el menu dropdown selected string/array No empty los elemento(s) de la option selecionado(s) options arreglo asociativo Si, a menos que utilize n/a una matriz asociativa valores y salida de valores y salida name string No empty nombre del grupo se- leccionado {html_options} es una función customizada que crea un grupo html <select><option> con los datos proporcionados. Este se encarga de cuidar cuales datos han sido selecionado por default. Los atributos son valores y salidas, a menos que usted utili- ce options en lugar de eso. Si un valor es una matriz, este será tratado como un <optgroup> html, y mostrara los grupos. La recursión es soportada por <optgroup>. Todas las salidas son compatibles con XHTML. Si el atributo opcional name es dado, las etiquetas <select name="groupname"></select> encapsularan la lista de opciones. De otra manera solo es generada la lista de opciones. Todos los parámetros que no estan en la lista de arriba son exibidos como name/value-pairs dentro de las etiquetas <select>. Estas son ignoradas si la opcion name no es dada. Ejemplo 8.10. {html_options} Ejemplo 1: <?php $smarty->assign('cust_ids', array(1000,1001,1002,1003)); $smarty->assign('cust_names', array( 'Joe Schmoe', 'Jack Smith', 'Jane Johnson', 'Charlie Brown')); $smarty->assign('customer_id', 1001); ?> donde el template es: <select name=customer_id> {html_options values=$cust_ids output=$cust_names selected=$customer_id} </select> Ejemplo 2: <?php $smarty->assign('cust_options', array( 1000 => 'Joe Schmoe', 1001 => 'Jack Smith', 1002 => 'Jane Johnson', 1003 => 'Charlie Brown') 69
Custom Functions ); $smarty->assign('customer_id', 1001); ?> donde el template es: <select name=customer_id> {html_options options=$cust_options selected=$customer_id} </select> Salida de ambos ejemplos de arriba: <select name=customer_id> <option label="Joe Schmoe" value="1000">Joe Schmoe</option> <option label="Jack Smith" value="1001" selected="selected">Jack Smith</option> <option label="Jane Johnson" value="1002">Jane Johnson</option> <option label="Charlie Brown" value="1003">Charlie Brown</option> </select> Ejemplo 8.11. {html_options} - Ejemplo con base de datos (eg PEAR o ADODB): <?php $sql = 'select type_id, types from types order by type'; $smarty->assign('types',$db->getAssoc($sql)); $sql = 'select contact_id, name, email, type_id from contacts where contact_id='.$contact_id; $smarty->assign('contact',$db->getRow($sql)); ?> Donde el template es: <select name="type_id"> <option value='null'>-- none --</option> {html_options name="type" options=$types selected=$contact.type_id} </select> vea también {html_checkboxes} y {html_radios} {html_radios} Nombre del Atributo Tipo Requerido Default Descripción name string No radio Nombre de la lista del radio values array Si, a menos que utilice n/a una matriz de valores el atributo options para radio buttons output array Si, a menos que utilice n/a una matriz de salida pa- el atributo options ra radio buttons selected string No empty El elemento del radio selccionado options arreglo asociativo Si, a menos qie utilice n/a una matriz asociativa 70
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción valores y salida de valores y salida separator string No empty cadena de texto para separar cada objeto de radio {html_radios} es una función customizada que crea grupos de botones de radio html con los datos proporcionados. Este esta atento para saber cual objeto esta selccionado por default. Los atributos requeridos son valores y salidas, a menos que usted use option en lugar de eso. Toda salida es compatible con XHTML. Todos los parámetros que no estan en la lista de arriba son impresos como pares de name/value dentro de cada etiqueta <input> creada. Ejemplo 8.12. {html_radios} : Ejemplo 1 <?php $smarty->assign('cust_ids', array(1000,1001,1002,1003)); $smarty->assign('cust_names', array( 'Joe Schmoe', 'Jack Smith', 'Jane Johnson', 'Charlie Brown') ); $smarty->assign('customer_id', 1001); ?> Donde el template es: {html_radios name="id" values=$cust_ids output=$cust_names selected=$customer_id separator="<br />"} Ejemplo 8.13. {html_radios} : Ejemplo 2 <?php $smarty->assign('cust_radios', array( 1000 => 'Joe Schmoe', 1001 => 'Jack Smith', 1002 => 'Jane Johnson', 1003 => 'Charlie Brown')); $smarty->assign('customer_id', 1001); ?> Donde index.tpl es: {html_radios name="id" options=$cust_radios selected=$customer_id separator="<br />"} Salida de ambos ejemplos: <label for="id_1000"> <input type="radio" name="id" value="1000" id="id_1000" />Joe Schmoe</label><br /> <label for="id_1001"><input type="radio" name="id" value="1001" id="id_1001" 71
Custom Functions checked="checked" />Jack Smith</label><br /> <label for="id_1002"><input type="radio" name="id" value="1002" id="id_1002" />Jane Johnson</label><br /> <label for="id_1003"><input type="radio" name="id" value="1003" id="id_1003" />Charlie Brown</label><br /> Ejemplo 8.14. {html_radios}- Ejemplo con base de Datos (eg PEAR o ADODB): <?php $sql = 'select type_id, types from types order by type'; $smarty->assign('types',$db->getAssoc($sql)); $sql = 'select contact_id, name, email, type_id from contacts where contact_id='.$contact_id; $smarty->assign('contact',$db->getRow($sql)); ?> y el template: {html_radios name="type" options=$types selected=$contact.type_id separator="<br />"} ver también {html_checkboxes} y {html_options} {html_select_date} Nombre del Atributo Tipo Requerido Default Descripción prefix string No Date_ Con el prefijo el nom- bre de la variable time timestamp/ No Tiempo actual en el ti- Cual date/time a usar YYYY-MM-DD mestamp de unix o el formato YYYY- MM-DD start_year string No Año actual El primer año primero en el menu dropdown, o el número de año, o el relativo al año actual (+/- N) end_year string No de la misma forma que El ultimo año en el me- start_year nu dropdown, o el nú- mero de año, o el relati- vo al año actual (+/- N) display_days boolean No true Muestra los dias o no display_months boolean No true Muestra los meses o no display_years boolean No true Muestra los años o no month_format string No %B Cual debe ser el forma- to de salida del mes dentro de (strftime) day_format string No %02d Cual debe ser el forma- 72
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción to de salida del dia den- tro de (sprintf) day_value_format string No %d Cual debe ser el forma- to de salida del valor del dia dentro de (sprintf) year_as_text boolean No false Se mostrara o no el año como texto reverse_years boolean No false Muestra los años en or- den inverso field_array string No null si un nombre es dado, las cajas de seleción se- ran exibidas semejantes a los resultados que es- taran retornando al PHP en la forma. na- me[Day], name[Year], name[Month]. day_size string No null adiciona el tamaño al atributo para la etiqueta select si fue dada month_size string No null adiciona el tamaño del atributo para la etiqueta select si fue dada year_size string No null adiciona el tamaño del atributo para la etiqueta select si fue dada all_extra string No null adiciona atributos ex- tras para todas las eti- quetas select/input si fueron dadas day_extra string No null adiciona atributos ex- tras para todas las eti- quetas select/input si fueron dadas month_extra string No null adiciona atributos ex- tras para todas las eti- quetas select/input si fueron dadas year_extra string No null adiciona atributos ex- tras para todas las eti- quetas select/input si fueron dadas field_order string No MDY El orden para ser mos- trados los campos field_separator string No n Cadena a mostrar entre los diferentes campos month_value_format string No %m formato strftime de los valores del mes, el de- fault es %m para el nú- mero del mes. 73
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción year_empty string No null Si es proporcionado en- tonces el primer ele- mento es el año select- box tiene este valor co- mo etiqueta y "" como valor. Esto es util para hacer una lectura en el select-box por ejemplo "por favor seccione el año". Note que este puede usar valores co- mo "-MM-DD" como atributos de time indi- cando que el año sea desmarcado. month_empty string No null Si es proporcinado en- tonces el mes es el pri- mer elemento select- box tiene este valor co- mo etiqueta y "" como valor. Note que usted puede usar valores co- mo "YYYY--DD" co- mo atributos de time indicando que el mes sea desmarcado. day_empty string No null Si es proporcinado en- tonces es dias es el pri- mer elemento select- box tiene este valor co- mo etiqueta y "" como valor. Note que usted puede usar valores co- mo "YYYY-MM--" co- mo atributos de time indicando que el dia sea desmarcado. {html_select_date} es una función customizada que crea menus dropdowns de fechas para usted. Este puede mostrar algu- nos o todos por año, mes y dia. Ejemplo 8.15. {html_select_date} Codigo del Template {html_select_date} Esta es la salida: <select name="Date_Month"> <option value="1">January</option> <option value="2">February</option> <option value="3">March</option> ..... snipped ..... 74
Custom Functions <option value="10">October</option> <option value="11">November</option> <option value="12" selected="selected">December</option> </select> <select name="Date_Day"> <option value="1">01</option> <option value="2">02</option> <option value="3">03</option> ..... snipped ..... <option value="11">11</option> <option value="12">12</option> <option value="13" selected="selected">13</option> <option value="14">14</option> <option value="15">15</option> ..... snipped ..... <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> </select> <select name="Date_Year"> <option value="2001" selected="selected">2001</option> </select> Ejemplo 8.16. {html_select_date} {* el año seleccionado puede ser relativo al año actual *} {html_select_date prefix="StartDate" time=$time start_year="-5" end_year="+1" display_days=false} esta es la salida: (el año actual es 2000) <select name="StartDateMonth"> <option value="1">January</option> <option value="2">February</option> <option value="3">March</option> <option value="4">April</option> <option value="5">May</option> <option value="6">June</option> <option value="7">July</option> <option value="8">August</option> <option value="9">September</option> <option value="10">October</option> <option value="11">November</option> <option value="12" selected="selected">December</option> </select> <select name="StartDateYear"> <option value="1995">1995</option> <option value="1996">1996</option> <option value="1997">1997</option> <option value="1998">1998</option> <option value="1999">1999</option> <option value="2000" selected="selected">2000</option> <option value="2001">2001</option> </select> Ver también {html_select_time}, date_format, $smarty.now y date tips. {html_select_time} 75
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción prefix string No Time_ con el prefijo el nom- bre de la variable time timestamp No current time cual date/time va a usar display_hours boolean No true Mostrar o no las horas display_minutes boolean No true Mostrar o no los minu- tos display_seconds boolean No true Mostrar o no los segun- dos display_meridian boolean No true Mostrar o no el meri- diano (am/pm) use_24_hours boolean No true Usar o no reloj de 24 horas minute_interval integer No 1 número de los interva- los de los minutos del menu dropdown second_interval integer No 1 número de los interva- los de los segundos del menu dropdown field_array string No n/a muestra los valores del arreglo con este nom- bre all_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados hour_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados minute_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados second_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados meridian_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados {html_select_time} es una función customizada que crea menus dropdowns de tiempo para usted. Esta puede mostrar algu- nos valores, o todo en hora, minuto, segundo y am/pm. Los atributos de time pueden tener diferentes formatos. Este puede ser un unico timestamp o una cadena conteniendo YYYYMMDDHHMMSS o una cadena parseda por php's strtotime() [http://php.net/strtotime]. 76
Custom Functions Ejemplo 8.17. {html_select_time} template code: -------------- {html_select_time use_24_hours=true} Esta es la salida: <select name="Time_Hour"> <option value="00">00</option> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09" selected>09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20">20</option> <option value="21">21</option> <option value="22">22</option> <option value="23">23</option> </select> <select name="Time_Minute"> <option value="00">00</option> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09">09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20" selected>20</option> <option value="21">21</option> <option value="22">22</option> <option value="23">23</option> <option value="24">24</option> <option value="25">25</option> <option value="26">26</option> <option value="27">27</option> <option value="28">28</option> <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> 77
Custom Functions <option value="32">32</option> <option value="33">33</option> <option value="34">34</option> <option value="35">35</option> <option value="36">36</option> <option value="37">37</option> <option value="38">38</option> <option value="39">39</option> <option value="40">40</option> <option value="41">41</option> <option value="42">42</option> <option value="43">43</option> <option value="44">44</option> <option value="45">45</option> <option value="46">46</option> <option value="47">47</option> <option value="48">48</option> <option value="49">49</option> <option value="50">50</option> <option value="51">51</option> <option value="52">52</option> <option value="53">53</option> <option value="54">54</option> <option value="55">55</option> <option value="56">56</option> <option value="57">57</option> <option value="58">58</option> <option value="59">59</option> </select> <select name="Time_Second"> <option value="00">00</option> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09">09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20">20</option> <option value="21">21</option> <option value="22">22</option> <option value="23" selected>23</option> <option value="24">24</option> <option value="25">25</option> <option value="26">26</option> <option value="27">27</option> <option value="28">28</option> <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> <option value="32">32</option> <option value="33">33</option> <option value="34">34</option> <option value="35">35</option> <option value="36">36</option> <option value="37">37</option> <option value="38">38</option> <option value="39">39</option> <option value="40">40</option> 78
Custom Functions <option value="41">41</option> <option value="42">42</option> <option value="43">43</option> <option value="44">44</option> <option value="45">45</option> <option value="46">46</option> <option value="47">47</option> <option value="48">48</option> <option value="49">49</option> <option value="50">50</option> <option value="51">51</option> <option value="52">52</option> <option value="53">53</option> <option value="54">54</option> <option value="55">55</option> <option value="56">56</option> <option value="57">57</option> <option value="58">58</option> <option value="59">59</option> </select> <select name="Time_Meridian"> <option value="am" selected>AM</option> <option value="pm">PM</option> </select> Ver también $smarty.now, {html_select_date} y date tips. {html_table} Nombre del Atributo Tipo Requerido Default Descripción loop array Si n/a matriz de datos para el ciclo(loop) cols integer No 3 Número de columnas para la tabla. Si el atri- buto cols esta vacio, los renglones seran deter- minados, entonces el numero de columnas sera calculado por el numero de renglones y el numero de elementos a mostrar para ser ajus- tado a las columnas de todos los elementos que seran mostrados, si ambos, renglones y co- lumnas, son omitidos las columnas por de- fault son 3. rows integer No empty Número de renglones en la tabla. Si el atribu- to rows es vacio, las columnas seran deter- minadas, entonces el numero de renglones sera calculado por el numero de columnas y el numero de elementos 79
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción a mostrar para ser ajus- tado el numero de ren- glones al total de ele- mentos a ser mostra- dos. inner string No cols Dirección consecutiva de los elementos en el arreglo para ser repre- sentados. cols manera en que los elementos son mostrados columna por columna. rows ma- nera en que los elemen- tos son mostrados ren- glon por renglon. table_attr string No border="1" atributos para la etique- ta table tr_attr string No empty atributos para la etique- ta tr (arreglos del ciclo) td_attr string No empty atributos para la etique- ta td (arreglos del ciclo) trailpad string No &nbsp; valor de relleno de las celdas para el ultimo renglon con (si hay al- guno) hdir string No right dirección de una linea para ser representada. posibles valores: left (left-to-right), right (right-to-left) vdir string No down Dirección de las co- lumnas para ser repre- sentadas. posibles valo- res: down (top-to-bottom), up (bottom-to-top) {html_table} Es una función customizada que transforma un arreglo de datos en una tabla HTML. El atributo cols determi- na el número de columnas que tendra la tabla. Los valores table_attr, tr_attr y td_attr determinan los atributos dados para las etiquetas tabla, tr y td. Si tr_attr o td_attr son arreglos, ellos entraran en un ciclo. trailpad y el valor depositado dentro de trailing cells en la ultima linea de la tabla si existe alguna presente. Ejemplo 8.18. html_table php code: --------- <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('data',array(1,2,3,4,5,6,7,8,9)); $smarty->assign('tr',array('bgcolor="#eeeeee"','bgcolor="#dddddd"')); $smarty->display('index.tpl'); ?> 80
Custom Functions template code: -------------- {html_table loop=$data} {html_table loop=$data cols=4 table_attr='border="0"'} {html_table loop=$data cols=4 tr_attr=$tr} La salida de ambos ejemplos: <table border="1"> <tr><td>1</td><td>2</td><td>3</td></tr> <tr><td>4</td><td>5</td><td>6</td></tr> <tr><td>7</td><td>8</td><td>9</td></tr> </table> <table border="0"> <tr><td>1</td><td>2</td><td>3</td><td>4</td></tr> <tr><td>5</td><td>6</td><td>7</td><td>8</td></tr> <tr><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr> </table> <table border="1"> <tr bgcolor="#eeeeee"><td>1</td><td>2</td><td>3</td><td>4</td></tr> <tr bgcolor="#dddddd"><td>5</td><td>6</td><td>7</td><td>8</td></tr> <tr bgcolor="#eeeeee"><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr> </table> math Nombre del Atributo Tipo Requerido Default Descripción equation string Si n/a La ecuación a ejecutar format string No n/a El formato del resulta- do (sprintf) var numeric Si n/a Valor de la variable de la ecuación assign string No n/a Variable de template cuya salida sera asigna- da [var ...] numeric Si n/a Valor de la variable de la ecuación {math} permite diseñar ecuaciones matemáticas dentro del template. Cualquier variable numérica del template puede ser usada en ecuaciones, y el resultado es mostrado en lugar de la etiqueta. Las variables usadas en ecuaciones son pasadas co- mo parámetros, que pueden ser variables de template o valores estáticos. +, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, srans y tan son todos los operadores validos. Verifique la documentación de PHP para mas información acerca de estas funciones matemáticas. Si usted proporciona el atributo especial "assign", la salida de la función matemática será atribuido a esta variable de tem- plate en vez de ser mostrada en el template. Nota Técnica: {math} es una función de muy alto rendimiento debido a que se puede usar con la función eval() [http://php.net/eval] de PHP. Hacer las matemáticas en PHP es mucho mas eficiente, asi en cualquier momento es posible hacer calculos matemáticos en PHP asignarlos a una variable y lanzar los resultados al template. Defíniti- vamente evite llamadas repetitivas de funciones matemáticas, dentro de los ciclos {section}. Ejemplo 8.19. {math} 81
Custom Functions Ejemplo a: {* $height=4, $width=5 *} {math equation="x + y" x=$height y=$width} Salida del ejemplo de arriba: 9 Ejemplo b: {* $row_height = 10, $row_width = 20, #col_div# = 2, assigned in template *} {math equation="height * width / division" height=$row_height width=$row_width division=#col_div#} Salida del ejemplo de arriba: 100 Ejemplo c: {* you can use parenthesis *} {math equation="(( x + y ) / z )" x=2 y=10 z=2} Salida del ejemplo de arriba: 6 Ejemplo d: {* you can supply a format parameter in sprintf format *} {math equation="x + y" x=4.4444 y=5.0000 format="%.2f"} Salida del ejemplo de arriba: 9.44 {mailto} Nombre del Atributo Tipo Requerido Default Descripción address string Yes n/a La dirección de correo electronico(e-mail) text string No n/a El texto para mostrar, el default es la direc- ción de correo (e-mail) encode string No none Como codificar el e- mail. Puede ser none, hex, javascript o 82
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción javas- cript_charcode. cc string No n/a La dirección de co- rreo(e-mail) para man- dar una copia el car- bon(cc). Separados por una coma. bcc string No n/a Dirección de correo electronico(e-mail) pa- ra mandar una copia al carbon ofuscada(bcc). Separando las direccio- nes por comas. subject string No n/a Asunto del correo elec- tronico(e-mail). newsgroups string No n/a newsgroup para enviar. separando las direccio- nes por comas. followupto string No n/a Direcciones para acom- pañar. Separe las direc- ciones con comas. extra string No n/a Cualquier otra informa- ción que usted quiera pasar por el link, tal co- mo plantillas de estilo {mailto} automatiza el proceso de creación de links de correo electronico(e-mail) y opcionalmente los codifica. Codificar el correo electronico(e-mail) hace mas difícil que las web spiders tomen las direciones de nuestro sitio. Nota Técnica: javascript es probablemente el codificador mas utilizado, aunque usted puede utilizar también codi- ficación hexadecimal. Ejemplo 8.20. {mailto} {mailto address="me@example.com"} <a href="mailto:me@example.com" >me@example.com</a> {mailto address="me@example.com" text="send me some mail"} <a href="mailto:me@example.com" >send me some mail</a> {mailto address="me@example.com" encode="javascript"} <script type="text/javascript" language="javascript"> eval(unescape('%64%6f% ... snipped ...%61%3e%27%29%3b')) </script> {mailto address="me@example.com" encode="hex"} <a href="mailto:%6d%65.. snipped..3%6f%6d">&#x6d;&..snipped...#x6f;&#x6d;</a> {mailto address="me@example.com" subject="Hello to you!"} <a href="mailto:me@example.com?subject=Hello%20to%20you%21" >me@example.com</a> {mailto address="me@example.com" cc="you@example.com,they@example.com"} <a href="mailto:me@example.com?cc=you@example.com%2Cthey@example.com" >me@example.com</a> {mailto address="me@example.com" extra='class="email"'} <a href="mailto:me@example.com" class="email">me@example.com</a> 83
Custom Functions {mailto address="me@example.com" encode="javascript_charcode"} <script type="text/javascript" language="javascript"> <!-- {document.write(String.fromCharCode(60,97, ... snipped ....60,47,97,62))} //--> </script> ver también escape, Obfuscating E-mail Addresses y {textformat} {popup_init} {popup} es una integración de overLib [http://www.bosrup.com/web/overlib/], una biblioteca usada para ventanas popup. Esta es usada como contexto de infomación sensitiva, como ventanas de ayuda o herramientas. {popup_init} debe ser usada una vez hasta arriba de cada pagina donde usted planea usar la función popup. overLib [http://www.bosrup.com/web/over- lib/] fue escrita por Erik Bosrup, y la pagina esta localizada en http://www.bosrup.com/web/overlib/. A partir da versión 2.1.2 de Smarty, overLib NO viene con la distribución. Descargar el overLib, coloque el archivo over- lib.js dentro de su document root e indique la ruta relativa en el parámetro "src" de {popup_init}. Ejemplo 8.21. popup_init <head> {* popup_init debe ser llamado una sola vez hasta arriba de la pagina *} {popup_init src="/javascripts/overlib.js"} </head> popup Nombre del Atributo Tipo Requerido Default Descripción text string Si n/a El text/html para mos- trar en la ventana po- pup trigger string No onMouseOver El que va a ser usado para que aparezca la ventana. Puede ser on- MouseOver u onClick sticky boolean No false Hace que el poppup se quede cerca hasta que se cierre caption string No n/a Defíne el texto para el título fgcolor string No n/a El color que va a ser usado dentro de la caja popup bgcolor string No n/a El color del borde de la caja popup textcolor string No n/a Defíne el color del tex- to dentro de la caja po- pup 84
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción capcolor string No n/a Defíne el color del títu- lo de la caja closecolor string No n/a Defíne el color del tex- to para cerrar textfont string No n/a Defíne el color del tex- to para ser usado en el texto principal captionfont string No n/a Defíne el tipo de letra para ser usado en el Tí- tulo closefont string No n/a Defíne el tipo de letra para el texto "Close" textsize string No n/a Defíne el tipo de letra del texto principal captionsize string No n/a Defíne el tamaño del ti- po de letra del título closesize string No n/a Defíne el tamaño del ti- po de letra del texto "Close" width integer No n/a Defíne el ancho de la caja height integer No n/a Defíne la altura de la caja left boolean No false Hace que el popups va- ya para la izquierda del ratón right boolean No false Hace que el popups va- ya para la derecha del ratón center boolean No false Hace que el popups va- ya al centro del ratón above boolean No false Hace que el popups va- ya por encima del rató. NOTA:solamente es posible si el height fue definido below boolean No false Hace que el popups va- ya por abajo del ratón border integer No n/a Torna en gruesos o fi- nos los bordes del po- pups offsetx integer No n/a A que distancia del ra- tón aparecera el popup, horizontalmente offsety integer No n/a A que distancia del ra- tón aparecera el popup, verticalmente fgbackground url to image No n/a Defíne una imagen pa- ra usar en vez del color del popup. 85
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción bgbackground url to image No n/a defíne una imagen para ser usada como borde en vez de un color para el popup. NOTA:Usted debe definir bgcolor como "" o el color apa- recera también. NOTA: Cuando tuviera un link "Close", el Netscape rediseñara las celdas de la tabla, haciendo que las cosas aparezcan in- correctamente closetext string No n/a Defíne el texto "Close" a otra cosa noclose boolean No n/a No muestra el texto "Close" pegado con el título status string No n/a Defíne el texto en la barra de estado del na- vegador autostatus boolean No n/a Defíne el texto en la barra de estado para el texto del popup. NO- TA: sobreescribe la de- finición del status. autostatuscap string No n/a Defíne el texto de la barra de estado como el texto del título NOTA: sobreescribe el status y autostatus inarray integer No n/a Indica al overLib desde que índice de la matriz ol_text debe leer el tex- to, localizada en over- lib.js. Este parámetro puede ser usado en vez del texto caparray integer No n/a Indica al overLib a par- tir de que índice de la matriz ol_caps leer el título capicon url No n/a Muestra la imagen an- tes del título snapx integer No n/a Instantanea el popup a una posición constante en una cuadricula hori- zontal snapy integer No n/a Instantanea el popup a una posición constante en una cuadricula verti- cal fixx integer No n/a Cierra el popups en una 86
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción posición horizontal No- ta: pasa por encima de otros colocados hori- zontal fixy integer No n/a Cierra popups en posi- ción vertical Note: pasa por encima de otros co- locados vertical background url No n/a Defíne una imagen pa- ra ser usada como fon- do en vez de la tabla padx integer,integer No n/a Rellena el fondo de la imagen con espacios en blanco horizontal para colocar el texto. Nota: este es un comando de dos parámetros pady integer,integer No n/a Rellena el fondo de la imagen con espacios en blanco vertical para co- locar el texto. Nota: es- te es un comando de dos parámetros fullhtml boolean No n/a Permite a usted contro- lar completamente el html sobre la figura de fondo. El código HTML es esperado en el atributo "text" frame string No n/a Controla popups en fra- mes diferentes. Para mayores informes so- bre esta función vea la pagina de overlib timeout string No n/a LLama especificamen- te a una función javas- cript y toma el valor que retorna, como el texto que se va a mos- trar en la ventana po- pup delay integer No n/a Hace que el popup fun- cione como un tooltip. Este aparecera solo con un retraso en milesimas de segundo hauto boolean No n/a Determina automática- mente si el popup debe aparecer a la izquierda o a la derecha del ratón. vauto boolean No n/a Determina automática- mente si el popup debe aparecer abajo o arriba 87
Custom Functions Nombre del Atributo Tipo Requerido Default Descripción del ratón. {popup} es usado para crear ventanas popup con javascript. {popup_init} DEBE ser llamado primero para poder trabajar. Ejemplo 8.22. popup {* popup_init debe ser llamado una vez hasta arriba de la pagina *} {popup_init src="/javascripts/overlib.js"} {* crea un link con una ventana popup que aparece cuando se pasa el mouse sobre este *} <a href="mypage.html" {popup text="This link takes you to my page!"}>mypage</a> {* usted puede usar html, links, etc en el texto del popup *} <a href="mypage.html" {popup sticky=true caption="mypage contents" text="<ul><li>links</li><li>pages</li><li>images</li></ul>" snapx=10 snapy=10}>mypage</a> Ver también {popup_init} y overLib [http://www.bosrup.com/web/overlib/]. {textformat} Nombre del Atributo Tipo Requerido Default Descripción style string No n/a estilo pre-definido indent number No 0 Número de caracteres para endentar cada li- nea. indent_first number No 0 Número de caracteres para endentar la prime- ra linea indent_char string No (single space) El carácter (o cadena de caracteres) para en- dentar wrap number No 80 Cuantos caracteres ten- dra cada linea wrap_char string No n Caracter (o cadena de caracteres) a usar para saltar cada linea wrap_cut boolean No false Si es true, wrap saltara la linea en el carácter exacto en vez de saltar al final de la palabra. assign string No n/a La variable del templa- te que recibirá la salida {textformat} es una función de bloque usada para formatear texto. Básicamente limpa espacios y caracteres especiales, y formatea los párrafos cortando el texto al final de la palabra y endentando lineas. Usted puede definir los parámetros explícitamente, o usar un estilo pre-definido. Actualmente el único estilo disponible es "email". 88
Custom Functions Ejemplo 8.23. {textformat} {textformat wrap=40} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} Salida del ajemplo de arriba: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {textformat wrap=40 indent=4} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} Salida del ejemplo de arriba: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo 89
Custom Functions foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {textformat wrap=40 indent=4 indent_first=4} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} Salida del ejemplo de arriba: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {textformat style="email"} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} Salida del ejemplo de arriba: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. 90
Custom Functions This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. Ver también {strip} y {wordwrap}. 91
Capítulo 9. Config Files Los archivos de configuración son utiles para diseñar y administrar variables globales para los templates a partir de un ar- chivo. Un ejemplo son los colores del template. Normalmente si usted quiere cambiar el esquema de colores de una aplica- ción, usted debe ir a cada uno de los archivos del template y cambiar los colores. Con un archivo de configuración, los colo- res pueden estar mantenidos en un lugar y solo necesita actualizar este para cambiar los colores. Ejemplo 9.1. Ejemplo de sintaxis de un archivo de configuración # global variables pageTitle = "Main Menu" bodyBgColor = #000000 tableBgColor = #000000 rowBgColor = #00ff00 [Customer] pageTitle = "Customer Info" [Login] pageTitle = "Login" focus = "username" Intro = """This is a value that spans more than one line. you must enclose it in triple quotes.""" # hidden section [.Database] host=my.domain.com db=ADDRESSBOOK user=php-user pass=foobar Los valores de las variables pueden estar entre comillas, mas no es necesario. Usted puede usar comillas simples o dobles. Si usted tuviera un valor que ocupe mas de una linea, coloque todo el valor entre tres comillas ("""). Usted puede colocar comentarios en un archivo de configuración con cualquier sintaxis que no sea valida en un archivo de configuración. Noso- tros recomendamos usar un # en el princio de cada linea. Este archivo de configuración tiene dos secciones. Los nombres de secciones debe estar entre corchetes []. Los nombres de sección pueden ser cadenas arbitrarias que no contengan los simbolos [ or ]. Las cuatro variables en la cabecera son varia- bles globales, o no son variables de sección. Estas variables son siempre cargadas del archivo de configuración. Si una sec- ción en particular fuera cargada, entonces las variables globales y las variables de esta sección son cargadas. Si una variable existe como global y dentro de una sección, la variable de sección será utilizada. Si usted tuviera dos variables en la misma sección con el mismo nombre, la ultima será utilizada. Los archivos de configuración son cargados en el template con una función incrustada {config_load}. (Ver También con- fig_load() ). Usted puede ocultar variables o secciones enteras colocando un punto antes del nombre de la variable. Esto es útil si su apli- cación lee los archivos de configuración y los datos sensibles a partir de ellos que la herramienta del template no lo necesita. Si usted tiene a otras personas realizando la edición de templates, usted tendra la certesa que ellos no leeran datos sensibles del archivo de configuración cargando estos en el template. Ver También {config_load}, $config_overwrite, get_config_vars(), clear_config() y config_load() 92
Capítulo 10. Debugging Console Incluso en Smarty existe una consola para debug. La consola informa a usted de todos los templates incluidos, las variables definidas y las variables de archivos de configuración de la llamada actual del template. Incluso un template llamado "de- bug.tpl" viene con la distribución de Smarty el cual controla el formateo de la consola. Defina $debugging en true en el Smarty, y si es necesario defina $debug_tpl para la ruta del recurso debug.tpl (Esto es SMARTY_DIR por default). Cuando usted carga una pagina, una consola en javascript abrira una ventana popup y dara a usted el nombre de todos los templates incluidos y las variables definidas en la pagina actual. Para ver las variables disponibles para un template en particular, vea la función {debug}. Para desabilitar la consola del debug, defina $debugging en false. Usted puede activar temporalmente la consola del debug colocando SMARTY_DEBUG en la URL si usted activo esta opción con $debugging_ctrl. Nota Técnica: La consola de debug no funciona cuando usted usa la API fetch(), solo cuando estuviera usando display(). Es un conjunto de comandos javascript adicionados al final del template generado. Si a usted no le gusta el javascript, usted puede editar el template debug.tpl para formatear la salida como usted quiera. Los datos del de- bug no son guardados en cache y los datos del debug.tpl no son incluidos en la consola debug. nota: Los tiempos de carga de cada template y de archivos de configuración son en segundos, o en fracciones de segundo. Vea también troubleshooting, $error_reporting y trigger_error(). 93
Parte III. Smarty For Programmers Tabla de contenidos 11. Constantes .................................................................................................................................... 96 SMARTY_DIR .................................................................................................................. 96 SMARTY_CORE_DIR ........................................................................................................ 96 12. Clase Variables de Smarty ............................................................................................................... 97 $template_dir ..................................................................................................................... 97 $compile_dir ...................................................................................................................... 97 $config_dir ........................................................................................................................ 98 $plugins_dir ....................................................................................................................... 98 $debugging ........................................................................................................................ 98 $debug_tpl ......................................................................................................................... 98 $debugging_ctrl .................................................................................................................. 99 $autoload_filters ................................................................................................................. 99 $compile_check .................................................................................................................. 99 $force_compile ................................................................................................................... 99 $caching ............................................................................................................................ 99 $cache_dir ........................................................................................................................ 100 $cache_lifetime ................................................................................................................. 100 $cache_handler_func .......................................................................................................... 100 $cache_modified_check ...................................................................................................... 100 $config_overwrite .............................................................................................................. 100 $config_booleanize ............................................................................................................ 101 $config_read_hidden .......................................................................................................... 101 $config_fix_newlines .......................................................................................................... 101 $default_template_handler_func ........................................................................................... 101 $php_handling ................................................................................................................... 101 $security .......................................................................................................................... 102 $secure_dir ....................................................................................................................... 102 $security_settings ............................................................................................................... 102 $trusted_dir ....................................................................................................................... 103 $left_delimiter ................................................................................................................... 103 $right_delimiter ................................................................................................................. 103 $compiler_class ................................................................................................................. 103 $request_vars_order ........................................................................................................... 103 $request_use_auto_globals ................................................................................................... 103 $error_reporting ................................................................................................................. 103 $compile_id ...................................................................................................................... 103 $use_sub_dirs .................................................................................................................... 104 $default_modifiers ............................................................................................................. 104 $default_resource_type ....................................................................................................... 104 13. La clase Methods() de Smarty ......................................................................................................... 105 14. Cache ......................................................................................................................................... 146 Configurando el Cache ........................................................................................................ 146 Multiples caches por pagina ................................................................................................. 148 Cache Groups .................................................................................................................... 149 Controlando salida de Cacheabilidad de plugins ....................................................................... 150 15. Caracteristicas Avanzadas ............................................................................................................... 152 Objetos ............................................................................................................................ 152 Prefilters .......................................................................................................................... 153 94
Smarty For Programmers Postfilters ......................................................................................................................... 153 Filtros de salida ................................................................................................................. 154 Función manipuladora de cache ............................................................................................ 154 Recursos .......................................................................................................................... 156 16. Extendiendo Smarty con plugins ...................................................................................................... 160 Como funcionan los Plugins ................................................................................................. 160 Nombres convencionales ..................................................................................................... 160 Escribiendo Plugins ............................................................................................................ 161 Funciones de Template ........................................................................................................ 161 Modificadores ................................................................................................................... 163 Block Functions ................................................................................................................. 164 Funciones Compiladoras ..................................................................................................... 165 Prefiltros/Postfiltros ............................................................................................................ 166 Filtros de Salida ................................................................................................................. 167 Fuentes ............................................................................................................................ 167 Inserts .............................................................................................................................. 169 95
Capítulo 11. Constantes Tabla de contenidos SMARTY_DIR .................................................................................................................................. 96 SMARTY_CORE_DIR ........................................................................................................................ 96 SMARTY_DIR Esta debe ser la ruta completa del path para la localización de los archivos de clases de Smarty. Si esta no fuera definida, Entonces Smarty intentara determinar el valor apropiado automáticamente. Si es definido, el path debe finalizar con una diagonal. Ejemplo 11.1. SMARTY_DIR <?php // set path to Smarty directory *nix style define('SMARTY_DIR','/usr/local/lib/php/Smarty/libs/'); // path to Smarty windows style define('SMARTY_DIR','c:/webroot/libs/Smarty/libs/'); // hack (not recommended) that works on both *nix and wind // Smarty is assumend to be in 'includes' dir under script define('SMARTY_DIR',str_replace("","/",getcwd()).'/includes/Smarty/libs/'); // include the smarty class Note 'S' is upper case require_once(SMARTY_DIR.'Smarty.class.php'); ?> Ver también $smarty.const y $php_handling constants SMARTY_CORE_DIR Esta debe ser la ruta completa de localización del sistema de archivos de Smarty core. Si no es definido, Smarty tomara por default esta constante de libs/ bajo el sub-directory SMARTY_DIR. Si es definida, la ruta debe terminar con una diagonal. Use esta constante cuando necesite incluir manualmente algun archivo de core.* Ejemplo 11.2. SMARTY_CORE_DIR <?php // load core.get_microtime.php require_once(SMARTY_CORE_DIR.'core.get_microtime.php'); ?> Ver también $smarty.const 96
Capítulo 12. Clase Variables de Smarty Tabla de contenidos $template_dir ..................................................................................................................................... 97 $compile_dir ...................................................................................................................................... 97 $config_dir ........................................................................................................................................ 98 $plugins_dir ....................................................................................................................................... 98 $debugging ........................................................................................................................................ 98 $debug_tpl ......................................................................................................................................... 98 $debugging_ctrl .................................................................................................................................. 99 $autoload_filters ................................................................................................................................. 99 $compile_check .................................................................................................................................. 99 $force_compile ................................................................................................................................... 99 $caching ............................................................................................................................................ 99 $cache_dir ........................................................................................................................................ 100 $cache_lifetime ................................................................................................................................. 100 $cache_handler_func .......................................................................................................................... 100 $cache_modified_check ...................................................................................................................... 100 $config_overwrite .............................................................................................................................. 100 $config_booleanize ............................................................................................................................ 101 $config_read_hidden .......................................................................................................................... 101 $config_fix_newlines .......................................................................................................................... 101 $default_template_handler_func ........................................................................................................... 101 $php_handling ................................................................................................................................... 101 $security .......................................................................................................................................... 102 $secure_dir ....................................................................................................................................... 102 $security_settings ............................................................................................................................... 102 $trusted_dir ....................................................................................................................................... 103 $left_delimiter ................................................................................................................................... 103 $right_delimiter ................................................................................................................................. 103 $compiler_class ................................................................................................................................. 103 $request_vars_order ........................................................................................................................... 103 $request_use_auto_globals ................................................................................................................... 103 $error_reporting ................................................................................................................................. 103 $compile_id ...................................................................................................................................... 103 $use_sub_dirs .................................................................................................................................... 104 $default_modifiers ............................................................................................................................. 104 $default_resource_type ....................................................................................................................... 104 $template_dir Este es el nombre por default del directorio del template. Si usted no proporciona un tipo de recurso que incluya archivos, entonces estos se encontraran aquí. Por default "./templates", esto significa que lo buscara en el directorio del templa- tes en el mismo directorio que esta ejecutando el script PHP. Nota Técnica: No es recomendado colocar este directorio bajo el directorio document root de su servidor web. $compile_dir Ese es el nombre del directorio donde los templates compilados están localizados, Por default están en "./templates_c" , 97
Clase Variables de Smarty esto significa que lo buscara en el directorio de templates en el mismo directorio que esta ejecutando el script php. Este di- rectorio debe tener permiso de escritura para el servidor web (ver la instalación). también $use_sub_dirs. Nota Técnica: Esa configuración debe ser un path relativo o un path absoluto. include_path no se usa para escribir archivos. Nota Técnica: No es recomendado colocar este directorio bajo el directorio document root de su servidor web. Ver también $compile_id y $use_sub_dirs. $config_dir Este es el directorio usado para almacenar archivos de configuración usados en los templates. El default es "./configs", esto significa que lo buscara en el directorio de templates en el mismo directorio que esta ejecutando el script php. Nota Técnica: No es recomendado colocar este directorio bajo el directorio document root de su servidor web. $plugins_dir Este es el directorio (o directorios) donde Smarty procurara ir a buscar los plugins que sean necesarios. El default es "plu- gins" bajo el SMARTY_DIR. Si usted proporciona un path relativo, Smarty procurara ir primero bajo el SMARTY_DIR, Entonces relativo para el cwd(current working directory), Entonces relativo para cada entrada de su PHP include path. Si $plugins_dir es un arreglo de directorios, Smarty buscara los plugins para cada directorio de plugins en el orden en el que fueron proporcionados. Nota Técnica: Para un mejor funcionamiento, no configure su plugins_dir para que use el include path PHP. Use un path absoluto, o un path relativo para SMARTY_DIR o el cwd (current working directory). Ejemplo 12.1. multiple $plugins_dir <?php $smarty->plugins_dir = array( 'plugins', // the default under SMARTY_DIR '/path/to/shared/plugins', '../../includes/my/plugins' ); ?> $debugging Este habilita el debugging console. La consola es una ventana de javascript que informa a usted sobre los archivos del tem- plate incluidos y las variables destinadas a la pagina del template actual. Ver también {debug}, $debug_tpl, y $debugging_ctrl $debug_tpl Este es el nombre del archivo de template usado para el debug de la consola. Por default, es nombrado debug.tpl y esta localizado en el SMARTY_DIR. Ver también $debugging y Debugging console 98
Clase Variables de Smarty $debugging_ctrl Esto permite rutas alternativas para habilitar el debug. NONE no significa que métodos alternativos son permitidos. URL significa cuando la palabra SMARTY_DEBUG fue encontrada en el QUERY_STRING, que el debug está habilitado para la llamada del script. Si $debugging es true, ese valor es ignorado. Ver también Debugging console. $autoload_filters Si existe algun filtro que usted desea cargar en cada llamada de template, usted puede especificar cual variable usar y el Smarty ira automáticamente a cargarlos para usted. La variable es un arreglo asociativo donde las llaves son tipos de filtro y los valores son arreglos de nombres de filtros. Por ejemplo: <?php $smarty->autoload_filters = array('pre' => array('trim', 'stamp'), 'output' => array('convert')); ?> Ver también register_outputfilter(), register_prefilter(), register_postfilter() y load_filter() $compile_check En cada llamada de la aplicación PHP, Smarty prueba para ver si el template actual fue modificado (diferentes time stamp) desde la ultima compilación. Si este fue modificado, se recompilara el template. Si el template no fue compilado, este ira a compilar de cualquier manera esa configuración. Por default esta variable es determinada como true. Una vez que la aplica- ción esta en producción (los templates no seran modificados), el paso compile_check no es necesario. asegurese de determi- nar $compile_check a "false" para un mejor funcionamiento. Note que si usted modifica está para "false" y el archivo de template está modificado, usted *no* vera los cambios desde el template hasta que no sea recompilado. Si el caching esta habilitado y compile_check está habilitado, entonces los archivos de cache tienen que ser regenerados si el archivo de tem- plate es muy complejo o el archivo de configuración fue actualizado. vea $force_compile o clear_compiled_tpl(). $force_compile Este forza al Smarty a (re)compilar templates en cada llamada. Esta configuración sobrescribe $compile_check. Por default este es desabilitado. Es útil para el desarrollo y debug. Nunca debe ser usado en ambiente de producción. Si el cache esta habilitado, los archivo(s) de cache seran regenerados todo el tiempo. $caching Este informa al Smarty si hay o no salida de cache para el template en el $cache_dir. Por default tiene asignado 0, o desabi- litado. Si su template genera contenido redundante, es necesario ligar el $caching. Esto tendra un benefico significativo en el rendimiento. Usted puede tener multiples caches para el mismo template. Un valor de 1 o 2 caching habilitados. 1 anuncia a Smarty para usar la variable actual $cache_lifetime hasta determinar si el cache expiro. Un valor 2 anuncia a Smarty para usar el valor $cache_lifetime al tiempo en que le cache fue generado. De esta manera usted puede determinar el $cache_lifetime inmediatamente antes de buscar el template para tener el control cuando este cache en particular expira. Vea también is_cached(). Si $compile_check está habilitado, el contenido del cache se regenerara si alguno de los dos templates o archivos de confi- guración que son parte de este cache estuviera modificado. Si $force_compile está habilitado, el contenido del cache siem- pre sera regenerado. Ver También $cache_dir, $cache_lifetime, $cache_handler_func, $cache_modified_check y Caching section. 99
Clase Variables de Smarty $cache_dir Este es el nombre del directorio donde los caches del template son almacenados. Por default es "./cache", esto significa que buscara el directorio de cache en el mismo directorio que ejecuta el scripts PHP. Este directorio debe ser regrabable por el servidor web (ver intalación). Usted puede usar también su propia función habitual de mantenimiento de cache para manipular los archivos de cache, que ignorará está configuración. Ver tambien $use_sub_dirs. Nota Técnica: Esta configuración debe ser cualquiera de estas dos, un path relativo o absoluto. include_path no es usado para escribir archivos. Nota Técnica: No es recomendado colocar este directorio bajo el directorio document root del servidor web. Ver también $caching, $use_sub_dirs, $cache_lifetime, $cache_handler_func, $cache_modified_check y Caching section. $cache_lifetime Este es la duración del tiempo en segundos que un cache de template es valido. Una vez que este tiempo está expirado, el cache sera regenerado. $caching debe ser asignado a "true" para $cache_lifetime hasta tener algún propósito. Un valor de -1 forza el cache a nunca expirar. Un valor de 0 forzara a que el cache sea siempre regenerado (bueno solo para probar, el mé- todo mas eficiente para desabilitar cache es asignar $caching = false.) Si $force_compile está habilitado, los archivos de cache serán regenerados todo el tiempo, efectivamente desabilitando ca- ching. Usted puede limpiar todos los archivos de cache con la función clear_all_cache(), o archivos individuales de cache (o grupos) con la función clear_cache(). Nota Técnica: Si usted quisiera dar a ciertos templates su propio tiempo de vida de cache, usted puede hacer esto asignando $caching = 2, entonces determina $cache_lifetime a un único valor justo antes de llamar display() o fetch(). $cache_handler_func Usted puede proporcionar una función por default para manipular archivos de cache en vez de usar el metodo incrustado usando el $cache_dir. Para mas detalles vea la sección cache handler function section. $cache_modified_check Si es asignado true, Smarty respetara el If-Modified-Since encabezado enviado para el cliente. Si el timestamp del archivo de cache no fue alterado desde la ultima visita, entonces un encabezado "304 Not Modified" sera enviado en vez del conte- nido. Esto funciona solamente en archivos de cache sin etiquetas {insert}. Ver también $caching, $cache_lifetime, $cache_handler_func, y Caching section. $config_overwrite Si es asignado true, las variables leidas en el archivo de configuración se sobreescribiran unas a otras. De lo contrario, las variables seran guardadas en un arreglo. Esto es útil si usted quiere almacenar arreglos de datos en archivos de configura- ción, solamente lista tiempos de cada elemento múltiplo. true por default. Ejemplo 12.2. Arreglo de variables de configuración Este ejemplo utiliza {cycle} para la salida a una tabla alternando colores por renglon rojo/verde/azul con $config_overwrite = false. 100
Clase Variables de Smarty El archivo de configuración. # row colors rowColors = #FF0000 rowColors = #00FF00 rowColors = #0000FF El template con ciclo {section}. <table> {section name=r loop=$rows} <tr bgcolor="{cycle values=#rowColors#}"> <td> ....etc.... </td> </tr> {/section} </table> Ver también {config_load}, config files, get_config_vars(), clear_config() y config_load(). $config_booleanize Si es asignado true, los valores del archivo de configuración de on/true/yes y off/false/no se convierten en valores booleanos automáticamente. De esta forma usted puede usar los valores en un template como: {if #foobar#} ... {/if}. Si foobar estuvie- ra on, true o yes, la condición {if} se ejecutara. true es el default. $config_read_hidden Si es asignado true, esconde secciones (nombres de secciones comenzando con un periodo) en el archivo de configuración pueden ser leidos del template. Tipicamente desearia esto como false, de esta forma usted puede almacenar datos sensibles en el archivo de configuración como un parámetro de base de datos y sin preocuparse que el template los carge. false es el default. $config_fix_newlines Si es asignado true, mac y dos newlines (r y rn) en el archivo de configuración seran convertidos a n cuando estos fueran interpretados. true es el defaut. $default_template_handler_func Esta función es llamada cuando un template no puede ser obtenido desde su recurso. $php_handling Este informa al Smarty como manipular códigos PHP contenidos en los templates. Hay cuatro posibles configuraciones, siendo el default SMARTY_PHP_PASSTHRU. Observe que esto NO afectara los códigos php dentro de las etiquetas {php}{/php} en el template. • SMARTY_PHP_PASSTHRU - Smarty echos tags as-is. • SMARTY_PHP_QUOTE - Smarty abre comillas a las etiquetas de entidades html. • SMARTY_PHP_REMOVE - Smarty borra las etiquetas del template. 101
Clase Variables de Smarty • SMARTY_PHP_ALLOW - Smarty ejecuta las etiquetas como código PHP. nota: Incrustar codigo PHP dentro del template es sumamente desalentador. Use custom functions o modifiers en vez de eso. $security $security true/false, el default es false. Security es bueno para situaciones cuando usted tiene partes inconfiables editando el template (via ftp por ejemplo) y usetd quiere reducir los riesgos de comportamiento de seguridad del sistema a través del lenguaje del template. Al habilitar la seguridad forza las siguientes reglas del lenguaje del template, a menos que especifique control con $security_settings: • Si $php_handling está asignado a SMARTY_PHP_ALLOW, este es implicitamente cambiado a SMARTY_PHP_PASSTHRU • Las funciones PHP no son permitidas en sentencias {if}, excepto quellas que esten especificadas en $security_settings • Los templates solo pueden ser incluidos en el directorio listado en arreglo $secure_dir • Los archivos locales solamente pueden ser traidos del directorio listado en $secure_dir usando el arreglo {fetch} • Estas etiquetas {php}{/php} no son permitidas • Las funciones PHP no son permitidas como modificadores, excepto si estan especificados en el $security_settings $secure_dir Este es un arreglo de todos los directorios locales que son considerados seguros. {include} y {fetch} usan estos (directorios) cuando security está habilitada. Ver también Security settings, y $trusted_dir. $security_settings Estas son usadas para cancelar o especificar configuraciones de seguridad cuando security esta habilitado. Estas son las po- sibles configuraciones. • PHP_HANDLING - true/false. la configuracion de $php_handling no es checada por security. • IF_FUNCS - Este es un arreglo de nombres de funciones PHP permitidas en los bloques IF. • INCLUDE_ANY - true/false. Si es asignado true, algun template puede ser incluido para un archivo de sistema, a pesar de toda la lista de $secure_dir. • PHP_TAGS - true/false. Si es asignado true, las etiquetas {php}{/php} son permitidas en los templates. • MODIFIER_FUNCS - Este es un arreglo de nombres de funciones PHP permitidas usadas como modificadores de va- riables. • ALLOW_CONSTANTS - true/false. Si es asignado true, la constante a travez de {$smarty.const.name} es autorizada en el template. El default es asignado "false" por seguridad. 102
Clase Variables de Smarty $trusted_dir $trusted_dir solamente es usado cuando $security está habilitado. Este es un arreglo de todos los directorios que son consi- derados confiables. Los directorios confiables son de donde usted extraera sus script PHP que son ejecutados directamente desde el template con {include_php}. $left_delimiter Este es el delimitador izquierdo usado por el lenguaje de template. El default es "{". Ver también $right_delimiter y escaping smarty parsing. $right_delimiter Este es el delimitador derecho usado por el lenguaje de template. El default es "}". ver también $left_delimiter y escaping smarty parsing. $compiler_class Especifica el nombre del compilador de clases que Smarty usara para compilar los templates. El default es 'Smarty_Compiler'. Solo para usuarios avanzados. $request_vars_order El orden en el cual las variables requeridas seran registradas, similar al variables_order en el php.ini Ver también $smarty.request y $request_use_auto_globals. $request_use_auto_globals Especifica si el Smarty debe usar variables globales del php $HTTP_*_VARS[] ($request_use_auto_globals=false valor por default) o $_*[] ($request_use_auto_globals=true). Esto afecta a los templates que hacen uso de {$smarty.request.*}, {$smarty.get.*} etc. . Atención: Si usted asigna $request_use_auto_globals a true, variable.request.vars.order no tendran efecto los valores de configuracion de php gpc_order sera usados. $error_reporting Cuando este valor es asignado a non-null-value este valor es usado como un nivel error_reporting [http:/ / php.net/ error_reporting] dentro de display() y fetch(). Cuando debugging es habilitado este valor es ignorado y el error-level no es tocado. Ver también trigger_error(), debugging y Troubleshooting. $compile_id Identificador de compilación persistente. Como una alternativa para pasar el mismo compile_id a cada llamada de función, usted puede asignar este compile_id y este será usado implicitamente después. Con el compile_id usted puede trabajar con limitacion porque usted no puede usar el mismo $compile_dir para diferentes $template_dirs. Si usted asigna distintos compile_id para cada template_dir entonces Smarty puede hacer la compilacion de los templates por cada compile_id. 103
Clase Variables de Smarty Si usted tiene por ejemplo un prefilter este localiza su template (es decir: traduce al lenguaje las dependencias por partes) y lo compila, entonces usted debe usar el lenguaje actual como $compile_id y usted obtendrá un conjunto de plantillas compi- ladas para cada idioma que usted utilice. otro ejemplo puede ser si usa el mismo directorio para compilar multiples dominios / multiples host virtuales. Ejemplo 12.3. $compile_id <?php $smarty->compile_id = $_SERVER['SERVER_NAME']; $smarty->compile_dir = 'path/to/shared_compile_dir'; ?> $use_sub_dirs Smarty puede crear subdirectorios bajo los directorios templates_c y cache si $use_sub_dirs es asignado true. En un ambien- te donde hay potencialmente decenas de miles de archivos creados, esto puede ayudar la velocidad de sistema de archivos. Por otro lado, algunos ambientes no permiten que procesos de PHP creen directorios, este debe ser desabilitado. El valor por defaulr es false (disabled). Los Sub directorios son mas eficientes, entonces aprovechelo si puede. Teóricamente usted obtiene mayor eficiencia en sun sistema de archivos con 10 directorios que contengan 100 archivos, que con un directorio que contenga 1000 archivos. Este era ciertamente un caso con Solaris 7 (UFS)... con un nuevo sistema de archivos como ext3 y un levantado especial, la diferencia es casi nula. Nota Técnica: $use_sub_dirs=true doesn't trabaja con safe_mode=On [http://php.net/features.safe-mode], esto es porque es switchable y porque puede estar en off por default. Nota Técnica: Desde Smarty-2.6.2 use_sub_dirs esta por default en false. Ver también $compile_dir, y $cache_dir. $default_modifiers Este es un arreglo de modificadores implicitamente aplicados para cada variable en el template. Por Ejemplo, cada variable HTML-escape por default, usa el arreglo('escape:"htmlall"'); Para hacer que las variables excenten los modificadores por de- fault, pase el modificador especial "smarty" con un valor de parámetro "nodefaults" modificando esto, tal como {$var|smarty:nodefaults}. $default_resource_type Este anuncia a Smarty el tipo de recurso a usar implicitamente. El valor por default es 'file', significa que $smarty->display('index.tpl'); y $smarty->display('file:index.tpl'); son identicos en el significado. Para mas detalles vea el capitulo resource. 104
Capítulo 13. La clase Methods() de Smarty Tabla de contenidos append() ........................................................................................................................................... 106 append_by_ref ................................................................................................................................... 107 assign() ............................................................................................................................................ 108 assign_by_ref .................................................................................................................................... 109 clear_all_assign() ............................................................................................................................... 110 clear_all_cache .................................................................................................................................. 111 clear_assign() .................................................................................................................................... 112 clear_cache() ..................................................................................................................................... 113 clear_compiled_tpl() ........................................................................................................................... 114 clear_config() .................................................................................................................................... 115 config_load() ..................................................................................................................................... 116 display() ........................................................................................................................................... 117 fetch() .............................................................................................................................................. 119 get_config_vars() ............................................................................................................................... 121 get_registered_object() ........................................................................................................................ 122 get_template_vars() ............................................................................................................................ 123 is_cached() ....................................................................................................................................... 124 load_filter() ....................................................................................................................................... 125 register_block() ................................................................................................................................. 126 register_compiler_function .................................................................................................................. 127 register_function() .............................................................................................................................. 128 register_modifier() ............................................................................................................................. 129 register_object() ................................................................................................................................. 130 register_outputfilter() .......................................................................................................................... 131 register_postfilter() ............................................................................................................................. 132 register_prefilter() .............................................................................................................................. 133 register_resource ................................................................................................................................ 134 trigger_error ...................................................................................................................................... 135 template_exists() ................................................................................................................................ 136 unregister_block ................................................................................................................................ 137 unregister_compiler_function() ............................................................................................................. 138 unregister_function() .......................................................................................................................... 139 unregister_modifier() .......................................................................................................................... 140 unregister_object() ............................................................................................................................. 141 unregister_outputfilter() ...................................................................................................................... 142 unregister_postfilter() ......................................................................................................................... 143 unregister_prefilter() ........................................................................................................................... 144 unregister_resource() .......................................................................................................................... 145 105
La clase Methods() de Smarty append() append()agregando elementos a una matriz asignada append() Descripción void append (mixed var) void append (string varname, mixed var [, bool merge]) Este es usado para adicionar un elemento en un arreglo asignado. Si usted adiciona una cadena como valor, este se converti- ra en un valor del arreglo y entonces lo adiciona. Usted puede explicitamente pasar pares de nombres/valores, o arreglos asociativos conteniendo los pares nombre/valor. Si usted pasa el tercer parámetro opcional como true, el valor se únira al arreglo actual en vez de ser adicionado. Nota Tecnica: El parametro merge es la llave respectiva del arreglo, asi si usted asocia dos arreglos indexados nu- mericamente, estos se sobre escriben uno al otro o tener como resultado llaves no-secuenciales. Este es diferente a la funcion array_merge() de PHP la cual limpia las llaves numericas y las vuelve a renumerar. Ejemplo 13.1. append <?php // passing name/value pairs $smarty->append("Name", "Fred"); $smarty->append("Address", $address); // passing an associative array $smarty->append(array('city' => 'Lincoln', 'state' => 'Nebraska')); ?> Ver también append_by_ref(), assign() y get_template_vars() 106
La clase Methods() de Smarty append_by_ref append_by_refpasando valores por referencia append_by_ref Descipción void append_by_ref (string varname, mixed var [, bool merge]) Este es usado para pasar valores al templete por referencia. Si usted pasa una variable por referencia entonces cambiara su valor, el valor asignado sufrira el cambio también. Para objetos, append_by_ref() también envia una copia en memoria del objeto adicionado. Vea el manual de PHP en referenciando variables para una mejor explicación del asunto. Si usted pasa el tercer parámetro en true, el valor será mezclado con el arreglo en ves de ser adicionado. Nota Tecnica: El parametro merge es la llave respectiva del arreglo, asi si usted asocia dos arreglos indexados nu- mericamente, estos se sobre escriben uno al otro o tener como resultado llaves no-secuenciales. Este es diferente a la funcion array_merge() de PHP la cual limpia las llaves numericas y las vuelve a renumerar. Ejemplo 13.2. append_by_ref <?php // appending name/value pairs $smarty->append_by_ref("Name", $myname); $smarty->append_by_ref("Address", $address); ?> Ver también append() y assign(). 107
La clase Methods() de Smarty assign() assign()pasando valores para el template assign() Descripción void assign (mixed var) void assign (string varname, mixed var) Usted puede explicitamente pasar pares de nombres/valores, o un arreglo asociativo conteniendo el par de nombre/valor. Ejemplo 13.3. assign() <?php // pasando pares de nombre/valor $smarty->assign('Name', 'Fred'); $smarty->assign('Address', $address); // pasando un arreglo asosiativo $smarty->assign(array('city' => 'Lincoln', 'state' => 'Nebraska')); // pasando un row desde una base de datos (eg adodb) $sql = 'select id, name, email from contacts where contact ='.$id; $smarty->assign('contact', $db->getRow($sql)); ?> Accesando estos en el template con {$Name} {$Address} {$city} {$state} {$contact.id}, {$contact.name},{$contact.email} ?> Para ver una asignacion de arreglos mas compleja {foreach} y {section} Vea también assign_by_ref(), get_template_vars(), clear_assign(), append() y {assign} 108
La clase Methods() de Smarty assign_by_ref assign_by_refpasando valores por referencia assign_by_ref Descripción void assign_by_ref (string varname, mixed var) Este es usado para asignar valores por referencia al template en vez de hacer una copia. Vea el manual de PHP en la parte sobre referencia de variables para una explicación mas detallada. Nota Técnica: Este es usado para asignar valores por referencia al template. Si ested asigna una variable por refe- rencia entonces cambiara este valor, el valor asignado exprimentara el cambio también. Para objetos, as- sign_by_ref() también exite una copia del objetos asignado en memoria. Vea el manual de PHP en refereciando va- riables para una mejor explicación. Ejemplo 13.4. assign_by_ref() <?php // passing name/value pairs $smarty->assign_by_ref('Name', $myname); $smarty->assign_by_ref('Address', $address); ?> Ver también assign(), clear_all_assign(), append() y {assign} 109
La clase Methods() de Smarty clear_all_assign() clear_all_assign()>limpia el valor de todas las variables asignadas clear_all_assign() Descripción void clear_all_assign (void) Ejemplo 13.5. clear_all_assign() <?php // passing name/value pairs $smarty->assign('Name', 'Fred'); $smarty->assign('Address', $address); // will output above print_r( $smarty->get_template_vars() ); // clear all assigned variables $smarty->clear_all_assign(); // will output nothing print_r( $smarty->get_template_vars() ); ?> Ver también clear_assign(), clear_config(), assign() y append() 110
La clase Methods() de Smarty clear_all_cache clear_all_cachelimpia completamente el cache del template clear_all_cache void clear_all_cache ([int expire_time]) Como un parámetro opcional, usted puede proporcionar un periodo minimo en segundos que el archivo de cache debe tener antes de ser anulado. Ejemplo 13.6. clear_all_cache <?php // clear the entire cache $smarty->clear_all_cache(); ?> Ver también clear_cache(), is_cached() y caching 111
La clase Methods() de Smarty clear_assign() clear_assign()limpia el valor de una variable asignada clear_assign() Descripción void clear_assign (mixed var) Este puede ser un valor simple, o un arreglo de valores. Ejemplo 13.7. clear_assign() <?php // clear a single variable $smarty->clear_assign('Name'); // clear multiple variables $smarty->clear_assign(array('Name', 'Address', 'Zip')); ?> Ver también clear_all_assign(), clear_config(), get_template_vars(), assign() y append() 112
La clase Methods() de Smarty clear_cache() clear_cache()Esto limpia el cache de un template especifico clear_cache() Descripción void clear_cache (string template [, string cache_id [, string compile_id [, int expire_time]]]) Si usted tiene multiples caches en este archivo, usted puede limpiar un cache especifico proporcionando el cache_id como segundo parámetro Usted también puede pasar el $compile_id como un tercer parámetro. Usted puede "agrupar" templates conjuntamente de esta manera estos pueden ser removidos como un grupo. Vea el caching section para mayor información. Como un cuarto parámetro opcional, usted puede proporcionar un periodo minimo en segundos que el archivo de cache de- be tener antes de ser anulado. Ejemplo 13.8. clear_cache() <?php // clear the cache for a template $smarty->clear_cache('index.tpl'); // clear the cache for a particular cache id in an multiple-cache template $smarty->clear_cache('index.tpl', 'CACHEID'); ?> Ver también clear_all_cache() y caching. 113
La clase Methods() de Smarty clear_compiled_tpl() clear_compiled_tpl()Esto limpia la vesion compilada del recurso de un template especifico clear_compiled_tpl() Descripción void clear_compiled_tpl ([string tpl_file [, string compile_id [, int exp_time]]]) Esto limpia la versión compilada del recurso del template especificado, o todos los archivos de templates compilados si no fueron especificados. si usted pasa $compile_id solo sera compilado este template especificado $compile_id es limpiado. Si usted lo pasa con ex_time, entonces solo compilara los templates anteriores al exp_time segundo seran limpiados, por de- fault todos los templates son compilados y limpiados independientemente de su tiempo de vida. Esta función es solo para uso avanzado, normalmente no es necesaria. Ejemplo 13.9. clear_compiled_tpl() <?php // clear a specific template resource $smarty->clear_compiled_tpl("index.tpl"); // clear entire compile directory $smarty->clear_compiled_tpl(); ?> 114
La clase Methods() de Smarty clear_config() clear_config()Esto limpia todas las variables de configuración clear_config() Descripción void clear_config ([string var]) Esto limpia todas las variables de configuración asignadas. Si es proporcionado el nombre de una variable, solo esa variable es limpiada. Ejemplo 13.10. clear_config() <?php // clear all assigned config variables. $smarty->clear_config(); // clear one variable $smarty->clear_config('foobar'); ?> Ver también get_config_vars(), config variables, config files, {config_load}, config_load() y clear_assign() 115
La clase Methods() de Smarty config_load() config_load()Carga el archivo de configuración y lo asigna al template config_load() Descripción void config_load (string file [, string section]) Esto carga el archivo de configuración de datos y lo asigna al template. Esto funciona idéntico a la función {config_load}. Nota Técnica: A partir de Smarty 2.4.0, las variables de template asignadas son mantenidas a través de fetch() y display(). Las variables de configuración cargadas de config_load() son siempre de alcance global. Los archivos de configuracion también son compilados para execución rapida, y respetar el force_compile y compile_check de con- figuración. Ejemplo 13.11. config_load() <?php // load config variables and assign them $smarty->config_load('my.conf'); // load a section $smarty->config_load('my.conf', 'foobar'); ?> Ver también {config_load}, get_config_vars(), clear_config(), y config variables 116
La clase Methods() de Smarty display() display()Despliega el Template display() Descripción void display (string template [, string cache_id [, string compile_id]]) Este despliega el template diferente de fetch(). Cargando un tipo valido de path template resource. Como un segundo pará- metro opcional, usted puede pasar un identificador de cache. Vea el caching section para mayor información. Como tercer parametro opcional, usted puede pasar compile_id. Este en el caso que usted quira compilar diferentes versio- nes del mismo Tempalte, tal como tener separadas varios Templates compilados de diferentes lenguajes. Otro uso para com- pile_id es cuando usted usa mas de un $template_dir pero solo un $compile_dir. Ponga separado compile_id por cada $template_dir, de otra manera los tempate con el mismo nombre se sobre escibiran uno sobre otro. Uste puede poner tam- bién la variable $compile_id una vez en lugar de pasar esta por cada llamada a la función. Ejemplo 13.12. display() <?php include("Smarty.class.php"); $smarty = new Smarty; $smarty->caching = true; // only do db calls if cache doesn't exist if(!$smarty->is_cached("index.tpl")) { // dummy up some data $address = "245 N 50th"; $db_data = array( "City" => "Lincoln", "State" => "Nebraska", "Zip" => "68502" ); $smarty->assign("Name","Fred"); $smarty->assign("Address",$address); $smarty->assign($db_data); } // display the output $smarty->display("index.tpl"); ?> Use la sintaxis template resources para mostrar archivos fuera del directorio $template_dir. Ejemplo 13.13. Ejemplos de recursos de la función display <?php // absolute filepath $smarty->display('/usr/local/include/templates/header.tpl'); // absolute filepath (same thing) $smarty->display('file:/usr/local/include/templates/header.tpl'); 117
La clase Methods() de Smarty // windows absolute filepath (MUST use "file:" prefix) $smarty->display('file:C:/www/pub/templates/header.tpl'); // include from template resource named "db" $smarty->display('db:header.tpl'); ?> Ver también fetch() y template_exists(). 118
La clase Methods() de Smarty fetch() fetch()Retorna la salida del template fetch() Descripción string fetch (string template [, string cache_id [, string $compile_id]]) Este retorna la salida del template en vez de desplegarla. Proporcionando un tipo y path valido template resource. Como un segundo parámetro opcional, usted puede pasar el identificador de cache. vea el caching section para mayor información. Como tercer parametro opcional, usted puede pasar compile_id. Este en el caso que usted quira compilar diferentes versio- nes del mismo Tempalte, tal como tener separadas varios Templates compilados de diferentes lenguajes. Otro uso para com- pile_id es cuando usted usa mas de un $template_dir pero solo un $compile_dir. Ponga separado compile_id por cada $template_dir, de otra manera los tempate con el mismo nombre se sobre escibiran uno sobre otro. Uste puede poner tam- bién la variable $compile_id una vez en lugar de pasar esta por cada llamada a la función. Ejemplo 13.14. fetch() <?php include('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; // only do db calls if cache doesn't exist if(!$smarty->is_cached('index.tpl')) { // dummy up some data $address = '245 N 50th'; $db_data = array( 'City' => 'Lincoln', 'State' => 'Nebraska', 'Zip' => '68502' ); $smarty->assign('Name','Fred'); $smarty->assign('Address',$address); $smarty->assign($db_data); } // capture the output $output = $smarty->fetch('index.tpl'); // do something with $output here echo $output; ?> Ejemplo 13.15. Usando fetch() y enviando a un e-mail El template email_body.tpl 119
La clase Methods() de Smarty Dear {$contact.name}, Welcome and thankyou for signing up as a member of our user group, Click on the link below to login with your user name of '{$contact.login_id}' so you can post in our forums. http://{$smarty.server.SERVER_NAME}/index.php?page=login List master Some user group {include file="email_disclaimer.tpl"} El template email_disclaimer.tpl usando el modificador {textformat}. {textformat wrap=40} Unless you are named "{$contact.name}", you may read only the "odd numbered words" (every other word beginning with the first) of the message above. If you have violated that, then you hereby owe the sender 10 GBP for each even numbered word you have read {/textformat} y el script de PHP usando la función mail() [http://php.net/function.mail] <?php // get contact from database eg using pear or adodb $query = 'select name, email, login_id from contacts where contact_id='.$contact_id; $contact = $db->getRow($sql); $smarty->assign('contact', $contact); mail($contact['email'], 'Subject', $smarty->fetch('email_body.tpl')); ?> Ver también {fetch} display(), {eval}, y template_exists(). 120
La clase Methods() de Smarty get_config_vars() get_config_vars()retorna el valor asignado a la variable de configuración get_config_vars() Descripción array get_config_vars ([string varname]) Si no tiene un parámetro asignado, un arreglo de todas las variables de los archivos de configuración es retornado. Ejemplo 13.16. get_config_vars() <?php // get loaded config template var 'foo' $foo = $smarty->get_config_vars('foo'); // get all loaded config template vars $config_vars = $smarty->get_config_vars(); // take a look at them print_r($config_vars); ?> Ver también clear_config(), {config_load}, config_load() y get_template_vars(). 121
La clase Methods() de Smarty get_registered_object() get_registered_object()Este retorna una referencia para un objeto registrado. get_registered_object() Descripción array get_registered_object (string object_name) Este es útil dentro de una función habitual cuando usted necesita acesar directamente a un objeto registrado. Ver objects pa- ra mas información; Ejemplo 13.17. get_registered_object() <?php function smarty_block_foo($params, &$smarty) { if (isset($params['object'])) { // get reference to registered object $obj_ref = &$smarty->get_registered_object($params['object']); // use $obj_ref is now a reference to the object } } ?> Ver también register_object(), unregister_object() y objects section 122
La clase Methods() de Smarty get_template_vars() get_template_vars()Retorna el valor asignado a una variable get_template_vars() descripción array get_template_vars ([string varname]) Si no tiene un parámetro dado, un arreglo de todas las variables asignadas es retornado. Ejemplo 13.18. get_template_vars <?php // get assigned template var 'foo' $foo = $smarty->get_template_vars('foo'); // get all assigned template vars $tpl_vars = $smarty->get_template_vars(); // take a look at them print_r($tpl_vars); ?> Ver también assign(), {assign}, assign_by_ref(), append(), clear_assign(), clear_all_assign() y get_config_vars() 123
La clase Methods() de Smarty is_cached() is_cached()Retorna true si hay cache valido para ese template is_cached() Descripción bool is_cached (string template [, string cache_id [, string compile_id]]) Esto solamente funciona si caching está asignado a true. ver también caching section. Ejemplo 13.19. is_cached() <?php $smarty->caching = true; if(!$smarty->is_cached("index.tpl")) { // do database calls, assign vars here } $smarty->display("index.tpl"); ?> Usted también puede pasar un identificador de $cache como un segundo parámetro opcional en el caso que usted quiera multiples caches para el template dado. Usted puede proporcionar el identidicador como un tercer parametro opcional. Si usted omite ese parametro la persistencia del $compile_id es usada. Si usted no quiere pasar el identificador de cache solamente quiere pasar el compile id debe pasar null como el identidfica- dor de cache. Ejemplo 13.20. is_cached() con templates con multiple-cache <?php $smarty->caching = true; if(!$smarty->is_cached("index.tpl", "FrontPage")) { // do database calls, assign vars here } $smarty->display("index.tpl", "FrontPage"); ?> Nota técnica: Si is_cached retorna true el carga actualmente la salida del cache y lo guarda internamente. cual- quier subsecuente llama a display() o fetch() y retorna este internamente guardando la salida y no intenta volver a cargar el archivo del cache. Esto previene una condicion de la carrera que puede ocurrir cuando un segundo proce- so limpie el cache entre las llamadas a is_cached mostradas en el ejemplo de arriba. Esto significa tambien llamar al clear_cache() y otros cambios en el cache-settings que no tiene efecto despues que is_cached retorna true. Ver también clear_cache(), clear_all_cache(), y caching section. 124
La clase Methods() de Smarty load_filter() load_filter()Carga un filtro de plugin load_filter() Descripción void load_filter (string type, string name) El primer argumento especifíca el tipo de filtro a cargar y puede ser uno de los siguientes: 'pre', 'post', o 'output'. El segundo argumento especifíca el nombre del filtro del plugin, por ejemplo, 'trim'. Ejemplo 13.21. loading filter plugins <?php $smarty->load_filter('pre', 'trim'); // load prefilter named 'trim' $smarty->load_filter('pre', 'datefooter'); // load another prefilter named 'datefooter' $smarty->load_filter('output', 'compress'); // load output filter named 'compress' ?> Ver también register_prefilter(), register_postfilter(), register_outputfilter(), $autoload_filters y Advanced features. 125
La clase Methods() de Smarty register_block() register_block()Registra dinamicamente bloques de funciones de plugins register_block() Descripción void register_block (string name, mixed impl, bool cacheable, mixed cache_attrs) Use este para registrar dinámicamente bloques de funciones de plugins. Pase el bloque de nombres de función, seguido por una llamada de función PHP que implemente esto. La llamada de una funcion-php impl puede ser cualquier (a) cadena conteniendo el nombre de la función o (b) un arreglo con el formato array(&$object, $method) con &$object siendo la referencia a un objeto y $method siendo una cade- na conteniendo el nombre del método o (c) un arreglo con el formato array(&$class, $method) con $class siendo un nombre de clase y $method siendo un método de esta clase. cacheable y cache_attrs pueden ser omitidos en la mayoria de los casos. Vea Controlando modos de salida de cache de los plugins para saber como usar las propiedades. Ejemplo 13.22. register_block() <?php $smarty->register_block('translate', 'do_translation'); function do_translation ($params, $content, &$smarty, &$repeat) { if (isset($content)) { $lang = $params['lang']; // do some translation with $content return $translation; } } ?> Donde el template es: {* template *} {translate lang="br"} Hello, world! {/translate} Ver también unregister_block() y Plugin Block Functions. 126
La clase Methods() de Smarty register_compiler_function register_compiler_functionRegistra dinamicamente un plugin de una funcion compiladora register_compiler_function Descripción bool register_compiler_function (string name, mixed impl, bool cacheable) Pase el nombre de la función compiladora, seguido por la función PHP que implemente esto. La llamada a la funcion-php impl puede ser a. a una cadena conteniendo el nombre de la función b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre del método c. un arreglo con la forma array(&$class, $method) con $class siendo el nombre de una clase y $method siendo el método de esta clase. cacheable puede ser omitido en la mayoria de los casos. Vea Controlando modos de Salida de Cache de los Plugins para ob- tener mayor información. Ver también unregister_compiler_function() y Plugin Compiler Functions. 127
La clase Methods() de Smarty register_function() register_function()Registra dinamicamente un plugin de función para un template register_function() Descripción void register_function (string name, mixed impl [, bool cacheable [, mixed cache_attrs]]) Pase en el template el nombre de la función, seguido por el nombre de la función PHP que implementa esto. La llamada a la funcion-php impl puede ser: a. a una cadena conteniendo el nombre de la función o b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre del método c. un arreglo con la forma array(&$class, $method) con $class siendo el nombre de una clase y $method siendo un metodo de esa clase. cacheable y cache_attrs pueden ser omitidos en la mayoria de los caasos. Vea Controlando modos de Salida Cache de los Plugins para obtener mayores informes. Ejemplo 13.23. register_function() <?php $smarty->register_function('date_now', 'print_current_date'); function print_current_date($params, &$smarty) { if(empty($params['format'])) { $format = "%b %e, %Y"; } else { $format = $params['format']; return strftime($format,time()); } } ?> y en el template {date_now} {* or to format differently *} {date_now format="%Y/%m/%d"} Ver también unregister_function() y Plugin functions. 128
La clase Methods() de Smarty register_modifier() register_modifier()mofidica dinámicamente plugins registrados register_modifier() Descripción void register_modifier (string name, mixed impl) Pase en el template el nombre del modificador, seguido de la función PHP que implemente esto. La llamada de la funcion-php impl puede ser a. una cadena conteniendo el nombre de la función b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre de un metodo c. un arreglo con la forma array(&$class, $method) con $class siendo el nombre de una clase y $method siendo un metodo de esta clase. Ejemplo 13.24. register_modifier() <?php // let's map PHP's stripslashes function to a Smarty modifier. $smarty->register_modifier('sslash', 'stripslashes'); ?> template <?php {* use 'sslash' to strip slashes from variables *} {$var|sslash} ?> Ver También unregister_modifier(), register_function(), modifiers, Extending Smarty with plugins y Creating Plugin modi- fiers, 129
La clase Methods() de Smarty register_object() register_object()Registr un objeto para usar en el template register_object() Descripción void register_object (string object_name, object object, array allowed_methods_properties, boolean format, array block_methods) Vea object section para ejemplos. Vea también get_registered_object(), y unregister_object(). 130
La clase Methods() de Smarty register_outputfilter() register_outputfilter()Registra dinamicamente filtros de salida register_outputfilter() Descripción void register_outputfilter (mixed function) Use este para registrar dinámicamente filtros de salida para operaciones en la salida del template antes de mostrarlo. Vea Filtros de Salida de Templates para mayores informes de como configurar una función de filtro de salida. La llamada de la funcion-php function puede ser a. una cadena conteniendo un nombre de función b. un arreglo con la forma array(&$object, $method) con &$object siendo referencia a un objeto y $method sien- do una cadena conteniendo el nombre de un metodo c. un arreglo con la forma array(&$class, $method) con $class siendo el nombre de la clase y $method siendo un método de esta clase. Vea también unregister_outputfilter(), register_prefilter(), register_postfilter(), load_filter(), $autoload_filters y template output filters. 131
La clase Methods() de Smarty register_postfilter() register_postfilter()Resgistr dinamicamente postfiltros register_postfilter() Descripción void register_postfilter (mixed function) Use esto para registrar dinámicamente postfiltros para correr templates directos después de ser compilados. Vea postfiltros de template para mayores informes de como configurar funciones de postfiltering. La llamada de la funcion-php function puede ser: a. una cadena conteniendo un nombre de función b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre de un método c. un arreglo con la forma array(&$class, $method) con $class siendo un nombre de clase y $method siendo un método de esta clase. Vea También unregister_postfilter(), register_prefilter(), register_ouputfilter(), load_filter(), $autoload_filters y template output filters. 132
La clase Methods() de Smarty register_prefilter() register_prefilter()Registra dinamicamente prefiltros register_prefilter() Descripción void register_prefilter (mixed function) Use esto para registrar prefiltros dinámicamente para correr templates antes de que estos sean compilados. Vea template prefilters para mayores informes de como configurar una función de prefiltering. La llamada de la funcion-php function puede ser: a. una cadena conteniendo un nombre de función b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre de un método c. un arreglo con la forma array(&$class, $method) con $class siendo un nombre de clase y $method siendo un método de esta clase. Ver también unregister_prefilter(), register_postfilter(), register_ouputfilter(), load_filter(), $autoload_filters y template out- put filters. 133
La clase Methods() de Smarty register_resource register_resourceRegistra dinamicamente un plugin de recurso register_resource Descripción void register_resource (string name, array resource_funcs) Use esto para registrar dinámicamente un recurso de plugin con Smarty. Pase el nombre o el recurso y o el arreglo de fun- ciones que implementa esto. Vea template resources para mayor información de como configurar una función para mandar llamar templates. Nota técnica: El nombre del recurso debe tener al menos dos caracteres de largo. Un nombre de recurso de un ca- rácter será ignorado y usado como parte del path del archivo como, $smarty->display('c:/path/to/index.tpl'); La php-funcion-array resource_funcs debe tener 4 o 5 elementos. Con 4 elementos los elementos son las llamadas para las respectivas funciones de recurso "source", "timestamp", "secure" y "trusted". Con 5 elementos el primer elemento tiene que ser un objeto por referencia o un nombre de clase del objeto o una clase implementando el recurso y los 4 elementos si- guientes tiene que ser los nombres de los métodos implementando "source", "timestamp", "secure" y "trusted". Ejemplo 13.25. register_resource <?php $smarty->register_resource('db', array('db_get_template', 'db_get_timestamp', 'db_get_secure', 'db_get_trusted')); ?> Ver también unregister_resource() y template resources 134
La clase Methods() de Smarty trigger_error trigger_errorDespliega un mensaje de error trigger_error Descripción void trigger_error (string error_msg [, int level]) Esta función puede ser usada para la salida de un mensaje de error usando Smarty. El parámetro level es uno de los valores usados para la función de php trigger_error() [http://php.net/trigger_error], ex.: E_USER_NOTICE, E_USER_WARNING, etc. Por default es E_USER_WARNING. Ver también $error_reporting, debugging y Troubleshooting. 135
La clase Methods() de Smarty template_exists() template_exists()Verifica si el template especificado existe template_exists() Descripción bool template_exists (string template) Este puede aceptar un path para el template en el filesystem o un recurso de cadena especificando el template. Ejemplo 13.26. template_exists() Este ejemplo utiliza $_GET['page'] este incluye el contenido del template. Si el template no existe entonces un error de pa- gina es deplegado en su lugar. El page_container.tpl <html> <head><title>{$title}</title></head> <body> {include file='page_top.tpl'} {* include middle content page *} {include file=$page_mid} {include file='page_footer.tpl'} </body> y el script PHP <?php // set the filename eg index.inc.tpl $mid_template = $_GET['page'].'.inc.tpl'; if( !$smarty->template_exists($mid_template) ){ $mid_template = 'page_not_found.inc.tpl'; } $smarty->assign('page_mid', $mid_template); $smarty->display('page_container.tpl'); ?> Ver también display(), fetch(), {include} y {insert} 136
La clase Methods() de Smarty unregister_block unregister_blockDes-registra dinamicamente un plugin de bloque de funciones unregister_block Descripción void unregister_block (string name) Use esto para des-registrar dinámicamente un bloque de funciones de plugin. Pase en el bloque el nombre de la función. Ver también register_block() y Block Functions Plugins. 137
La clase Methods() de Smarty unregister_compiler_function() unregister_compiler_function()des-registrar dinámicamente una función de compilación unregister_compiler_function() Descripción void unregister_compiler_function (string name) Pase el nombre de la función compiladora. Ver también register_compiler_function() y Plugin Compiler Functions. 138
La clase Methods() de Smarty unregister_function() unregister_function()des-registrar dinámicamente una función de plugin del template unregister_function() Descripción void unregister_function (string name) Pase en el template el nombre de la función. Ejemplo 13.27. unregister_function() <?php // nosotros no queremos que el dise&ntilde;ador del template tenga acceso a // nuestros archivos de sistema $smarty->unregister_function("fetch"); ?> Ver también register_function() . 139
La clase Methods() de Smarty unregister_modifier() unregister_modifier()des-registrar dinámicamente un modificador de plugin unregister_modifier() Descripción void unregister_modifier (string name) Pase en el template el nombre del modificador. Ejemplo 13.28. unregister_modifier() <?php // nosotros no queremos que el dise&ntilde;ador de template use strip tags // para los elementos $smarty->unregister_modifier("strip_tags"); ?> Ver también register_modifier() y Plugin modifiers, 140
La clase Methods() de Smarty unregister_object() unregister_object()Des-registra dinamicamente un objeto unregister_object() Descripción void unregister_object (string object_name) Ver también register_object() y objects section 141
La clase Methods() de Smarty unregister_outputfilter() unregister_outputfilter()des-registra dinámicamente un filtro de salida unregister_outputfilter() Descripción void unregister_outputfilter (string function_name) Use este para des-registrar dinámicamente un filtro de salida. Ver también register_outputfilter() y template output filters. 142
La clase Methods() de Smarty unregister_postfilter() unregister_postfilter()Des-registra dinamicamente un postfiltro unregister_postfilter() Descripción void unregister_postfilter (string function_name) Ver también register_postfilter() y template post filters. 143
La clase Methods() de Smarty unregister_prefilter() unregister_prefilter()Des-registra dinamicamente un prefiltro unregister_prefilter() Descripción void unregister_prefilter (string function_name) Ver también register_prefilter() y pre filters. 144
La clase Methods() de Smarty unregister_resource() unregister_resource()Des-registra dinamicamente un plugin de recurso unregister_resource() Descripción void unregister_resource (string name) Pase en el parámetro el nombre del recurso. Ejemplo 13.29. unregister_resource() <?php $smarty->unregister_resource("db"); ?> Ver también register_resource() y template resources 145
Capítulo 14. Cache Tabla de contenidos Configurando el Cache ........................................................................................................................ 146 Multiples caches por pagina ................................................................................................................. 148 Cache Groups .................................................................................................................................... 149 Controlando salida de Cacheabilidad de plugins ....................................................................................... 150 Caching es usado para aumentar la velocidad de llamada de display() o fetch() salvando esto en un archivo de salida. Si hay una versión de cache disponible para la llamada, este es mostrado en vez de regresar la salida de datos. Caching puede hacer cosas tremendamente rápidas, especialmente templates con largo tiempo de computo. Desde la salida de datos de display() o fetch() está en cache, un archivo de cache podría ser compuesto por diversos archivos de templates, archivos de configura- ción, etc. Dado que sus templates son dinámicos, es importante tener cuidado de como usa la cache y por cuanto tiempo. Por ejemplo, si usted esta mostrando la pagina principal de su web site y esta no tiene cambios muy frecuentes en su contenido, esta pue- de funcionar bien en la cache por una hora o mas. por otro lado, si usted esta mostrando una pagina con un mapa de tiempo que contenga nueva información por minuto, no tiene sentido hacer cache nuestra página. Configurando el Cache Lo primero que se tiene que hacer es habilitar el cache. esto es configurar $caching = true (o 1.) Ejemplo 14.1. Habilitando Cache <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; $smarty->display('index.tpl'); ?> Con el caching habilitado, la llamada a la función display('index.tpl') traera el template como siempre, pero también salvara una copia en el archivo de salida (una copia de cache) en el $cache_dir. En la proxima llamada de display('index.tpl'), la co- pia en cache sera usada en vez de traer nuevamente el template. Nota Técnica: Los archivos en el $cache_dir son nombrados similarmente al nombre del archivo de template. Aunque ellos tengan una extensión ".php", ellos no son realmente scripts ejecutables de php. No edite estos archi- vos! Cada pagina en cache tiene un periodo de tiempo limitado determinado por $cache_lifetime. El default del valor es 3600 se- gundos, o 1 hora. Después de este tiempo expira, el cache es regenerado. Es posible dar tiempos individuales para caches con su propio tiempo de expiración para configuración $caching = 2. Vea la documentación en $cache_lifetime para mas detalles. Ejemplo 14.2. Configurando cache_lifetime por cache 146
Cache <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = 2; // lifetime is per cache // set the cache_lifetime for index.tpl to 5 minutes $smarty->cache_lifetime = 300; $smarty->display('index.tpl'); // set the cache_lifetime for home.tpl to 1 hour $smarty->cache_lifetime = 3600; $smarty->display('home.tpl'); // NOTE: the following $cache_lifetime setting will not work when $caching = 2. // The cache lifetime for home.tpl has already been set // to 1 hour, and will no longer respect the value of $cache_lifetime. // The home.tpl cache will still expire after 1 hour. $smarty->cache_lifetime = 30; // 30 seconds $smarty->display('home.tpl'); ?> Si $compile_check está habilitado, cada archivo de template y archivo de configuración que está involucrado con el archivo en cache es checado por modificadores. Si alguno de estos archivos fue modificado desde que el ultimo cache fue generado, el cache es regenerado inmediatamente. Esto es una forma de optimizar ligeramente el rendimiento de las cabeceras, dejar $compile_check determinado false. Ejemplo 14.3. Habilitando $compile_check <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; $smarty->compile_check = true; $smarty->display('index.tpl'); ?> Si $force_compile está habilitado, los archivos de cache siempre seran regenerados. Esto definitivamente desactiva el ca- ching. $force_compile generalmente es usado para propositos de debug solamente, una forma mas eficiente de desactivar el caching es asignando $caching = false (ó 0.) La función is_cached() puede ser usada para testar si un template tiene un cache valido o no. Si usted tiene un template con cache que requiera alguna cosa como un retorno de base de datos, usted puede usar esto para saltar este proceso. Ejemplo 14.4. Usando is_cached() <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; if(!$smarty->is_cached('index.tpl')) { // No cache available, do variable assignments here. $contents = get_database_contents(); $smarty->assign($contents); } 147
Cache $smarty->display('index.tpl'); ?> Usted puede guardar partes de su pagina dinámica con la función de template {insert}. Vamos a decir que su pagina entera puede tener cache excepto para un banner que es mostrado abajo del lado derecho de su pagina. Usando la función insert pa- ra el banner, usted puede guardar ese elemento dinámico dentro de un contenido de cache. Vea la documentación en {insert} para detalles y ejemplos. Usted puede limpiar todos los archivos de cache con la función clear_all_cache(), los archivos de cache individuales (o gru- pos) con la función clear_cache(). Ejemplo 14.5. Limpiando el cache <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; // clear out all cache files $smarty->clear_all_cache(); // clear only cache for index.tpl $smarty->clear_cache('index.tpl'); $smarty->display('index.tpl'); ?> Multiples caches por pagina Usted puede tener multiples archivos de cache para una simples llamada de display() o fetch(). Vamos a decir que una lla- mada a display('index.tpl') debe tener varios contenidos de salida diferentes dependiendo de alguna condición, y usted quie- re separar los caches para cada una. Usted puede hacer esto pasando un cache_id como un segundo parámetro en la llamada de la función. Ejemplo 14.6. Pasando un cache_id para display() <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; $my_cache_id = $_GET['article_id']; $smarty->display('index.tpl',$my_cache_id); ?> Arriba, nosotros pasamos la variable $my_cache_id a display() con el cache_id. Para cada valor unico de $my_cache_id, un cache por separado sera generado para cada index.tpl. En este ejemplo, "article_id" fue pasado en URL y es usado como el cache_id. Nota Técnica: Tenga mucho cuidado cuando pase valores del cliente (web browser) dentro de Smarty (o alguna aplicación PHP). Aunque el ejemplo de arriba usar el article_id desde una URL parece facil, esto podría tener fata- 148
Cache les consecuencias. El cache_id es usado para crear un directorio en el sistema de archivos, entonces si el usuario decide pasar un valor extremadamente largo para article_id, o escribir un script que envia article_ids aleatorios en un paso rápido, esto posiblemente podría causar problemas a nivel del servidor. Tenga la certeza de limpiar algún dato pasado antes de usarlo. En este ejemplo, tal vez usted sabia que el article_id tiene un largo de 10 caracteres es- te es constituido solamente de alfanuméricos, y debe ser un article_id valido en la base de datos. Verifique esto! Asegurarse de pasar el mismo cache_id como el segundo parámetro para is_cached() y clear_cache(). Ejemplo 14.7. Pasando un cache_id para is_cached() <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; $my_cache_id = $_GET['article_id']; if(!$smarty->is_cached('index.tpl',$my_cache_id)) { // No cache available, do variable assignments here. $contents = get_database_contents(); $smarty->assign($contents); } $smarty->display('index.tpl',$my_cache_id); ?> Usted puede limpar todos los caches para un cache_id en particular pasando el primer parámetro null a clear_cache().. Ejemplo 14.8. Limpando todos los caches para un cache_id en particular <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; // clear all caches with "sports" as the cache_id $smarty->clear_cache(null,"sports"); $smarty->display('index.tpl',"sports"); ?> De esta manera, usted puede "agrupar" sus caches conjuntamente dando les el mismo cache_id. Cache Groups Usted puede hacer agrupamientos mas elaborados configurando grupos de cache_id. Esto se logra con la separación de cada sub-grupo con una barra vertical "|" en el valor del cache_id. Usted puede tener tantos sub-grupos como guste. Usted puede pensar que los grupos de cache son parecidos a un directorio para organizar. por ejemplo, un grupo de cache con "a|b|b" podria pensarse como la estructura del directorio "a/b/c/". clear_cache(null,"a|b|c") esto seria para quitar los ar- chivos "/a/b/c/*". clear_cache(null,"a|b") esto seria para quitar los archivos "/a/b/*". Si usted espicifica el compile_id como clear_cache(null,"a|b","foo") este tratara de agregarlo al grupo de cache "/a/b/c/foo/". Si usted especifica el nombre del tem- plate tal como clear_cache("foo.tpl","a|b|c") entonces el smarty intentara borrar "/a/b/c/foo.tpl". Usted no puede borrar un nombre de template especifico bajo multiples grupos de cache como "/a/b/*/foo.tpl", el grupo de cache trabaja solo de iz- 149
Cache quierda a derecha. Usted puede necesitar para su grupos de templates un unico grupo de cache jerarquico para poder lim- piarlos como grupos. El agupamiento de cache no debe ser confundido con su directorio jerarquico del template, El agrupamiento de cache no tie- ne ninguna ciencia de como sus templates son estructurados. Por ejemplo, si usted tiene una estructura dis- play('themes/blue/index.tpl'), usted no puede limpiar el cache para todo bajo el diretorio "themes/blue". Si usted quiere ha- cer esto, usted debe agruparlos en el cache_id, como display('themes/blue/index.tpl','themes|blue'); Entonces usted puede limpiar los caches para el tema azul con clear_cache(null,'themes|blue'); Ejemplo 14.9. Grupos de cache_id <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; // clear all caches with "sports|basketball" as the first two cache_id groups $smarty->clear_cache(null,"sports|basketball"); // clear all caches with "sports" as the first cache_id group. This would // include "sports|basketball", or "sports|(anything)|(anything)|(anything)|..." $smarty->clear_cache(null,"sports"); // clear the foo.tpl cache file with "sports|basketball" as the cache_id $smarty->clear_cache("foo.tpl","sports|basketball"); $smarty->display('index.tpl',"sports|basketball"); ?> 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(), re- gister_compiler_function() y register_function() es llamado $cacheable y el default es true que es también el comportamien- to 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 ca- cheados 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"; 150
Cache } $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 pa- gina 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. 151
Capítulo 15. Caracteristicas Avanzadas Tabla de contenidos Objetos ............................................................................................................................................ 152 Prefilters .......................................................................................................................................... 153 Postfilters ......................................................................................................................................... 153 Filtros de salida ................................................................................................................................. 154 Función manipuladora de cache ............................................................................................................ 154 Recursos .......................................................................................................................................... 156 Objetos El Smarty permite acceso a objetos de PHP a través de sus templates. Hay dos formas de accesarlos. Una forma es registran- do objetos para el template, entonces acceselos mediante sintaxis similar a las funciones habituales. La otra es asignar obje- tos 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 propieda- des. 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áme- tro 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 fun- ciones de costumbre los obtienen. Un arreglo asociativo es pasado como el primer parámetro, y el objeto smarty como el se- gundo. Si usted quiere que los parámetros pasados uno de cada vez por cada argumento pasen como parámetros de un obje- to 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 compor- tan como block-function-plugins. Ejemplo 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 152
Caracteristicas Avanzadas $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)} Prefilters Los prefilters de Template son funciones de PHP que corren sus templates antes de ser compilados. Esto es bueno para pro- cesar por adelantado sus templates y remover comentarios no deseados, vigilando a las personas que coloquen en sus tem- plates, etc. Los Prefilters pueden ser registrado o cargado del directorio de plugins usando la función load_filter() o por la configura- ción de la variable $autoload_filters. El Smarty pasara el código fuente del template como el primer argumento, y espera que la función le retorne el código fuen- te del template resultante. Ejemplo 15.2. usando un prefiltro prefilter de template <?php // ponga esto en su aplicación function remove_dw_comments($tpl_source, &$smarty) { return preg_replace("/<!--#.*-->/U","",$tpl_source); } // registrar el prefilter $smarty->register_prefilter("remove_dw_comments"); $smarty->display("index.tpl"); ?> Esto eliminara todos los comentarios en el codigo del template. Postfilters Los postfilters de template son funciones de PHP con las cuales sus templates son corridos inmediatamente después de ser compilados. Los postfilters pueden ser registrado o cargados del directorio de plugins usando la función load_filter() o por la variable de configuración $autoload_filters. El Smarty pasara el código fuente del template compilado como el primer ar- gumento, y espera que la función retorne el resultado del procesamiento. 153
Caracteristicas Avanzadas Ejemplo 15.3. Usando un postfilter de template <?php // ponga esto en su aplicaci&oacute;n function add_header_comment($tpl_source, &$smarty) { return "<?php echo "<!-- Created by Smarty! -->;n" ?>;n".$tpl_source; } // registra el postfilter $smarty->register_postfilter("add_header_comment"); $smarty->display("index.tpl"); ?> Observe como hacer la compilacion para Smarty del template index.tpl: <!-- Created by Smarty! --> {* rest of template content... *} Filtros de salida Cuando el template es invocado a través de display() o fetch(), su salida puede ser enviada a través de uno o mas filtros de salida. Este es diferente a los postfilters porque los postfilters operan en los templates compilados antes de ser salvados en disco, y los filtros de salida operan en la salida del template cuando este es ejecutado. Los Filtros de Salida pueden ser registrado o cargados del directorio de plugins usando la función load_filter() o configuran- do a variable $autoload_filters. El Smarty pasara la salida como el primer argumento, y espera que la función retorne el re- sultado del procesamiento. Ejemplo 15.4. Usando un filtro de salida de template <?php // ponga esto en su aplicación function protect_email($tpl_output, &$smarty) { $tpl_output = preg_replace('!(S+)@([a-zA-Z0-9.-]+.([a-zA-Z]{2,3}|[0-9]{1,3}))!', '$1%40$2', $tpl_output); return $tpl_output; } // registra el outputfilter $smarty->register_outputfilter("protect_email"); $smarty->display("index.tpl"); // Ahora cualquier ocurrencia de una direcci&oacute;n de email en la salida // del template tendra una simple protecci&oacute;n contra spambots ?> Función manipuladora de cache Como una alternativa al uso del mecanismo de caching por default basado en archivo, usted puede especificar una función habitual de manipulación de cache que será usada para leer, escribir y limpar archivos de cache. Cree una función en su aplicación para que Smarty la use como un manipulador de cache. Defina el nombre de la variable 154
Caracteristicas Avanzadas de clase en el $cache_handler_func. El Smarty ahora usara esta para manipular datos en el cache. El primer parámetro es la acción, que puede ser uno de estos 'read', 'write' y 'clear'. El segundo parámetro es el objeto de Smarty. El tercer parámetro es el contenido que esta en el cache. Sobre 'write', el Smarty pasa el contenido en cache en estos parámetros. sobre 'read', el Smarty espera que su función acepte este parámetro por referencia y poblar estos con los datos en cache. Sobre 'clear', el Smarty pasa una variable en cero desde aquí que esta no es usada. El cuarto parámetro es el nombre del archivo de templa- te(necesario para leer/escribir). El quinto parámetro es la cache_id (opcional). El sexto parámetro es la compile_id (opcional). NOTA: El ultimo parámetro ($exp_time) fue adicionado en el Smarty-2.6.0. Ejemplo 15.5. ejemplo usando MySQL como una fuente de cache <?php /* ejemplo de uso: include('Smarty.class.php'); include('mysql_cache_handler.php'); $smarty = new Smarty; $smarty->cache_handler_func = 'mysql_cache_handler'; $smarty->display('index.tpl'); mysql database is expected in this format: create database SMARTY_CACHE; create table CACHE_PAGES( CacheID char(32) PRIMARY KEY, CacheContents MEDIUMTEXT NOT NULL ); */ function mysql_cache_handler($action, &$smarty_obj, &$cache_content, $tpl_file=null, $cache_id=null, $c { // set db host, user and pass here $db_host = 'localhost'; $db_user = 'myuser'; $db_pass = 'mypass'; $db_name = 'SMARTY_CACHE'; $use_gzip = false; // create unique cache id $CacheID = md5($tpl_file.$cache_id.$compile_id); if(! $link = mysql_pconnect($db_host, $db_user, $db_pass)) { $smarty_obj->_trigger_error_msg("cache_handler: could not connect to database"); return false; } mysql_select_db($db_name); switch ($action) { case 'read': // read cache from database $results = mysql_query("select CacheContents from CACHE_PAGES where CacheID='$C if(!$results) { $smarty_obj->_trigger_error_msg("cache_handler: query failed."); } $row = mysql_fetch_array($results,MYSQL_ASSOC); if($use_gzip && function_exists("gzuncompress")) { $cache_content = gzuncompress($row["CacheContents"]); } else { 155
Caracteristicas Avanzadas $cache_content = $row["CacheContents"]; } $return = $results; break; case 'write': // save cache to database if($use_gzip && function_exists("gzcompress")) { // compress the contents for storage efficiency $contents = gzcompress($cache_content); } else { $contents = $cache_content; } $results = mysql_query("replace into CACHE_PAGES values( '$CacheID', '".addslashes($contents)."') "); if(!$results) { $smarty_obj->_trigger_error_msg("cache_handler: query failed."); } $return = $results; break; case 'clear': // clear cache info if(empty($cache_id) && empty($compile_id) && empty($tpl_file)) { // clear them all $results = mysql_query("delete from CACHE_PAGES"); } else { $results = mysql_query("delete from CACHE_PAGES where CacheID='$CacheID } if(!$results) { $smarty_obj->_trigger_error_msg("cache_handler: query failed."); } $return = $results; break; default: // error, unknown action $smarty_obj->_trigger_error_msg("cache_handler: unknown action "$action""); $return = false; break; } mysql_close($link); return $return; } ?> Recursos Los templates pueden venir de una variedad de fuentes. Cuando usted muestra un template con display() o fetch(), o incluye un template dentro de otro template, usted suministra un tipo de recurso, seguido por la ruta correcta y el nombre del tem- plate. Si un recurso no es dado explicitamente el valor de $default_resource_type es asumido. Templates desde $template_dir Los templates desde el $template_dir no requieren recursos del template, aunque usted puede usar el file: resource for con- sistancy(recurso por consistencia). Justamente proporcionando la ruta(path) del template que usted quiere usar en relación al directorio root $template_dir. Ejemplo 15.6. Usando templates desde $template_dir 156
Caracteristicas Avanzadas <?php // desde el script de PHP $smarty->display("index.tpl"); $smarty->display("admin/menu.tpl"); $smarty->display("file:admin/menu.tpl"); // igual al de arriba ?> {* dentro del template de Smarty *} {include file="index.tpl"} {include file="file:index.tpl"} {* igual al de arriba *} Templates partiendo de cualquier directorio Los templates de fuera del $template_dir requieren el file: tipo de recurso del template, seguido por la ruta absoluta y el nombre del template. Ejemplo 15.7. usando templates desde cualquier directorio <?php // desde el script de PHP $smarty->display("file:/export/templates/index.tpl"); $smarty->display("file:/path/to/my/templates/menu.tpl"); ?> dentro del template Smarty: {include file="file:/usr/local/share/templates/navigation.tpl"} Rutas de archivos de Windows Si usted esta utilizando una maquina con windows, las rutas de los archivos normalmente incluyen la letra del drive (C:) en el comienzo del nombre de la ruta. Asegurarse de usar "file:" en la ruta para evitar conflictos de nombres y poder obtener los resultados desados. Ejemplo 15.8. usando templates con rutas de archivos de windows <?php // dentro del script de PHP $smarty->display("file:C:/export/templates/index.tpl"); $smarty->display("file:F:/path/to/my/templates/menu.tpl"); ?> dentro del template de Smarty {include file="file:D:/usr/local/share/templates/navigation.tpl"} Templates partiendo de otras fuentes Se pueden retomar templates usando cualquier fuente posible a la que usted pueda acceder con PHP: base de datos, sockets, LDAP, etc. Usted puede hacer esto escribiendo las funciones de plugin de recurso y registrandolas con Smarty. 157
Caracteristicas Avanzadas Vea la sección resource plugins para mayor informacion sobre las funciones que puede utilizar. nota: Nota Usted puede activar manualmente el recurso file incrustado, pero no puede suministrar un recurso que busca templates a partir del sistema de archivos de alguna otra forma registrando bajo otro nombre de recurso. Ejemplo 15.9. Usando recursos habituales <?php // ponga estas funciones en algun lugar de su aplicación function db_get_template ($tpl_name, &$tpl_source, &$smarty_obj) { // llame su base de datos parta traer los datos al template, // poblando el $tpl_source $sql = new SQL; $sql->query("select tpl_source from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_source = $sql->record['tpl_source']; return true; } else { return false; } } function db_get_timestamp($tpl_name, &$tpl_timestamp, &$smarty_obj) { // llame su base de datos para traer los datos y poblar el $tpl_timestamp. $sql = new SQL; $sql->query("select tpl_timestamp from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_timestamp = $sql->record['tpl_timestamp']; return true; } else { return false; } } function db_get_secure($tpl_name, &$smarty_obj) { // asume que todos los templates son seguros return true; } function db_get_trusted($tpl_name, &$smarty_obj) { // no usar para templates } // registrar el nombre del recurso "db" $smarty->register_resource("db", array("db_get_template", "db_get_timestamp", "db_get_secure", "db_get_trusted")); // usando el recurso a partir del script PHP $smarty->display("db:index.tpl"); ?> usando el recurso dentro del template de Smarty {include file="db:/extras/navigation.tpl"} 158
Caracteristicas Avanzadas Función manipuladora de Template por default Usted puede especificar la función que será usada para devolver el contenido del template dentro del evento del template no puede ser retomado desde su recurso. Un uso distinto es para crear templates que no existen "on-the-fly" (templates cuyo contenido cambia mucho, bastante variable). Ejemplo 15.10. usando la función manipuladora de template por default <?php // ponga esta funci&oacute;n en algun lugar de su aplicaci&oacute;n function make_template ($resource_type, $resource_name, &$template_source, &$template_timestamp, &$smar { if( $resource_type == 'file' ) { if ( ! is_readable ( $resource_name )) { // create the template file, return contents. $template_source = "This is a new template."; $template_timestamp = time(); $smarty_obj->_write_file($resource_name,$template_source); return true; } } else { // not a file return false; } } // defina la funci&oacute;n manipuladora por default $smarty->default_template_handler_func = 'make_template'; ?> 159
Capítulo 16. Extendiendo Smarty con plugins Tabla de contenidos Como funcionan los Plugins ................................................................................................................. 160 Nombres convencionales ..................................................................................................................... 160 Escribiendo Plugins ............................................................................................................................ 161 Funciones de Template ........................................................................................................................ 161 Modificadores ................................................................................................................................... 163 Block Functions ................................................................................................................................. 164 Funciones Compiladoras ..................................................................................................................... 165 Prefiltros/Postfiltros ............................................................................................................................ 166 Filtros de Salida ................................................................................................................................. 167 Fuentes ............................................................................................................................................ 167 Inserts .............................................................................................................................................. 169 La version 2.0 introduce la arquitectura de plugin que es usada para casi todas las funcionalidades adaptables del Smarty. Esto incluye: • funciones • modificadores • funciones de bloque • funciones de compilación • prefiltros • postfiltros • filtros de salida • recursos(fuentes) • inserts Con la excepción de recursos, la compatibildad con la forma antigua de funciones de manipulación de registro via register_* API es conservada. Si usted no uso el API en lugar de eso modifico las variables de clase $custom_funcs, $custom_mods, y otras directamente, entonces usted va a necesitar ajustar sus scripts para cualquiera que use el API o con- vertir sus funciones habituales en plugins. Como funcionan los Plugins Los plugins son siempre cargados cuando son requeridos. solo los calificativos especificos, funciones, recursos, etc convo- cados en scripts del template seran leidos. Además, cada plugin es cargado una sola vez, aun si usted tiene corriendo varias instancias diferentes de Smarty dentro de la misma petición. Pre/posfiltros y salidas de filtros son una parte de un caso especial. Dado que ellos no son mensionados en los templates, ellos deben ser registrados o leidos explicitamente mediante funciones de API antes de que el template sea procesado. El or- den en el cual son ejecutados multiples filtros del mismo tipo depende del orden en el que estos son registrados o leidos. El directorio de directory puede ser una cadena que contenga una ruta o un arreglo que contenga multiples rutas. Para insta- lar un plugin, simplemente coloquelo en el directorio y el Smarty lo usara automáticamente. Nombres convencionales 160
Extendiendo Smarty con plugins Los archivos y funciones de Plugin deben seguir una convención de apariencia muy especifica a fin de que pueda ser locali- zada por el Smarty. Los archivos de plugin deben ser nombrados de la siguiente forma: type.name.php Donde type es uno de los siguientes tipo de plugin: • function • modifier • block • compiler • prefilter • postfilter • outputfilter • resource • insert Y name seria un identificador valido (solo, letras, números, y underscores). Algunos ejemplos: function.html_select_date.php, resource.db.php, modifier.spacify.php. Las funciones de plugin dentro de los archivos de plugin deben ser nombradas de la siguiente forma: smarty_type, _name() El significado de type and name son los mismo que loas anteriores. El Smarty mostrara mensajes de error apropiados si el archivo de plugins que es necesario no es encontrado, o si el archivo a la función de plugin esta nombrado inadecuadamente. Escribiendo Plugins Los Plugins pueden ser leidos por el Smarty automáticamente del sistema de archivos o pueden ser registrados en tiempo de ejecución por medio de una de las funciones de API register_* . Estos también pueden ser usados con la función API unre- gister_*. Para los plugins que son registrados en tiempo de ejecución, el nombre de la(s) función(es) de plugin no tiene que seguir la convención de apariencia. Si un plugin depende de alguna función alimentada por otro plugin (como es el caso con algunos plugins incrustados con el Smarty), entonces la forma apropiada para leer el plugin necesario es esta: <?php require_once $smarty->_get_plugin_filepath('function', 'html_options'); ?> Como regla general, el objeto Smarty siempre es pasado a los plugins como ultimo parámetro (con dos excepciones: los mo- dificadores no pasan el objeto de Smarty del todo y los blocks obtenidos son pasados &$repeat después el objeto de Smarty para manter compatibilidad con antiguas versiones de Smarty). Funciones de Template void smarty_function_name()($params, &$smarty); 161
Extendiendo Smarty con plugins array $params; object &$smarty; Todos los atributos pasados para las funciones de template a partir del template estan contenidas en $params como un arre- glo asociativo. La salida(valor de retorno) de la función será substituida en el lugar de la etiqueta de la función en el template (la función fetch(), por ejemplo). Alternativamente, la función puede simplemente ejecutar alguna otra tarea sin tener alguna salida (la función assign()). Si la función necesita pasar valores a algunas variables del template o utilizar alguna otra funcionalidad del Smarty, esta puede usar el objeto $smarty alimentandolo para hacer eso. Vea tambien: register_function(), unregister_function(). Ejemplo 16.1. Función de plugin con salida <?php /* * Smarty plugin * ------------------------------------------------------------- * File: function.eightball.php * Type: function * Name: eightball * Purpose: outputs a random magic answer * ------------------------------------------------------------- */ function smarty_function_eightball($params, &$smarty) { $answers = array('Yes', 'No', 'No way', 'Outlook not so good', 'Ask again soon', 'Maybe in your reality'); $result = array_rand($answers); return $answers[$result]; } ?> que puede ser usada en el template de la siguiente forma: Question: Will we ever have time travel? Answer: {eightball}. Ejemplo 16.2. Función de plugin sin salida <?php /* * Smarty plugin * ------------------------------------------------------------- * File: function.assign.php * Type: function * Name: assign * Purpose: assign a value to a template variable * ------------------------------------------------------------- */ function smarty_function_assign($params, &$smarty) 162
Extendiendo Smarty con plugins { if (empty($params['var'])) { $smarty->trigger_error("assign: missing 'var' parameter"); return; } if (!in_array('value', array_keys($params))) { $smarty->trigger_error("assign: missing 'value' parameter"); return; } $smarty->assign($params['var'], $params['value']); } ?> Modificadores Los modificadores son funciones que son aplicadas a una variable en el template antes de ser mostrada o usada en algun otro contexto. Los modificadores pueden ser encadenados conjuntamente. mixed smarty_modifier_name()($value, $param1); mixed $value; [mixed $param1, ...]; El primer parámetro en el modificador de plugin es el valor sobre el cual el modificador es precisa para funcionar. El resto de los parámetros pueden ser opcionales, dependiendo de cual tipo de operación va a ser ejecutada. El modificador debe retornar el resultado de su procesamiento. Vea Tambien register_modifier(), unregister_modifier(). Ejemplo 16.3. Plugin modificador simple Este plugin básicamente es un alias de una función incorporada en PHP. Este no tiene ningun parámetro adicional. <?php /* * Smarty plugin * ------------------------------------------------------------- * File: modifier.capitalize.php * Type: modifier * Name: capitalize * Purpose: capitalize words in the string * ------------------------------------------------------------- */ function smarty_modifier_capitalize($string) { return ucwords($string); } ?> Ejemplo 16.4. Plugin modificador mas complejo <?php /* * Smarty plugin * ------------------------------------------------------------- * File: modifier.truncate.php 163
Extendiendo Smarty con plugins * Type: modifier * Name: truncate * Purpose: Truncate a string to a certain length if necessary, * optionally splitting in the middle of a word, and * appending the $etc string. * ------------------------------------------------------------- */ function smarty_modifier_truncate($string, $length = 80, $etc = '...', $break_words = false) { if ($length == 0) return ''; if (strlen($string) > $length) { $length -= strlen($etc); $fragment = substr($string, 0, $length+1); if ($break_words) $fragment = substr($fragment, 0, -1); else $fragment = preg_replace('/s+(S+)?$/', '', $fragment); return $fragment.$etc; } else return $string; } ?> Block Functions void smarty_block_name()($params, $content, &$smarty, &$repeat); array $params; mixed $content; object &$smarty; boolean &$repeat; Las funciones de bloque son funciones de forma: {func} .. {/func}. En otras palabras, estas encapsulan un bloque del tem- plate y operan el contenido de este bloque. Las funciones de bloque toman precedencia sobre las funciones habituales con el mismo nombre, es decir, usted no puede tener ambas, las funciones habituales {func} y las funciones de bloque {func} .. {/func}. Por default la implementación de su función es llamada dos veces por el Smarty: una vez por la etiqueta de apertura, y la otra por la etiqueta de cierre (vea &$repeat abajo para ver como hacer cambios a esto). Solo la etiqueta de apertura de la función de bloque puede tener atributos. Todos los atributos pasados a las funciones de template estan contenidos en $params como un arreglo asociativo. Usted puede accesar a cualquiera de estos valores direc- tamente, e.g. $params['start']. Los atributos de la etiqueta de apertura son también son accesibles a su función cuando se procesa la etiqueta de cierre. El valor de la variable $content depende de que si su función es llamada por la etiqueta de cierre o de apertura. En caso de que la etiqueta sea de apertura, este será null, si la etiqueta es de cierre el valor será del contenido del bloque del template. Se debe observar que el bloque del template ya a sido procesado por el Smarty, asi todo lo que usted recibirá es la salida del template, no el template original. El parámetro &$repeat es pasado por referencia para la función de implementación y proporciona la posibilidad de contro- lar cuantas veces será mostrado el bloque. Por default $repeat es true en la primera llamada de la block-function (etiqueta de apertura del bloque) y false en todas las llamadas subsecuentes a la función de boque (etiqueta de cierre del boque). Cada vez que es implementada la función retorna con el &$repeat siendo true, el contenido entre {func} .. {/func} es eva- luado y es implementado a la función es llamada nuevamente con el nuevo contenido del bloque en el parámetro $content. Si usted tiene funciones de bloque anidadas, es posible descubrir cual es el padre de la función de bloque accesando la varia- ble $smarty->_tag_stack. Solo hacer un var_dump() sobre ella y la estrutura estara visible. Vea tambien: register_block(), unregister_block(). 164
Extendiendo Smarty con plugins Ejemplo 16.5. Función de bloque <?php /* * Smarty plugin * ------------------------------------------------------------- * File: block.translate.php * Type: block * Name: translate * Purpose: translate a block of text * ------------------------------------------------------------- */ function smarty_block_translate($params, $content, &$smarty, &$repeat) { if (isset($content)) { $lang = $params['lang']; // do some intelligent translation thing here with $content return $translation; } } ?> 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 habi- tual 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, to- do 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 *} 165
Extendiendo Smarty con plugins {tplheader} El codigo PHP resultante en el template compilado seria algo asi: <?php echo 'index.tpl compiled at 2002-02-20 20:02'; ?> Prefiltros/Postfiltros Los Plugins Prefilter y postfilter con muy similares en concepto; donde ellos difieren es en la ejecución -- mas precisamente en el tiempo sus ejecuciones. string smarty_prefilter_name()($source, &$smarty); string $source; object &$smarty; Los Prefilters son usados para procesar el fuente del template inmediatamente antes de la compilación. El primer parámetro de la función del prefilter es el fuente del template, posiblemente modificado por algunos otros prefilters. El Plugin es su- puesto que retorne el fuente modificado. Observe que este código no es salvado en ningun lugar, este es solo usado para la compilación. string smarty_postfilter_name()($compiled, &$smarty); string $compiled; object &$smarty; Los Postfilters son usados para procesar la salida compilada del template (el código PHP) inmediatamente después de que la compilacion es terminada pero antes de que el template compilado sea salvado en el sistema de archivos. El primer paráme- tro para la función postfilter es el código del template compilado, posiblemente modificado por otros postfilters. El plugin se supone retornara la versión modificada de este código. Ejemplo 16.7. prefilter plugin <?php /* * Smarty plugin * ------------------------------------------------------------- * File: prefilter.pre01.php * Type: prefilter * Name: pre01 * Purpose: Convert html tags to be lowercase. * ------------------------------------------------------------- */ function smarty_prefilter_pre01($source, &$smarty) { return preg_replace('!<(w+)[^>]+>!e', 'strtolower("$1")', $source); } ?> Ejemplo 16.8. postfilter plugin <?php /* * Smarty plugin * ------------------------------------------------------------- * File: postfilter.post01.php 166
Extendiendo Smarty con plugins * Type: postfilter * Name: post01 * Purpose: Output code that lists all current template vars. * ------------------------------------------------------------- */ function smarty_postfilter_post01($compiled, &$smarty) { $compiled = "<pre>n<?php print_r($this->get_template_vars()); ?>n</pre>" . $compiled; return $compiled; } ?> Filtros de Salida Los Filtros de salida operan en la salida del template, después que el template es cargado y ejecutado, pero antes que la sali- da sea mostrada. string smarty_outputfilter_name()($template_output, &$smarty); string $template_output; object &$smarty; El primer parámetro de la función de filtro de salida es la salida del template que necesita ser procesada, y el segundo pará- metro es la instancia del Smarty invocando el plugin. El plugin debe hacer el procesamiento y retornar los resultados. Ejemplo 16.9. plugin de filtro de salida <?php /* * Smarty plugin * ------------------------------------------------------------- * File: outputfilter.protect_email.php * Type: outputfilter * Name: protect_email * Purpose: Converts @ sign in email addresses to %40 as * a simple protection against spambots * ------------------------------------------------------------- */ function smarty_outputfilter_protect_email($output, &$smarty) { return preg_replace('!(S+)@([a-zA-Z0-9.-]+.([a-zA-Z]{2,3}|[0-9]{1,3}))!', '$1%40$2', $output); } ?> Fuentes Las fuentes de los plugins son como una forma generica de suministrar código fuente de template o componentes de script PHP al Smarty. Algunos ejemplos de fuentes: base de datos, LDAP, memoria compartida, sockets, etc. Existe un total de 4 funciones que necesitan estar registradas para cada tipo de fuente. Cada función recibirá el fuente reque- rido como primer parámetro y el objeto de Smarty como ultimo parámetro. El resto de los parámetros dependen de la fun- ción. bool smarty_resource_name_source()($rsrc_name, &$source, &$smarty); string $rsrc_name; string &$source; object &$smarty; bool smarty_resource_name_timestamp()($rsrc_name, &$timestamp, &$smarty); string $rsrc_name; 167
Extendiendo Smarty con plugins int &$timestamp; object &$smarty; bool smarty_resource_name_secure()($rsrc_name, &$smarty); string $rsrc_name; object &$smarty; bool smarty_resource_name_trusted()($rsrc_name, &$smarty); string $rsrc_name; object &$smarty; La primera función debe devolver el recurso. Su segundo parámetro es una variable pasada por referencia donde el resultado debe ser almacenado. La función debe retornar true si esta pudo recuperar satisfactoriamente el recurso y en caso contrario retornara false. La segunda función debe devolver la ultima modificación del recurso requerido (como un timestamp Unix). El segundo pa- rámetro es una variable pasada por referencia donde el timestamp sera almacenado. La función debe retornar true si el ti- mestamp pudo ser determinado satisfactoriamente, y en caso contrario retornara false. La tercera función debe retornar true o false, dependiendo si el recurso requerido es seguro o no. Esta función es usada solo para recursos de template pero esta debe ser definida. La cuarta función debe retornar true o false, dependiendo si el recurso requerido es seguro o no. Esta función es usada solo para componetes de script de PHP solicitado por las etiquetas include_php o insert con el atributo src. Sin embargo, este debe ser definido para los recurso del template. Vea también register_resource(), unregister_resource(). Ejemplo 16.10. Plugin resource (recurso) <?php /* * Smarty plugin * ------------------------------------------------------------- * File: resource.db.php * Type: resource * Name: db * Purpose: Fetches templates from a database * ------------------------------------------------------------- */ function smarty_resource_db_source($tpl_name, &$tpl_source, &$smarty) { // do database call here to fetch your template, // populating $tpl_source $sql = new SQL; $sql->query("select tpl_source from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_source = $sql->record['tpl_source']; return true; } else { return false; } } function smarty_resource_db_timestamp($tpl_name, &$tpl_timestamp, &$smarty) { // do database call here to populate $tpl_timestamp. $sql = new SQL; $sql->query("select tpl_timestamp from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_timestamp = $sql->record['tpl_timestamp']; return true; } else { 168
Extendiendo Smarty con plugins return false; } } function smarty_resource_db_secure($tpl_name, &$smarty) { // assume all templates are secure return true; } function smarty_resource_db_trusted($tpl_name, &$smarty) { // not used for templates } ?> Inserts Los Plugins Insert son usados para implementar funciones que son invocadas por las etiquetas insert en el template. string smarty_insert_name()($params, &$smarty); array $params; object &$smarty; El primer parámetro de la función es un arreglo asociativo de atributos pasados al insert. La función insert debe retornar el resultado que ira a sustituir el lugar de la etiqueta insert en el template. Ejemplo 16.11. insert plugin <?php /* * Smarty plugin * ------------------------------------------------------------- * File: insert.time.php * Type: time * Name: time * Purpose: Inserts current date/time according to format * ------------------------------------------------------------- */ function smarty_insert_time($params, &$smarty) { if (empty($params['format'])) { $smarty->trigger_error("insert time: missing 'format' parameter"); return; } $datetime = strftime($params['format']); return $datetime; } ?> 169
Parte IV. Appendixes Tabla de contenidos 17. Localización de Errores .................................................................................................................. 171 Errores Smarty/PHP ........................................................................................................... 171 18. Consejos y Trucos ......................................................................................................................... 173 Manipulación de Variables Vacias ......................................................................................... 173 Manipulación del valor default de una variable ........................................................................ 173 Pasando la variable titulo a la cabecera del template .................................................................. 174 Fechas ............................................................................................................................. 174 WAP/WML ...................................................................................................................... 175 Templates con Componetes .................................................................................................. 176 Ofuscando direcciones de E-mail .......................................................................................... 177 19. Fuentes ....................................................................................................................................... 178 20. ERRORES ................................................................................................................................... 179 170
Capítulo 17. Localización de Errores Tabla de contenidos Errores Smarty/PHP ........................................................................................................................... 171 Errores Smarty/PHP El Smarty puede obtener muchos errores tales como, atributos de etiquetas perdidos o nombres de variables mal formadas. Si este ocurre, Usted vera un error similar al siguiente: Ejemplo 17.1. Errores de Smarty Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah' in /path/to/smarty/Smarty.class.php on line 1041 Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name in /path/to/smarty/Smarty.class.php on line 1041 Smarty te mostra el nombre del template, el número de la linea y el error. Después de esto, el error consiste en el número de la linea de la clase Smarty donde ocurrio el error. Existen ciertos errores que el Smarty no puede entender, tales como un etiqueta de cierre errado. Estos tipos de erros nor- malmente termina en una interpretacion de error del tiempo de compilacion de PHP. Ejemplo 17.2. Errores de analisis gramatical de PHP Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75 Cuando usted encuentra un error de analisis de PHP, el número de la linea de error corresponde al script PHP compilado, no al template en si. Normalmente usted puede en el template localizar el error de sinxis. Algunas cosas que usted puede bus- car: falta de cierre de etiquetas para {if}{/if}} o {section}{/section}, o sintaxis de la lógica dentro de una etiqueta {if}. Si usted no encuentra el error, usted tendra que abrir el archivo PHP compilado y dirigirse al número de linea mostrado, donde el correspondiente error esta en el template. Ejemplo 17.3. Otros errores comunes • Warning: Smarty error: unable to read resource: "index.tpl" in... or Warning: Smarty error: unable to read resource: "site.conf" in... 171
Localización de Errores • El $template_dir no existe o es incorrecto, o el archivo index.tpl no esta en la carpeta templates/ • La función {config_load} esta dentro del template (o config_load() habia sido llamado) y cualquira de los dos $config_dir es incorrecto, no exista o site.conf no existe en el directorio. • Fatal error: Smarty error: the $compile_dir 'templates_c' does not exist, or is not a directory... Cualquiera de las dos el $compile_dir es asignado incorrectamente, el directorio no existe, o templates_c es un archi- vo y no un directorio. • Fatal error: Smarty error: unable to write to $compile_dir '.... El $compile_dir no puede ser reescrito por el servidor web. Vea a fondo la pagina de permisos del instalación de smarty. • Fatal error: Smarty error: the $cache_dir 'cache' does not exist, or is not a directory. in /.. Esto significa que $caching es habilitado y cualquiera de los dos; el $cache_dir es asignado incorrectamente, o el direc- torio no existe, o cache es un archivo y no un directorio. • Fatal error: Smarty error: unable to write to $cache_dir '/... Esto significa que $caching es habilitado y el $cache_dir no puede ser rescrito por el web server. Ver ampliamente la pa- gina de permisos de la instalacion de smarty. Vea también debugging, $error_reporting y trigger_error(). 172
Capítulo 18. Consejos y Trucos Tabla de contenidos Manipulación de Variables Vacias ......................................................................................................... 173 Manipulación del valor default de una variable ........................................................................................ 173 Pasando la variable titulo a la cabecera del template .................................................................................. 174 Fechas ............................................................................................................................................. 174 WAP/WML ...................................................................................................................................... 175 Templates con Componetes .................................................................................................................. 176 Ofuscando direcciones de E-mail .......................................................................................................... 177 Manipulación de Variables Vacias Cuando usted en algunas ocaciones quiere imprimir un valor que usted defíne a una variable vacia en vez de imprimir nada, tal como imprimir "&nbsp;" a fin de que el plano del fondo de la tabla funcione correctamente. Muchos usarian una senten- cia {if} para manejar esto, mas existe otra forma con Smarty, usando el modificador de la variable default. Ejemplo 18.1. Imprimiendo &nbsp; cuando una variable esta vacia {* the long way *} {if $title eq ""} &nbsp; {else} {$title} {/if} {* the short way *} {$title|default:"&nbsp;"} Ver tambien default y Default Variable Handling. Manipulación del valor default de una variable Si una variable es usada frecuentemente en sus templates, aplicando el modificador default toda vez que este es mencionado puede evitar un bit desagradable. Usted puede remediar esto con la atribución de un valor por default a la variable con la función {assign}. Ejemplo 18.2. Atribuyendo el valor por default a una variable en el template {* ponga esto en algun lugar en la parte de arriba de su template *} {assign var="title" value=$title|default:"no title"} {* Si el $titulo estaba vacio, este ahora tendra el valor "sin titulo" cuando usted lo exiba *} 173
Consejos y Trucos {$title} Vea tambiéen default y Blank Variable Handling. Pasando la variable titulo a la cabecera del template Cuando la mayoria de sus templates usan los mismo encabezados y los mismos pies de pagina, es común dividirlos uno en cada template y entonces incluirlos {include}. Que pasara si el encabezado necesita tener un titulo diferente, dependiendo de que pagina estas viniendo? usted puede pasar el titulo en el encabezado cuando este es incluido. Ejemplo 18.3. Pasando la variable titulo al encabezado del template mainpage.tpl {include file="header.tpl" title="Main Page"} {* template body goes here *} {include file="footer.tpl"} archives.tpl {config_load file="archive_page.conf"} {include file="header.tpl" title=#archivePageTitle#} {* template body goes here *} {include file="footer.tpl"} header.tpl <html> <head> <title>{$title|default:"BC News"}</title> </head> <body> footer.tpl </body> </html> Cuando la pagina principal es mostrada, el titulo de la "Página Principal" es pasado al template header.tpl, y será poste- riormente usado como el titulo. Cuando la pagina de archivo es mostrada, el titulo sera "Archivos". Observelo en el ejemplo de archivo, nosotros estamos usando una variable del archivo archives_page.conf en vez de una variable codificada ri- gida. Tambien note que "BC news" es mostrada si la variable $titulo no esta definida, usando el modificador de la variable default. Fechas Como una regla basica, siempre pase fechas al Smarty como timestamps. Esto permite al diseñador de template utilizar da- te_format para el control completo sobre el formato de fechas, y también facilita la comparación de fechas si es necesario. nota: En el Smarty 1.4.0, usted puede parsar fechas al Smarty como timestamps unix,mysql, o cualquier otra fecha interpretable por strtotime() [http://php.net/strtotime]. 174
Consejos y Trucos Ejemplo 18.4. Usando date_format {$startDate|date_format} Esta es la salida: Jan 4, 2001 {$startDate|date_format:"%Y/%m/%d"} Esta es la Salida: 2001/01/04 {if $date1 < $date2} ... {/if} Cuando usa {html_select_date} en un template, el programador normalmente va a querer convertir la salida de un formula- rio de vuelta al formato timestamp. Aquí esta una función para ayudar con esto. Ejemplo 18.5. Convirtiendo elementos en forma de fecha de vuelta a un timestamp <?php // esto asume que la forma de sus elementos son nombradas como // startDate_Day, startDate_Month, startDate_Year $startDate = makeTimeStamp($startDate_Year, $startDate_Month, $startDate_Day); function makeTimeStamp($year="", $month="", $day="") { if(empty($year)) { $year = strftime("%Y"); } if(empty($month)) { $month = strftime("%m"); } if(empty($day)) { $day = strftime("%d"); } return mktime(0, 0, 0, $month, $day, $year); } ?> Vea también {html_select_date}, {html_select_time}, date_format y $smarty.now, WAP/WML Los templates WAP/WML requieren de un encabezado de Content-Type [http:/ / php.net/ header] de PHP para ser pasado junto con el template. La forma mas fácil de hacer esto seria escribir una función de manera habitual que imprima el encabe- zado. Si usted esta usando el sistema de cache, este no funcionara, entonces nosotros haremos esto usando una etiqueta de {insert} (recuerde que las etiquetas insert no son "cacheadas!"). Asegurarse que no exista ninguna salida al navegador antes 175
Consejos y Trucos del template, de otro modo el encabezado fallara. Ejemplo 18.6. Usando insert para escribir un encabezado WML Content-Type <?php // Asegurarse que el apache esta configurado para las extenciones .wml ! // ponga esta función en algun lugar de su aplicación, o en Smarty.addons.php function insert_header($params) { // this function expects $content argument if (empty($params['content'])) { return; } header($params['content']); return; } ?> Su template de Smarty debe comenzar con la etiqueta insert, como en el ejemplo: {insert name=header content="Content-Type: text/vnd.wap.wml"} <?xml version="1.0"?> <!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml"> <!-- begin new wml deck --> <wml> <!-- begin first card --> <card> <do type="accept"> <go href="#two"/> </do> <p> Welcome to WAP with Smarty! Press OK to continue... </p> </card> <!-- begin second card --> <card id="two"> <p> Pretty easy isn't it? </p> </card> </wml> Templates con Componetes Tradicionalmente, programar templates en sus aplicaciones es de la siguiente forma: Primero, usted acumula sus variables dentro de su aplicación PHP, (talvez como requisiciones de una base de datos). Entonces, usted instancia su objeto Smarty assign(), atribuye valores a las variables y muestra el template display(). Por ejemplo nosotros tenemos un registrador de existencias en nuestro template. Nosotros recolectaremos los datos de las existencias en nuestra aplicación, entonces damos valor a estas variables en el template y lo mostramos. Ahora esto seria genial si usted adicionara este registrador de almace- namiento (stock ticker) a cualquier aplicación simplemente incluyendolo en el template, y no preocuparse hacerca de como ir a traer los datos al frente? Usted puede escribir este plugin haciendo que traiga un contenido y asignarlo a la variable del template. Ejemplo 18.7. Templates con Componetes 176
Consejos y Trucos function.load_ticker.php - deja el archivo en $plugins directory <?php // deja el archivo "function.load_ticker.php" en el directorio de plugins // configura nuestra funci&oacute;n para traer los datos almacenados function fetch_ticker($symbol) { // ponga la lógica aquí que traera $ticker_name // y $ticker_price de algun recurso return $ticker_info; } function smarty_function_load_ticker($params, &$smarty) { // llama la función $ticker_info = fetch_ticker($params['symbol']); // asigna las variables al template $smarty->assign($params['assign'], $ticker_info); } ?> index.tpl {load_ticker symbol="YHOO" assign="ticker"} Stock Name: {$ticker.name} Stock Price: {$ticker.price} Vea también {include_php}, {include} y {php}. Ofuscando direcciones de E-mail Usted desea saber como su direccion de E-mail consigue entrar en tantas listas de e-mail de spam? Una direccion unica spammers recolecta direcciones de E-mail y de paginas web. Para ayudar a combatir este problema, usted puede hacer que su direccion de E-mail aparesca en javascript mostrado en el codigo HTML, este mismo aparecera y funcionara correcta- mente en el navegador. Esto se puede hacer con el plugin {mailto}. Ejemplo 18.8. Ejemplo de ofuscamiento de una direccion de E-mail {* in index.tpl *} Send inquiries to {mailto address=$EmailAddress encode="javascript" subject="Hello"} Nota Técnica: Este metodo no es 100% a pueba de fallas. Un spammer podría crear un programa para recolectar el e-mail y para decodificar estos valores, mas no es muy común. Vea también escape y {mailto}. 177
Capítulo 19. Fuentes La pagina principal del Smarty está localizada en http://smarty.php.net/. Usted puede ingresar a la lista de email enviando un e-mail a smarty-general-subscribe@lists.php.net. El archivo de la lista de e-mail puede ser visto en http:/ / marc.theaimsgroup.com/?l=smarty-general&r=1&w=2. 178
Capítulo 20. ERRORES Revise el archivo de BUGS que viene con la ultima distribución del Smarty, o Revise el website. 179

Más contenido relacionado

PDF
Índice de libro: "Spring Boot & Angular: Desarrollo de WebApps Seguras. Tomo ...
Chema Alonso
 
PDF
Índice del libro "Spring Boot & Angular: Desarrollo de Webapps seguras" de 0x...
Chema Alonso
 
PDF
Excel, Tecnicas Avanzadas.pdf
home
 
PDF
Índice del libro "Ataques en redes de datos IPv4&IPv6 (4ª Edición)"
Chema Alonso
 
PDF
Manual de-s10-2005
Marco Mamani Chocre
 
PDF
Manual de s10_2005
Enriqueeeee
 
PDF
Curso javascript
Lener Romero
 
PDF
Índice del libro "Hacking Aplicaciones Web: SQL Injection"
Chema Alonso
 
Índice de libro: "Spring Boot & Angular: Desarrollo de WebApps Seguras. Tomo ...
Chema Alonso
 
Índice del libro "Spring Boot & Angular: Desarrollo de Webapps seguras" de 0x...
Chema Alonso
 
Excel, Tecnicas Avanzadas.pdf
home
 
Índice del libro "Ataques en redes de datos IPv4&IPv6 (4ª Edición)"
Chema Alonso
 
Manual de-s10-2005
Marco Mamani Chocre
 
Manual de s10_2005
Enriqueeeee
 
Curso javascript
Lener Romero
 
Índice del libro "Hacking Aplicaciones Web: SQL Injection"
Chema Alonso
 

La actualidad más candente (19)

PDF
Hacking con Python
Chema Alonso
 
PDF
Índice del libro "Machine Learning aplicado a Ciberseguridad: Técnicas y ejem...
Chema Alonso
 
PDF
Manual ofimatica v2.3
UCLA
 
PDF
Índice del libro de Windows Server 2016: Administración, Seguridad y Operaciones
Chema Alonso
 
PDF
Calculo diferencial
Pascual Onofre
 
PDF
Índice del libro "Hacking con Drones" de 0xWord
Chema Alonso
 
PDF
3 geoestadistica
edmundo8
 
PDF
Curso java basico
Lener Romero
 
PDF
Máxima Seguridad en WordPress
Chema Alonso
 
PDF
Code igniter guia_usuario_2.1.0
niko_afv
 
PDF
Libro Bitcoin: La tecnología Blockchain y su investigación
Chema Alonso
 
PDF
Flash cs5 help
Elserioperico
 
PDF
Índice de libro: "Empire: Hacking Avanzado en el Red Team"
Chema Alonso
 
PDF
Code igniter guia_usuario_2_0
edfabs
 
PDF
Excelvbaplication 2010
ALEX GARCIA
 
PDF
Matlab adv esp
Luis Maury
 
PDF
Índice del libro: "Python para pentesters" [2ª Edición] de 0xWord
Chema Alonso
 
PDF
Índice del libro "Hacking Web Technologies"
Chema Alonso
 
PDF
Curso java2 awt_swing
Lener Romero
 
Hacking con Python
Chema Alonso
 
Índice del libro "Machine Learning aplicado a Ciberseguridad: Técnicas y ejem...
Chema Alonso
 
Manual ofimatica v2.3
UCLA
 
Índice del libro de Windows Server 2016: Administración, Seguridad y Operaciones
Chema Alonso
 
Calculo diferencial
Pascual Onofre
 
Índice del libro "Hacking con Drones" de 0xWord
Chema Alonso
 
3 geoestadistica
edmundo8
 
Curso java basico
Lener Romero
 
Máxima Seguridad en WordPress
Chema Alonso
 
Code igniter guia_usuario_2.1.0
niko_afv
 
Libro Bitcoin: La tecnología Blockchain y su investigación
Chema Alonso
 
Flash cs5 help
Elserioperico
 
Índice de libro: "Empire: Hacking Avanzado en el Red Team"
Chema Alonso
 
Code igniter guia_usuario_2_0
edfabs
 
Excelvbaplication 2010
ALEX GARCIA
 
Matlab adv esp
Luis Maury
 
Índice del libro: "Python para pentesters" [2ª Edición] de 0xWord
Chema Alonso
 
Índice del libro "Hacking Web Technologies"
Chema Alonso
 
Curso java2 awt_swing
Lener Romero
 
Publicidad

Similar a Smarty 2.6.14 Docs (20)

PDF
programación en visual basic.net
Guiro Lin
 
PDF
manual de visual basic.net 2008
genaro martinez
 
PDF
15225891 Manual De Integracion V10
guest1b9f18d3
 
PDF
Curso java avanzado
Lener Romero
 
PDF
Joomla gran
carlesr
 
PDF
Microsoft Word Xp[1]
jaesni
 
PDF
Manual plataforma E-ducativa
veronicaAlzogaray
 
PDF
Manual de inf para negocios
David Hidalgo Arcos
 
PDF
Manual usuario publisher
Miguel Angel Ticona Alfaro
 
PDF
Manual usuario AdServer
Miguel Angel Ticona Alfaro
 
PDF
Tutorial de computación básica 2
AndreaEspinoza92
 
PDF
Manual desarrollador
ebm89
 
PDF
Manual microsoft office excel 2010
KOKO253
 
PDF
Manual microsoft office excel 2010
proneulsa
 
PDF
Manual microsoft office excel 2010
Javier Condori Flores
 
PDF
Manual microsoft office excel 2010
ANDRES SALAZAR
 
PDF
Postgres tutorial
t763rm3n
 
PDF
Openbravo para Minoristas. Descripción de la solución (RMP19)
Xavier Places Cano
 
PDF
My cool new Slideshow!
gealgaro
 
PDF
My cool new Slideshow!
gealgaro
 
programación en visual basic.net
Guiro Lin
 
manual de visual basic.net 2008
genaro martinez
 
15225891 Manual De Integracion V10
guest1b9f18d3
 
Curso java avanzado
Lener Romero
 
Joomla gran
carlesr
 
Microsoft Word Xp[1]
jaesni
 
Manual plataforma E-ducativa
veronicaAlzogaray
 
Manual de inf para negocios
David Hidalgo Arcos
 
Manual usuario publisher
Miguel Angel Ticona Alfaro
 
Manual usuario AdServer
Miguel Angel Ticona Alfaro
 
Tutorial de computación básica 2
AndreaEspinoza92
 
Manual desarrollador
ebm89
 
Manual microsoft office excel 2010
KOKO253
 
Manual microsoft office excel 2010
proneulsa
 
Manual microsoft office excel 2010
Javier Condori Flores
 
Manual microsoft office excel 2010
ANDRES SALAZAR
 
Postgres tutorial
t763rm3n
 
Openbravo para Minoristas. Descripción de la solución (RMP19)
Xavier Places Cano
 
My cool new Slideshow!
gealgaro
 
My cool new Slideshow!
gealgaro
 
Publicidad

Último (20)

PDF
Escuelas Desarmando una mirada subjetiva a la educación
ingridhurtadovalenci
 
PPTX
Doctrina 1 Soteriologuia y sus diferente
NelsonMeza9
 
PDF
COMUNICACION EFECTIVA PARA LA EDUCACION .pdf
HoracioOrtiz16
 
PDF
Híper Mega Repaso Histológico Bloque 3.pdf
danigalis07
 
DOCX
UNIDAD DE APRENDIZAJE 5 AGOSTO tradiciones
GabrielaCallupeGanoz
 
PDF
biología es un libro sobre casi todo el tema de biología
bolhfhdu
 
PDF
Atencion prenatal. Ginecologia y obsetricia
ELBAMARIELAMENDEZROD
 
PDF
DI, TEA, TDAH.pdf guía se secuencias didacticas
claudializandro6
 
PDF
Tomo 1 de biologia gratis ultra plusenmas
AxelCastillo56
 
PDF
Crear o Morir - Andres Oppenheimer Ccesa007.pdf
Demetrio Ccesa Rayme
 
PPTX
caso clínico iam clinica y semiología l3.pptx
EnriqueQuerales1
 
PDF
PFB-MANUAL-PRUEBA-FUNCIONES-BASICAS-pdf.pdf
LiliGuerraCuevas
 
PDF
TOMO II - LITERATURA.pd plusenmas ultras
AxelCastillo56
 
PDF
Metodologías Activas con herramientas IAG
Osman Villanueva
 
PDF
Educación Artística y Desarrollo Humano - Howard Gardner Ccesa007.pdf
Demetrio Ccesa Rayme
 
DOCX
V UNIDAD - SEGUNDO GRADO. del mes de agosto
MilberIta
 
PDF
Conecta con la Motivacion - Brian Tracy Ccesa007.pdf
Demetrio Ccesa Rayme
 
PPTX
Presentación de la Cetoacidosis diabetica.pptx
KevinGarcia7103
 
PPTX
AGENTES PATÓGENOS Y LAS PRINCIPAL ENFERMEAD.pptx
antonioortiz920669
 
PDF
Salvese Quien Pueda - Andres Oppenheimer Ccesa007.pdf
Demetrio Ccesa Rayme
 
Escuelas Desarmando una mirada subjetiva a la educación
ingridhurtadovalenci
 
Doctrina 1 Soteriologuia y sus diferente
NelsonMeza9
 
COMUNICACION EFECTIVA PARA LA EDUCACION .pdf
HoracioOrtiz16
 
Híper Mega Repaso Histológico Bloque 3.pdf
danigalis07
 
UNIDAD DE APRENDIZAJE 5 AGOSTO tradiciones
GabrielaCallupeGanoz
 
biología es un libro sobre casi todo el tema de biología
bolhfhdu
 
Atencion prenatal. Ginecologia y obsetricia
ELBAMARIELAMENDEZROD
 
DI, TEA, TDAH.pdf guía se secuencias didacticas
claudializandro6
 
Tomo 1 de biologia gratis ultra plusenmas
AxelCastillo56
 
Crear o Morir - Andres Oppenheimer Ccesa007.pdf
Demetrio Ccesa Rayme
 
caso clínico iam clinica y semiología l3.pptx
EnriqueQuerales1
 
PFB-MANUAL-PRUEBA-FUNCIONES-BASICAS-pdf.pdf
LiliGuerraCuevas
 
TOMO II - LITERATURA.pd plusenmas ultras
AxelCastillo56
 
Metodologías Activas con herramientas IAG
Osman Villanueva
 
Educación Artística y Desarrollo Humano - Howard Gardner Ccesa007.pdf
Demetrio Ccesa Rayme
 
V UNIDAD - SEGUNDO GRADO. del mes de agosto
MilberIta
 
Conecta con la Motivacion - Brian Tracy Ccesa007.pdf
Demetrio Ccesa Rayme
 
Presentación de la Cetoacidosis diabetica.pptx
KevinGarcia7103
 
AGENTES PATÓGENOS Y LAS PRINCIPAL ENFERMEAD.pptx
antonioortiz920669
 
Salvese Quien Pueda - Andres Oppenheimer Ccesa007.pdf
Demetrio Ccesa Rayme
 

Smarty 2.6.14 Docs

  • 1. Smarty Manual por Monte Ohrt <monte at ohrt dot com> y Andrei Zmievski <andrei@php.net>
  • 2. Smarty Manual publicado 07-09-2007 Copyright © 2001-2005 New Digital Group, Inc.
  • 3. Tabla de contenidos Prólogo .............................................................................................................................................. vi I. Iniciando .......................................................................................................................................... 1 1. Que es Smarty? ......................................................................................................................... 2 2. Instalación ................................................................................................................................ 4 Requerimentos ..................................................................................................................... 4 Instalación Básica ................................................................................................................. 4 Expandiendo la configuración ................................................................................................. 7 II. Smarty For Template Designers ........................................................................................................... 9 3. Basic Syntax ........................................................................................................................... 11 Comentarios ....................................................................................................................... 11 Variables ........................................................................................................................... 11 Funciones .......................................................................................................................... 12 Atributos ........................................................................................................................... 12 Colocando variables entre comillas dobles ............................................................................... 13 Matemáticas ....................................................................................................................... 13 Escaping Smarty Parsing ...................................................................................................... 14 4. Variables ................................................................................................................................ 15 Variables definidas desde PHP .............................................................................................. 15 Variables cargadas desde archivos de configuración ................................................................... 17 La variable reservada {$smarty} ............................................................................................ 18 5. Modificadores de variables ........................................................................................................ 21 capitalize ........................................................................................................................... 22 cat .................................................................................................................................... 22 count_characters ................................................................................................................. 23 count_paragraphs ................................................................................................................ 24 count_sentences .................................................................................................................. 24 count_words ...................................................................................................................... 25 date_format ........................................................................................................................ 25 default .............................................................................................................................. 27 escape ............................................................................................................................... 28 indent ............................................................................................................................... 29 lower ................................................................................................................................ 30 nl2br ................................................................................................................................. 30 regex_replace ..................................................................................................................... 31 replace .............................................................................................................................. 32 spacify .............................................................................................................................. 32 string_format ...................................................................................................................... 33 strip .................................................................................................................................. 34 strip_tags ........................................................................................................................... 34 truncate ............................................................................................................................. 35 upper ................................................................................................................................ 36 wordwrap .......................................................................................................................... 36 6. Combinando Modificadores ....................................................................................................... 38 7. Funciones Integradas ................................................................................................................ 39 capture .............................................................................................................................. 39 config_load ........................................................................................................................ 40 {foreach},{foreachelse} ....................................................................................................... 42 include .............................................................................................................................. 44 {include_php} .................................................................................................................... 45 insert ................................................................................................................................ 46 if,elseif,else ........................................................................................................................ 47 {ldelim},{rdelim} ............................................................................................................... 49 literal ................................................................................................................................ 50 iii
  • 4. Smarty Manual {php} ............................................................................................................................... 50 section,sectionelse ............................................................................................................... 51 {strip} ............................................................................................................................... 60 8. Custom Functions .................................................................................................................... 61 {assign} ............................................................................................................................ 61 {counter} .......................................................................................................................... 62 cycle ................................................................................................................................. 63 {debug} ............................................................................................................................ 64 {eval} ............................................................................................................................... 64 {fetch} .............................................................................................................................. 65 {html_checkboxes} ............................................................................................................. 66 {html_image} ..................................................................................................................... 68 {html_options} ................................................................................................................... 68 {html_radios} ..................................................................................................................... 70 {html_select_date} .............................................................................................................. 72 {html_select_time} .............................................................................................................. 75 {html_table} ...................................................................................................................... 79 math ................................................................................................................................. 81 {mailto} ............................................................................................................................ 82 {popup_init} ...................................................................................................................... 84 popup ............................................................................................................................... 84 {textformat} ....................................................................................................................... 88 9. Config Files ............................................................................................................................ 92 10. Debugging Console ................................................................................................................ 93 III. Smarty For Programmers ................................................................................................................. 94 11. Constantes ............................................................................................................................ 96 SMARTY_DIR .................................................................................................................. 96 SMARTY_CORE_DIR ........................................................................................................ 96 12. Clase Variables de Smarty ....................................................................................................... 97 $template_dir ..................................................................................................................... 97 $compile_dir ...................................................................................................................... 97 $config_dir ........................................................................................................................ 98 $plugins_dir ....................................................................................................................... 98 $debugging ........................................................................................................................ 98 $debug_tpl ......................................................................................................................... 98 $debugging_ctrl .................................................................................................................. 99 $autoload_filters ................................................................................................................. 99 $compile_check .................................................................................................................. 99 $force_compile ................................................................................................................... 99 $caching ............................................................................................................................ 99 $cache_dir ........................................................................................................................ 100 $cache_lifetime ................................................................................................................. 100 $cache_handler_func .......................................................................................................... 100 $cache_modified_check ...................................................................................................... 100 $config_overwrite .............................................................................................................. 100 $config_booleanize ............................................................................................................ 101 $config_read_hidden .......................................................................................................... 101 $config_fix_newlines .......................................................................................................... 101 $default_template_handler_func ........................................................................................... 101 $php_handling ................................................................................................................... 101 $security .......................................................................................................................... 102 $secure_dir ....................................................................................................................... 102 $security_settings ............................................................................................................... 102 $trusted_dir ....................................................................................................................... 103 $left_delimiter ................................................................................................................... 103 $right_delimiter ................................................................................................................. 103 $compiler_class ................................................................................................................. 103 $request_vars_order ........................................................................................................... 103 iv
  • 5. Smarty Manual $request_use_auto_globals ................................................................................................... 103 $error_reporting ................................................................................................................. 103 $compile_id ...................................................................................................................... 103 $use_sub_dirs .................................................................................................................... 104 $default_modifiers ............................................................................................................. 104 $default_resource_type ....................................................................................................... 104 13. La clase Methods() de Smarty ................................................................................................. 105 14. Cache ................................................................................................................................. 146 Configurando el Cache ........................................................................................................ 146 Multiples caches por pagina ................................................................................................. 148 Cache Groups .................................................................................................................... 149 Controlando salida de Cacheabilidad de plugins ....................................................................... 150 15. Caracteristicas Avanzadas ....................................................................................................... 152 Objetos ............................................................................................................................ 152 Prefilters .......................................................................................................................... 153 Postfilters ......................................................................................................................... 153 Filtros de salida ................................................................................................................. 154 Función manipuladora de cache ............................................................................................ 154 Recursos .......................................................................................................................... 156 16. Extendiendo Smarty con plugins .............................................................................................. 160 Como funcionan los Plugins ................................................................................................. 160 Nombres convencionales ..................................................................................................... 160 Escribiendo Plugins ............................................................................................................ 161 Funciones de Template ........................................................................................................ 161 Modificadores ................................................................................................................... 163 Block Functions ................................................................................................................. 164 Funciones Compiladoras ..................................................................................................... 165 Prefiltros/Postfiltros ............................................................................................................ 166 Filtros de Salida ................................................................................................................. 167 Fuentes ............................................................................................................................ 167 Inserts .............................................................................................................................. 169 IV. Appendixes .................................................................................................................................. 170 17. Localización de Errores .......................................................................................................... 171 Errores Smarty/PHP ........................................................................................................... 171 18. Consejos y Trucos ................................................................................................................. 173 Manipulación de Variables Vacias ......................................................................................... 173 Manipulación del valor default de una variable ........................................................................ 173 Pasando la variable titulo a la cabecera del template .................................................................. 174 Fechas ............................................................................................................................. 174 WAP/WML ...................................................................................................................... 175 Templates con Componetes .................................................................................................. 176 Ofuscando direcciones de E-mail .......................................................................................... 177 19. Fuentes ............................................................................................................................... 178 20. ERRORES ........................................................................................................................... 179 v
  • 6. Prólogo Esta es indudablemente una de las preguntas que mas se hacen en las listas de correo de PHP: Como hacer mis scripts de PHP independientes del diseño?. Mientras PHP se encarga de como "incrustar scripts en lenguaje HTML", después de escri- bir los proyectos que mezclan PHP y HTML libremente, esto trae como consecuencia la idea de separar la forma y el conte- nido, muy buena idea[TM]. En adición, en muchas compañias la interpretación de esquema es diseñador y programador por separado. Por consiguiente, la busqueda trae como solución una plantilla(template). Por ejemplo en nuestra compañia, el desarrollo de una aplicación es como sigue: Después de tener la documentación nece- saria, el diseñador de web diseña el prototipo de la interfaz y la entrega al programador. El programador implementa las re- glas de negocio en PHP y usa el prototipo para crear el "esqueleto" de la plantilla. El proyeto esta en manos de la persona responsable del HTML designer/web page que produzca la plantilla para su gloria completa. El proyecto debe ir y regresar entre programación/HTML varias veces. De esa manera, es importante para tener un buen suporte de templates porque los programadores no quieren hacer nada con HTML ni quieren diseño HTML al rededor del codigo PHP. Los diseñadores pre- cisan de soporte para archivos de configuración, bloques dinámicos y otras interfaces usadas, mas ellos no quieren ocuparse con las compejidades del lenguaje de programación PHP. Buscando, actualmente existen muchas soluciones de templates disponibles para PHP, la mayor parte de ellos les provee de una forma rudimentaria de sustitución de variables dentro del template y hace una forma limitada de la funcionalidad diná- mica del bloque. Pero nuestras necesidades requieren mas que eso. Porque no queremos programadores que no quieran tener trato con HTML del todo, pero esto puede ser casi inevitable. Por ejemplo, si un diseñador quiere alternar colores de fondo sobre bloques dinámicos, esto tuvo que trabajarse con el programador anticipadamente. Nosotros necesitamos también que los diseñadores esten capacitados para usar archivos de configuración, y colocar variables de ellos dentro de los templates. La lista continua. Nosotros empezamos escribiendo por fuera una especulación para un motor de plantillas(templates) atrasado de 1999. Des- pués de terminar la especulación, comenzamos a trabajar un motor de plantillas escrito en C que esperanzadoramente fue aceptado para ser incorporado con PHP. No solamente nos encontramos con algunas complicadas barreras tecnicas, si no también hubo acalorados debates sobre lo que exactamente debia de hacer o no un motor de plantillas. De esta experiencia, decidimos que un motor de platillas devería ser escrito en PHP como una clase, para que cualquiera lo use de la misma for- ma como ellos ven. Así nosotros escribimos un motor que es SmartTemplate ™ nunca volvio a existir(nota: esa clase nunca fue enviada al público). Esta era una clase que ralizaba casi todo lo que nosotros necesitabamos: sustitución de variables re- gulares, soporte incluso de otras plantillas, integración con archivos de configuración, incrustación de código PHP, funcio- nalidades 'if' limitada y muchos mas bloques dinámicos robustos que podrían ser anidados muchas veces. Todo esto con ex- presiones regulares y el código producido seria mejor, como diriamos nosotros, impenetrable. Eso era también notoriamente lento en grandes aplicaciones por todas las interpretaciones y expresiones regulares trabajando en cada requisición. El ma- yor problema del punto de vista de un programador era todo el trabajo necesario en el procesamiento del scripts PHP y pro- cesamiento de bloques dinámicos de la plantilla. Como hacemos eso facilmente? Entonces se origino la visión de que finalmente se convirtiera en Smarty. Nosotros sabemos que rápido es el código PHP sin las cabeceras y la interpretación de plantillas(templates). También sabemos que meticuloso y arrogante es el lenguaje PHP su poder debe ser aceptable para un diseñador, y este podría ser enmascarado con una simples sintaxis de planti- llas(templates). Entonces que pasara si nosotros convinamos las dos fuerzas? De esta manera, nacio Smarty... vi
  • 7. Parte I. Iniciando Tabla de contenidos 1. Que es Smarty? ................................................................................................................................. 2 2. Instalación ........................................................................................................................................ 4 Requerimentos ..................................................................................................................... 4 Instalación Básica ................................................................................................................. 4 Expandiendo la configuración ................................................................................................. 7 1
  • 8. Capítulo 1. Que es Smarty? Smarty es un motor de plantillas para PHP. Mas especificamente, esta herramienta facilita la manera de separar la aplicación lógica y el contenido en la presentación. La mejor descripción esta en una situación donde la aplicación del programador y la plantilla del diseñador juegan diferentes roles, o en la mayoria de los casos no la misma persona. Por ejemplo: Digamos que usted crea una pagina web, es decir, despliega el articulo de un diario. El encabezado del articu- lo, el rotulo, el autor y el cuerpo son elementos del contenido, estos no contiene información de como quieren ser presenta- dos. Estos son pasados por la aplicación Smarty, donde el diseñador edita la plantilla, y usa una combinación de etiquetas HTML y etiquetas de plantilla para formatear la presentación de estos elementos (HTML, tablas, color de fondo, tamaño de letras, hojas de estilo, etc...). Un día el programador necesita cambiar la manera de recuperar el contenido del articulo(un cambio en la aplicación lógica.). Este cambio no afectara al diseñador de la plantilla, el contenido llegara a la plantilla exac- tamente igual. De la misma manera, si el diseñador de la plantilla quiere rediseñarla en su totalidad, estos cambios no afec- taran la aplicación lógica. Por lo tanto, el programador puede hacer cambios en la aplicación lógica sin que sea necesario restructurar la plantilla. Y el diseñador de la plantilla puede hacer cambios sin que haya rompimiento con la aplicación lógi- ca. One design goal of Smarty is the separation of business logic and presentation logic. This means templates can certainly contain logic under the condition that it is for presentation only. Things such as including other templates, altering table row colors, upper-casing a variable, looping over an array of data and displaying it, etc. are all examples of presentation logic. This does not mean that Smarty forces a separation of business and presentation logic. Smarty has no knowledge of which is which, so placing business logic in the template is your own doing. Also, if you desire no logic in your templates you cer- tainly can do so by boiling the content down to text and variables only. Ahora un pequeño resumen sobre que no hace Smarty. Smarty no intenta separar completamente la lógica de la plantilla. No hay problema entre la lógica y su plantilla bajo la condición que esta lógica sea estrictamente para presentación. Un consejo: mantener la aplicación lógica fuera de la plantilla, y la presentación fuera de la aplicación lógica. Esto tiene como finalidad tener un objeto mas manipulable y escalable para un futuro proximo. Un único aspecto acerca de Smarty es la compilación de la plantilla. De esta manera Smarty lee la plantilla y crea los scripts de PHP. Una vez creados, son executados sobre él. Por consiguiente no existe ningún costo por analizar gramaticalmente cada archivo de template por cada requisición, y cada template puede llevar toda la ventaja del compilador de cache de PHP tal como Zend Accelerator (http://www.zend.com/) o PHP Accelerator (http://www.php-accelerator.co.uk). Algunas de las características de Smarty: • Es extremamente rápido. • Es eficiente ya que puede interpretar el trabajo mas sucio. • No analiza gramaticalmente desde arriba el template, solo compila una vez. • El esta atento para solo recompilar los archivos de plantilla que fueron cambiados. • Usted puede crear funciones habituales y modificadores de variables customizados, de modo que el lenguaje de la plati- lla es altamente extensible. • Sintaxis de etiquetas delimitadoras para configuración de la plantilla, así lo puede usar {}, {{}}, <!--{}-->, etc. • Los construtoress if/elseif/else/endif son pasados por el interpretador de PHP, así la sintaxis de la expresión {if ...} pue- de ser compleja o simple de la forma que usted quiera. • Permite un anidamiento ilimitado de sections, ifs, etc. • Es posible incrustar directamente codigo PHP en los archivos de plantilla, aunque esto puede no ser necesario(no reco- mendado) dado que la herramienta se puede ajustar. 2
  • 9. Que es Smarty? • Soporte de caching incrustado • Fuentes de Plantilla absoluto • Funciones habituales de manipulación de cache • Arquitectura de Plugin 3
  • 10. Capítulo 2. Instalación Tabla de contenidos Requerimentos ..................................................................................................................................... 4 Instalación Básica ................................................................................................................................. 4 Expandiendo la configuración ................................................................................................................. 7 Requerimentos Smarty Requiere un servidor web corriendo PHP 4.0.6 o posterior. Instalación Básica Instale los archivos de la libreria de Smarty que estan en el directorio de distribución /libs/. Estos son los archivos PHP que usted NO EDITARA. Estos archivos son toda las aplicaciones comunes y ellos son actualizados cuando usted actualiza a una nueva versión de Smarty. Ejemplo 2.1. Archivos de la libreria Smarty Smarty.class.php Smarty_Compiler.class.php Config_File.class.php debug.tpl /internals/*.php (all of them) /plugins/*.php (all of them) Smarty utiliza una constante de PHP llamada SMARTY_DIR que es la ruta para el directorio de la biblioteca de Smarty 'libs/'. Basicamente, si su aplicación puede encontrar el archivo Smarty.class.php , usted no necesita definir SMARTY_DIR, Smarty lo encontrará. Por consiguiente si, Smarty.class.php no esta incluido en el path, y no es abas- tecido por una ruta absoluta para encontrar su aplicación, entonces usted debe definir SMARTY_DIR manualmente. SMARTY_DIR debe incluir una barra de seguimento. Aquí esta un ejemplo de como se crea una instancia de Smarty en sus scripts PHP: Ejemplo 2.2. Creando una instancia Smarty de Smarty <?php require('Smarty.class.php'); $smarty = new Smarty; ?> Intente correr el script de arriba. Si usted obtiene un error diciendo que el archivo Smarty.class.php no fue encontrado, puedes usar una de las siguientes opciones: 4
  • 11. Instalación Ejemplo 2.3. Reemplazar por la ruta absulta de la libreria del archivo <?php require('/usr/local/lib/php/Smarty/Smarty.class.php'); $smarty = new Smarty; ?> Ejemplo 2.4. Adicionar el directorio de la libreria para incluirlo en el include_path de PHP <?php // Edite su archivo php.ini, y adicione el directorio de la libreria de Smarty // include_path y reinicie su servidor web. // Entonces lo siguiente debe funcionar: require('Smarty.class.php'); $smarty = new Smarty; ?> Ejemplo 2.5. Defina la constante SMARTY_DIR manualmente <?php define('SMARTY_DIR', '/usr/local/lib/php/Smarty/'); require(SMARTY_DIR . 'Smarty.class.php'); $smarty = new Smarty; ?> Ahora que la libreria de archivos esta en su sitio, es tiempo de configurar los directorios de Smarty para su aplicación. Smarty require cuatro directorios (por defaul) llamados 'templates/', 'templates_c/', 'configs/' y 'cache/'. Cada uno de estos son para definir las propiedades de las clases de Smarty. $template_dir, $compile_dir, $config_dir, y $cache_dir respectivamente. Es altamente recomendado que usted configure un grupo separado de estos directorios para cada aplicación que utilice de Smarty. Asegurece que usted sabe la ubicación del document root de su servidor web. En nuestro ejemplo, el document root esta en /web/www.example.com/docs/. Los directorios de Smarty solo son accesados por la libreria de Smarty y nunca son ac- cesados directamente por el navegador. Por consiguiente para evitar cualquier preocupación con la seguridad, es recomen- dado colocar estos directorios fuera del document root. Para nuestro ejemplo de instalación, configuraremos el ambiente de Smarty para una aplicación de libro de visitas. Escoje- mos una aplicación solo con el proposito de crear un directorio de nombre convencional. Usted puede usar el mismo am- biente para cualquier aplicación, solamente sustituya "guestbook" con el nombre de su aplicación. Nosotros colocaremos nuestros directorios de Smarty dentro de /web/www.example.com/smarty/guestbook/. Usted necesita tener por lo menos un archivo dentro de su document root, y que sea accesado por el navegador. Nosotros llamamos el script de 'index.php', y lo colocamos en un subdirectorio dentro del document root llamado /guestbook/. Nota Técnica: : Es conveniente configurar el servidor de forma que "index.php" pueda ser identificado como el ín- dice del directório padre, de esta manera si usted accesa http://www.example.com/guestbook/, el script index.php será ejecutado sin "index.php" ni la URL. En Apache usted puede definir el sitio adicionando "index.php" en el fi- nal de su configuración del directorio DirectoryIndex (separando cada uno con espacios.) como en el ejemplo de httpd.conf. 5
  • 12. Instalación DirectoryIndex index.htm index.html index.php index.php3 default.html index.cgi Veamos nuestra estructura de archivos hasta hora: Ejemplo 2.6. Ejemplo de estrutura de archivo /usr/local/lib/php/Smarty/Smarty.class.php /usr/local/lib/php/Smarty/Smarty_Compiler.class.php /usr/local/lib/php/Smarty/Config_File.class.php /usr/local/lib/php/Smarty/debug.tpl /usr/local/lib/php/Smarty/internals/*.php /usr/local/lib/php/Smarty/plugins/*.php /web/www.example.com/smarty/guestbook/templates/ /web/www.example.com/smarty/guestbook/templates_c/ /web/www.example.com/smarty/guestbook/configs/ /web/www.example.com/smarty/guestbook/cache/ /web/www.example.com/docs/guestbook/index.php Smarty necesitara permisos de escritura (usuarios de windows ingnorar) para $compile_dir y $cache_dir, esto garantiza que el usuario del servidor pueda escribir en ellos. Este es generalmente el usuarios "nobody" y el grupo "nobody". Para usuarios con X sistema operativo, el default es "www" y el grupo "www". Si usted esta usando Apache, puede ver en su ar- chivo httpd.conf (normalmente en "/usr/local/apache/conf/") cual es el usuario y grupo que estan siendo usados. Ejemplo 2.7. Configurando permisos de archivos chown nobody:nobody /web/www.example.com/smarty/guestbook/templates_c/ chmod 770 /web/www.example.com/smarty/guestbook/templates_c/ chown nobody:nobody /web/www.example.com/smarty/guestbook/cache/ chmod 770 /web/www.example.com/smarty/guestbook/cache/ Nota Técnica: : chmod 770 puede ser una seguridad bastante fuerte, solo le permite al usuario "nobody" y al grupo "nobody" acesso de lectura/escritura a los directorios. Si usted quiere abrir permiso de lectura a cualquiera (en la mayoria de las veces para su propia conveniencia de querer ver estos archivos), usted puede usar el 775 en lugar del 770. Nosotros necesitamos crear el archivo index.tpl, para que Smarty lo pueda cargar. Este estara localizado en su $template_dir. Ejemplo 2.8. Editando /web/www.example.com/smarty/guestbook/templates/index.tpl {* Smarty *} Hello, {$name}! Nota Técnica:: {* Smarty *} Esto es un comentario en el template. Este no es obligatorio, pero si una buena prac- tica iniciar todos sus archivos de plantilla con estos comentarios. Esto hace facilmente reconocibles a los archivos a pesar la extención del archivo. Por ejemplo, editores de texto pueden reconocer el archivo y habilitar un realce de sintaxis especial. Ahora vamos a editar el index.php. crearemos una instancia de Smarty, daremos valor a las variables del template y mostra- 6
  • 13. Instalación remos el archivo index.tpl. En el ambiente de nuestro ejemplo, "/usr/local/lib/php/Smarty" esta dentro de include_path. Ase- gurese que exista el mismo, o utilice la ruta absoluta. Ejemplo 2.9. Editando /web/www.example.com/docs/guestbook/index.php <?php // load Smarty library require('Smarty.class.php'); $smarty = new Smarty; $smarty->template_dir = '/web/www.example.com/smarty/guestbook/templates/'; $smarty->compile_dir = '/web/www.example.com/smarty/guestbook/templates_c/'; $smarty->config_dir = '/web/www.example.com/smarty/guestbook/configs/'; $smarty->cache_dir = '/web/www.example.com/smarty/guestbook/cache/'; $smarty->assign('name','Ned'); $smarty->display('index.tpl'); ?> Nota Técnica: : En nuestro ejemplo, estamos configurando rutas absolutas para todos los directorios de Smarty. Si /web/www.example.com/smarty/guestbook/ está dentro de su include_path de PHP, entonces estas declara- ciones no son necesarias. Sin embargo, esto es mas eficiente y (por experiencia) tiene menos tendencia a errores en relación a determinar las rutas absolutas. Esto garantiza que Smarty esta recibiendo los archivos del directorio que usted desea. Ahora carge el archivo index.php desde su navegador web. Usted debera ver "Hello, Ned!" Usted a completado la configuracion basica para el Smarty! Expandiendo la configuración Esta es una continuación de la instalación básica, por favor lea esta primero! Una forma un poco mas flexible de configurar el Smarty, expandir las clases e iniciar su ambiente de Smarty. Es, en vez de configurar rutas de directorios repetidamente, asigne esas mismas a variables, etc., nosotros podemos facilitar eso. Vamos a crear un nuevo directorio en "/php/includes/guestbook/" y llamemos al nuevo archivo setup.php . En nuestro ejemplo, "/ php/includes" está en nuestro include_path. Verifique que usted también lo definio, o utilice rutas absolutas de los archivos. Ejemplo 2.10. Editando /php/includes/guestbook/setup.php <?php // load Smarty library require('Smarty.class.php'); // The setup.php file is a good place to load // required application library files, and you // can do that right here. An example: // require('guestbook/guestbook.lib.php'); class Smarty_GuestBook extends Smarty { function Smarty_GuestBook() { 7
  • 14. Instalación // Class Constructor. // These automatically get set with each new instance. $this->Smarty(); $this->template_dir = '/web/www.example.com/smarty/guestbook/templates/'; $this->compile_dir = '/web/www.example.com/smarty/guestbook/templates_c/'; $this->config_dir = '/web/www.example.com/smarty/guestbook/configs/'; $this->cache_dir = '/web/www.example.com/smarty/guestbook/cache/'; $this->caching = true; $this->assign('app_name', 'Guest Book'); } } ?> Ahora vamos a modificar el archivo index.php para usar el setup.php: Ejemplo 2.11. Editando /web/www.example.com/docs/guestbook/index.php <?php require('guestbook/setup.php'); $smarty = new Smarty_GuestBook; $smarty->assign('name','Ned'); $smarty->display('index.tpl'); ?> Ahora usted vera que es completamente simple crear una instancia de Smarty, solo use Smarty_GuestBook, que automática- mente inicializa todo para nuestra aplicación. 8
  • 15. Parte II. Smarty For Template Designers Tabla de contenidos 3. Basic Syntax ................................................................................................................................... 11 Comentarios ....................................................................................................................... 11 Variables ........................................................................................................................... 11 Funciones .......................................................................................................................... 12 Atributos ........................................................................................................................... 12 Colocando variables entre comillas dobles ............................................................................... 13 Matemáticas ....................................................................................................................... 13 Escaping Smarty Parsing ...................................................................................................... 14 4. Variables ........................................................................................................................................ 15 Variables definidas desde PHP .............................................................................................. 15 Variables cargadas desde archivos de configuración ................................................................... 17 La variable reservada {$smarty} ............................................................................................ 18 5. Modificadores de variables ................................................................................................................ 21 capitalize ........................................................................................................................... 22 cat .................................................................................................................................... 22 count_characters ................................................................................................................. 23 count_paragraphs ................................................................................................................ 24 count_sentences .................................................................................................................. 24 count_words ...................................................................................................................... 25 date_format ........................................................................................................................ 25 default .............................................................................................................................. 27 escape ............................................................................................................................... 28 indent ............................................................................................................................... 29 lower ................................................................................................................................ 30 nl2br ................................................................................................................................. 30 regex_replace ..................................................................................................................... 31 replace .............................................................................................................................. 32 spacify .............................................................................................................................. 32 string_format ...................................................................................................................... 33 strip .................................................................................................................................. 34 strip_tags ........................................................................................................................... 34 truncate ............................................................................................................................. 35 upper ................................................................................................................................ 36 wordwrap .......................................................................................................................... 36 6. Combinando Modificadores ............................................................................................................... 38 7. Funciones Integradas ........................................................................................................................ 39 capture .............................................................................................................................. 39 config_load ........................................................................................................................ 40 {foreach},{foreachelse} ....................................................................................................... 42 include .............................................................................................................................. 44 {include_php} .................................................................................................................... 45 insert ................................................................................................................................ 46 if,elseif,else ........................................................................................................................ 47 {ldelim},{rdelim} ............................................................................................................... 49 literal ................................................................................................................................ 50 {php} ............................................................................................................................... 50 section,sectionelse ............................................................................................................... 51 {strip} ............................................................................................................................... 60 9
  • 16. Smarty For Template Designers 8. Custom Functions ............................................................................................................................ 61 {assign} ............................................................................................................................ 61 {counter} .......................................................................................................................... 62 cycle ................................................................................................................................. 63 {debug} ............................................................................................................................ 64 {eval} ............................................................................................................................... 64 {fetch} .............................................................................................................................. 65 {html_checkboxes} ............................................................................................................. 66 {html_image} ..................................................................................................................... 68 {html_options} ................................................................................................................... 68 {html_radios} ..................................................................................................................... 70 {html_select_date} .............................................................................................................. 72 {html_select_time} .............................................................................................................. 75 {html_table} ...................................................................................................................... 79 math ................................................................................................................................. 81 {mailto} ............................................................................................................................ 82 {popup_init} ...................................................................................................................... 84 popup ............................................................................................................................... 84 {textformat} ....................................................................................................................... 88 9. Config Files .................................................................................................................................... 92 10. Debugging Console ........................................................................................................................ 93 10
  • 17. Capítulo 3. Basic Syntax Tabla de contenidos Comentarios ....................................................................................................................................... 11 Variables ........................................................................................................................................... 11 Funciones .......................................................................................................................................... 12 Atributos ........................................................................................................................................... 12 Colocando variables entre comillas dobles ............................................................................................... 13 Matemáticas ....................................................................................................................................... 13 Escaping Smarty Parsing ...................................................................................................................... 14 Todas las etiquetas del template deben estar marcadas por delimitadores. Por default , estos delimitadores son { y }, sino es- tos pueden cambiar. Para estos ejemplos, nosotros asumiremos que usted está usando los delimitadores por default. En Smarty, todo el contenido fuera de los delimitadores es mostrado como contenido estatico, o igual(sin cambios). Cuando Smarty encuentra etiquetas en el template, trata de interpretarlos, e intenta mostrar la salida apropiada en su lugar. Comentarios Los comentarios en los templates son cercados por asteriscos, y por los delimitadores, así: {* este es un comentario *}. Los comentarios en Smarty no son mostrados en la salida final del template. semejantes a <!-- HTML comments --> Estos son usados para hacer notas internas dentro del template. Ejemplo 3.1. Comentarios <body> {* this multiline comment is not sent to browser *} {* include the header file here *} {include file="header.tpl"} {* Dev note: $includeFile is assigned foo.php script *} <!-- this html comment is sent to browser --> {include file=$includeFile} {include file=#includeFile#} {* display dropdown lists *} <select name="company"> {html_options options=$vals selected=$selected_id} </select> </body> Variables Las variable de Template que comiencen con signo de pesos. Pueden contener números, letras y guiones bajos, muy pareci- 11
  • 18. Basic Syntax do a las variables de PHP [http://php.net/language.variables]. Usted también puede hacer referencia a arreglos que puden ser numericos o no-numericos. También puede hacer referencia a métodos y propiedades de objetos. Config file variables es una excepción de la sintaxis del signo de pesos. También puede ser referenciado entre #signos de numeros#, o con la varia- ble especial $smarty.config. Ejemplo 3.2. Variables {$foo} <-- displaying a simple variable (non array/object) {$foo[4]} <-- display the 5th element of a zero-indexed array {$foo.bar} <-- display the "bar" key value of an array, similar to PHP $foo['bar'] {$foo.$bar} <-- display variable key value of an array, similar to PHP $foo[$bar] {$foo->bar} <-- display the object property "bar" {$foo->bar()} <-- display the return value of object method "bar" {#foo#} <-- display the config file variable "foo" {$smarty.config.foo} <-- synonym for {#foo#} {$foo[bar]} <-- syntax only valid in a section loop, see {section} {assign var=foo value="baa"}{$foo} <-- displays "baa", see {assign} Many other combinations are allowed {$foo.bar.baz} {$foo.$bar.$baz} {$foo[4].baz} {$foo[4].$baz} {$foo.bar.baz[4]} {$foo->bar($baz,2,$bar)} <-- passing parameters {"foo"} <-- static values are allowed Vea también $smarty reserved variables y Config Variables. Funciones Cada etiqueta Smarty muestra una variable o utiliza algún tipo de función. Las funciones son procesadas y mostradas colo- cando los atributos de la función entre delimitadores, así: {funcname attr1="val" attr2="val"}. Ejemplo 3.3. Sintaxis de Funciones {config_load file="colors.conf"} {include file="header.tpl"} {if $highlight_name} Welcome, <font color="{#fontColor#}">{$name}!</font> {else} Welcome, {$name}! {/if} {include file="footer.tpl"} Las funciones internas y las funciones habituales, ambas deben tener la misma sintaxis dentro del template. Las funciones internas que funcionan en Smarty, son: {if}, {section} y {strip}. Estas no pueden ser modificadas. Las funciones habituales son funciones adicionales implementadas por plugins. Estas si pueden ser modificadas como usted quiera, o usted también puede adicionar nuevas. {html_options} y {popup} son ejemplos de funciones habituales. Atributos 12
  • 19. Basic Syntax La mayoria de las funciones llevan atributos que especifican o cambian su funcionamiento. Los atributos para las funciones de Smarty son muy parecidos a los atributos de HTML. Los valores estaticos no necesitan estar entre comillas, pero si es re- comendado para cadenas y literales. Las variables también pueden ser usadas y no precisamente estando entre comillas. Algunos atributos requieren valores boleanos(true o false). Estos pueden ser especificados como cualquier otro valor sin co- millas true, on, y yes, o false, off, y no. Ejemplo 3.4. Sintaxis de atributos de Funciones {include file="header.tpl"} {include file="header.tpl" attrib_name="attrib value"} {include file=$includeFile} {include file=#includeFile# title="Smarty is cool"} {html_select_date display_days=yes} <select name="company"> {html_options options=$choices selected=$selected} </select> Colocando variables entre comillas dobles Smarty puede reconocer variables asignadas entre comillas aunque estas solo tengan números, letras, guiones bajos y cor- chetes[]. Con cualquier otro carácter(puntos, referencia de objetos, etc.) las variables deben estar entre apostrofos. Usted no puede incrustar modificadores, Estos deben ser siempre aplicados fuera de las comillas. Ejemplo 3.5. Sintaxis entre comillas SYNTAX EXAMPLES: {func var="test $foo test"} <-- sees $foo {func var="test $foo_bar test"} <-- sees $foo_bar {func var="test $foo[0] test"} <-- sees $foo[0] {func var="test $foo[bar] test"} <-- sees $foo[bar] {func var="test $foo.bar test"} <-- sees $foo (not $foo.bar) {func var="test `$foo.bar` test"} <-- sees $foo.bar {func var="test `$foo.bar` test"|escape} <-- modifiers outside quotes! PRACTICAL EXAMPLES: {include file="subdir/$tpl_name.tpl"} <-- will replace $tpl_name with value {cycle values="one,two,`$smarty.config.myval`"} <-- must have backticks Ver también escape. Matemáticas Las matemáticas pueden ser aplicadas directamente al los valores de las variables. Ejemplo 3.6. Ejemplos de matemáticas {$foo+1} 13
  • 20. Basic Syntax {$foo*$bar} {* some more complicated examples *} {$foo->bar-$bar[1]*$baz->foo->bar()-3*7} {if ($foo+$bar.test%$baz*134232+10+$b+10)} {$foo|truncate:"`$fooTruncCount/$barTruncFactor-1`"} {assign var="foo" value="`$foo+$bar`"} Ver también la función{math}. Escaping Smarty Parsing En algunas ocaciones es deseable o hasta necesario que Smarty tenga que ingonar sections o algun otro tipo analisis de sin- taxis. Un ejemplo clasico es con el codigo JavaScript o CSS incrustado en el template. El problema se origina cuando aque- llos lenguajes que utilizan los caracteres { y } los cuales son también los delimitadores por default para Smarty. Esta puede ser una simple situación separando enteramente su codigo JavaScript y CSS dentro de un archivo personal y uti- lizar el metodo standar del HTML para el acceso. Es posible usar literal incluyendo el contenido del bloque {literal} .. {/literal}. Similar a usar entidades HTML, usted puede usar {ldelim},{rdelim} o {$smarty.ldelim} para mostrar los delimitadores actuales. Esto a menudo es conveniente para cambios simples a Smarty's $left_delimiter y $right_delimiter. Ejemplo 3.7. Ejemplo cambiando delimitadores <?php $smarty = new Smarty; $smarty->left_delimiter = '<!--{'; $smarty->right_delimiter = '}-->'; $smarty->assign('foo', 'bar'); $smarty->display('example.tpl'); ?> Donde example.tpl es: <script language="javascript"> var foo = <!--{$foo}-->; function dosomething() { alert("foo is " + foo); } dosomething(); </script> Ver También escape modifier 14
  • 21. Capítulo 4. Variables Tabla de contenidos Variables definidas desde PHP .............................................................................................................. 15 Variables cargadas desde archivos de configuración ................................................................................... 17 La variable reservada {$smarty} ............................................................................................................ 18 Smarty tiene varios tipos diferentes de variables. El tipo de variable depende de cual simbolo este prefijado(incluido den- tro). Las variables de Smarty no pueden ser mostradas directamente o usadas como argumentos para atributos, funciones y modi- ficadores, dentro de expresiones condicionales, etc. Para mostrar una variable, simplesmente coloque esta entre delimitado- res siendo esta la única cosa entre ellos. Ejemplos: {$Name} {$Contacts[row].Phone} <body bgcolor="{#bgcolor#}"> Variables definidas desde PHP Las variables que son asignadas desde PHP son referenciadas precedidas estas con una señal de cifrado $. Las variables de- finidas dentro del template como una función assign también son mostradas de esta manera. Ejemplo 4.1. variables definidas php script <?php $smarty = new Smarty; $smarty->assign('firstname', 'Doug'); $smarty->assign('lastname', 'Evans'); $smarty->assign('meetingPlace', 'New York'); $smarty->display('index.tpl'); ?> Donde el contenido de index.tpl es: Hello {$firstname} {$lastname}, glad to see you can make it. <br /> {* this will not work as $vars are case sensitive *} This weeks meeting is in {$meetingplace}. {* this will work *} This weeks meeting is in {$meetingPlace}. esta es la salida: 15
  • 22. Variables Hello Doug Evans, glad to see you can make it. <br /> This weeks meeting is in . This weeks meeting is in New York. Arreglos asociativos Usted también puede referenciar matrices asociativas en variables que son definidas desde PHP especificando la clave des- pués del simbolo '.'(punto). Ejemplo 4.2. Accesando variables de matriz asociativa <?php $smarty->assign('Contacts', array('fax' => '555-222-9876', 'email' => 'zaphod@slartibartfast.com', 'phone' => array('home' => '555-444-3333', 'cell' => '555-111-1234') ) ); $smarty->display('index.tpl'); ?> Donde el contenido de index.tpl es: {$Contacts.fax}<br /> {$Contacts.email}<br /> {* you can print arrays of arrays as well *} {$Contacts.phone.home}<br /> {$Contacts.phone.cell}<br /> esta es la salida: 555-222-9876<br /> zaphod@slartibartfast.com<br /> 555-444-3333<br /> 555-111-1234<br /> Índices de Matrices Usted podra referencia matrizes por su índice, muy semejantes a la sintaxis de PHP. Ejemplo 4.3. Accesando matrices por sus índices <?php $smarty->assign('Contacts', array( '555-222-9876', 'zaphod@slartibartfast.com', array('555-444-3333', '555-111-1234') )); $smarty->display('index.tpl'); ?> 16
  • 23. Variables Donde index.tpl es: {$Contacts[0]}<br /> {$Contacts[1]}<br /> {* you can print arrays of arrays as well *} {$Contacts[2][0]}<br /> {$Contacts[2][1]}<br /> esta es la salida: 555-222-9876<br /> zaphod@slartibartfast.com<br /> 555-444-3333<br /> 555-111-1234<br /> Objects Las propiedades de los objetos definidos desde PHP pueden ser referenciados especificando el nombre de la propiedad des- pués del simbolo '->'. Ejemplo 4.4. Accesando propiedades de los Objetos name: {$person->name}<br /> email: {$person->email}<br /> esta es la salida: name: Zaphod Beeblebrox<br /> email: zaphod@slartibartfast.com<br /> Variables cargadas desde archivos de configura- ción Las variables que son cargadas de archivos de configuración son referenciadas incluyendo entre ellas el signo(#), o como variables de Smarty $smarty.config. La segunda sintaxis es util para incrustar valores de un atributo dentro de comillas. Ejemplo 4.5. Variables de configuración foo.conf: pageTitle = "This is mine" bodyBgColor = "#eeeeee" tableBorderSize = "3" tableBgColor = "#bbbbbb" rowBgColor = "#cccccc" index.tpl: {config_load file="foo.conf"} <html> <title>{#pageTitle#}</title> 17
  • 24. Variables <body bgcolor="{#bodyBgColor#}"> <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> <tr bgcolor="{#rowBgColor#}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> index.tpl: (sintaxis alternativa) {config_load file="foo.conf"} <html> <title>{$smarty.config.pageTitle}</title> <body bgcolor="{$smarty.config.bodyBgColor}"> <table border="{$smarty.config.tableBorderSize}" bgcolor="{$smarty.config.tableBgColor}"> <tr bgcolor="{$smarty.config.rowBgColor}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> esta es la salida de ambos ejemplos: <html> <title>This is mine</title> <body bgcolor="#eeeeee"> <table border="3" bgcolor="#bbbbbb"> <tr bgcolor="#cccccc"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> Las variables de un archivo de configuración no pueden ser usadas hasta después de que son cargadas por los archivos de configuración. Este procedimento es explicado posteriormente en este documento en {config_load}. Ver también Variables y $smarty reserved variables La variable reservada {$smarty} La variable reservada {$smarty} puede ser utilizada para accesar a variables especiales del template. A continuación una lis- ta completa. Solicitud de Variables La solicitud de variables [http:/ / php.net/ reserved.variables] como $_GET, $_POST, $_COOKIE, $_SERVER, $_ENV y $_SESSION (Ver $request_vars_order y $request_use_auto_globals) pueden ser accesadas como se muestra en los ejem- plos de abajo: Ejemplo 4.6. Mostrando solicitud de variables 18
  • 25. Variables {* display value of page from URL (GET) http://www.domain.com/index.php?page=foo *} {$smarty.get.page} {* display the variable "page" from a form (POST) *} {$smarty.post.page} {* display the value of the cookie "username" *} {$smarty.cookies.username} {* display the server variable "SERVER_NAME" *} {$smarty.server.SERVER_NAME} {* display the system environment variable "PATH" *} {$smarty.env.PATH} {* display the php session variable "id" *} {$smarty.session.id} {* display the variable "username" from merged get/post/cookies/server/env *} {$smarty.request.username} nota: Por historicas razones {$SCRIPT_NAME} puede ser accesado directamente sin embargo {$smarty.server.SCRIPT_NAME} es el sugerido para accesar este valor. {$smarty.now} El timestamp [http://php.net/function.time] actual puede ser accesado con {$smarty.now}. El número refleja el número de segundos pasados desde la llamada Epoca (1 de Enero de 1970) y puede ser pasado directamente para el modificador da- te_format para mostrar la fecha. Ejemplo 4.7. Usando {$smarty.now} {* utilice el modificador date_format para mostrar la fecha y hora actual *} {$smarty.now|date_format:"%Y-%m-%d %H:%M:%S"} {$smarty.const} Usted puede accesar al valor de constantes PHP directamente. Ver también smarty constants Ejemplo 4.8. Usando {$smarty.const} {$smarty.const._MY_CONST_VAL} {$smarty.capture} La salida capturada via {capture}..{/capture} puede ser accesada usando la variable {$smarty}. vea la sección {capture} pa- ra un ejemplo. {$smarty.config} La variable {$smarty} puede ser usada para referir variables de configuración cargadas. {$smarty.config.foo} es un sinóni- 19
  • 26. Variables mo para {#foo#}. vea la sección sobre {config_load} para un ejemplo. {$smarty.section}, {$smarty.foreach} La variable {$smarty} puede ser usada para hacer referencia a las propiedades 'section' y 'foreach' del loop. Ver la documen- tación sobre section y foreach. {$smarty.template} Esta variable contiene el nombre actual del template que esta siendo procesado. {$smarty.version} Esta variable contiene la versión Smarty con que es compilado el template. {$smarty.ldelim}, {$smarty.rdelim} Esta variable es usada para imprimir literalmente el valor left-delimiter y right-delimiter. Ver tambien {ldelim},{rdelim}. Ver también Variables y Config Variables 20
  • 27. Capítulo 5. Modificadores de variables Tabla de contenidos capitalize ........................................................................................................................................... 22 cat .................................................................................................................................................... 22 count_characters ................................................................................................................................. 23 count_paragraphs ................................................................................................................................ 24 count_sentences .................................................................................................................................. 24 count_words ...................................................................................................................................... 25 date_format ........................................................................................................................................ 25 default .............................................................................................................................................. 27 escape ............................................................................................................................................... 28 indent ............................................................................................................................................... 29 lower ................................................................................................................................................ 30 nl2br ................................................................................................................................................. 30 regex_replace ..................................................................................................................................... 31 replace .............................................................................................................................................. 32 spacify .............................................................................................................................................. 32 string_format ...................................................................................................................................... 33 strip .................................................................................................................................................. 34 strip_tags ........................................................................................................................................... 34 truncate ............................................................................................................................................. 35 upper ................................................................................................................................................ 36 wordwrap .......................................................................................................................................... 36 Los modificadores de variables pueden ser aplicados a variables, funciones habituales o cadenas. Para aplicar un modifica- dor, especifique el valor seguido por |(pipe) y el nombre del modificador. Un modificador necesita parámetros adicionales que afetan en su funcionamento. Estos parámetros siguen al nombre del modificador y son separados por : (dos puntos). Ejemplo 5.1. Ejemplo de modificador {* apply modifier to a variable *} {$title|upper} {* modifier with parameters *} {$title|truncate:40:"..."} {* apply modifier to a function parameter *} {html_table loop=$myvar|upper} {* with parameters *} {html_table loop=$myvar|truncate:40:"..."} {* apply modifier to literal string *} {"foobar"|upper} {* using date_format to format the current date *} {$smarty.now|date_format:"%Y/%m/%d"} {* apply modifier to a custom function *} {mailto|upper address="me@domain.dom"} Si usted aplica un modificador a una matriz en lugar del valor de una variable, el modificador va a ser aplicado en cada uno de los valores de la matriz. Si usted realmente quisiera que el modificador funcionara en una matriz entera, debe colocar el 21
  • 28. Modificadores de variables simbolo @ antes del nombre del modificador, así como: {$articleTitle|@count} (esto mostrara el número de elemen- tos de la matriz $articleTitle.) Los modificadores pueden ser cargados automáticamente a partir de su $plugins_dir (vea también: Naming Conventions) o pueden ser registrados explicitamente (vea: register_modifier). Adicionalmente, todas las funciones de php pueden ser utili- zadas como modificadores implicitamente. (El ejemplo @count de arriba usa actualmente la función count de php y no un modificador de Smarty). Usar funciones de php como modificadores tiene dos pequeños problemas: Primero, algunas veces al ordenar los parámetros de una función esto no es aconsejable ({"%2.f"|sprintf:$float} actualmente funciona, pero existe algo mas intuitivo Por ejemplo: {$float|string_format:"%2.f"} que es proporcionado con la distribución de Smarty). Segundo: con $security activado, todas las funciones de php que sean utilizadas como modificadores deben ser de- claradas como variables de una matriz $security_settings['MODIFIER_FUNCS'] . Ver también register_modifier(), register_function(), Extending Smarty with plugins y modifiers, capitalize Posicion del Parame- Tipo Requerido Default Descripción tro 1 boolean No false Este determina que pa- labra con digitos no de- be ser convertida Este es usado para convertir a mayuscula la primera letra de todas la palabras de una variable. Ejemplo 5.2. capitalize <?php $smarty->assign('articleTitle', 'next x-men film, x3, delayed.'); ?> Donde el template es: {$articleTitle} {$articleTitle|capitalize} {$articleTitle|capitalize:true} Esta es la salida: next x-men film, x3, delayed. Next X-Men Film, x3, Delayed. Next X-Men Film, X3, Delayed. Ver también lower upper cat Posiscion del Parame- Tipo Requerido cat Descripción tro 1 string No empty Este es el valor para concatenar con la va- 22
  • 29. Modificadores de variables Posiscion del Parame- Tipo Requerido cat Descripción tro riable dada. Este valor es concatenado con la variable dada. Ejemplo 5.3. cat <?php $smarty->assign('articleTitle', "Psychics predict world didn't end"); ?> Donde el template es: {$articleTitle|cat:" yesterday."} Esta es la salida: Psychics predict world didn't end yesterday. count_characters Posición del Parame- Tipo Requerido Default Descripción tro 1 boolean No false Este determina cuando incluir o no los espa- cios en blanco al con- tar. Este es usado para contar el número de carácteres en una variable. Ejemplo 5.4. count_characters <?php $smarty->assign('articleTitle', 'Cold Wave Linked to Temperatures.'); ?> Donde el template es: {$articleTitle} {$articleTitle|count_characters} {$articleTitle|count_characters:true} esta es la salida: Cold Wave Linked to Temperatures. 29 23
  • 30. Modificadores de variables 33 ver también count_words, count_sentences y count_paragraphs. count_paragraphs Este es usado para contar el número de parrafos en la variable. Ejemplo 5.5. count_paragraphs <?php $smarty->assign('articleTitle', "War Dims Hope for Peace. Child's Death Ruins Couple's Holiday.nn Man is Fatally Slain. Death Causes Loneliness, Feeling of Isolation." ); ?> Donde el template es: {$articleTitle} {$articleTitle|count_paragraphs} Esta es la salida: War Dims Hope for Peace. Child's Death Ruins Couple's Holiday. Man is Fatally Slain. Death Causes Loneliness, Feeling of Isolation. 2 ver también count_characters, count_sentences y count_words. count_sentences Este es usado para contar el número de frases en la variable. Ejemplo 5.6. count_sentences <?php $smarty->assign('articleTitle', 'Two Soviet Ships Collide - One Dies. Enraged Cow Injures Farmer with Axe.' ); ?> Donde el template es: {$articleTitle} {$articleTitle|count_sentences} 24
  • 31. Modificadores de variables esta es la salida: Two Soviet Ships Collide - One Dies. Enraged Cow Injures Farmer with Axe. 2 ver también count_characters, count_paragraphs y count_words. count_words Este es usado para contar el número de palabras en la variable. Ejemplo 5.7. count_words <?php $smarty->assign('articleTitle', 'Dealers Will Hear Car Talk at Noon.'); ?> Donde el template es: {$articleTitle} {$articleTitle|count_words} esta es la salida: Dealers Will Hear Car Talk at Noon. 7 ver también count_characters, count_paragraphs y count_sentences. date_format Posición del Parame- Tipo Requerido Default Descripción tro 1 string No %b %e, %Y Este es el formato para la fecha mostrada. 2 string No n/a Este es el default de la fecha si el valor de en- trada es vacio. Estos formatos de fecha y hora estan dentro del formato determinado strftime() [http://php.net/strftime]. Las fechas pueden ser pasadas a Smarty como timestamps [http:/ / php.net/ function.time] unix, timestamps mysql, o como cualquier cadena compuesta de mes dia año (pasada por strtotime() [http://php.net/strtotime]). El diseñador puede usar entonces date_format para tener un control completo del formateo de la fecha. Si la fecha pasada para date_format estuviera vacia y un segundo parámetro fuera pasado, este será usado como la fecha a formatear. Ejemplo 5.8. date_format 25
  • 32. Modificadores de variables <?php $smarty->assign('yesterday', strtotime('-1 day')); ?> Where template is (uses $smarty.now): {$smarty.now|date_format} {$smarty.now|date_format:"%D"} {$smarty.now|date_format:"%I:%M %p"} {$yesterday|date_format} {$yesterday|date_format:"%A, %B %e, %Y"} {$yesterday|date_format:"%H:%M:%S"} This will output: Feb 6, 2001 02/06/01 02:33 pm Feb 5, 2001 Monday, February 5, 2001 14:33:00 date_format especificadores de conversión: • %a - nombre del día de la semana abreviado de acuerdo al local actual • %A - nombre del día de la semana anterior de acuerdo al local actual • %b - nombre del mes abreviado de acuerdo al local actual • %B - nombre del mes anterior de acuerdo al local actual • %c - Representación preferencial de la fecha y hora local actual • %C - año con dos dígitos (o año dividido por 100 y truncadopara un entero, intervalo de 00 a 99) • %d - día del mes como un número decimal (intervalo de 00 a 31) • %D - Lo mismo que %m/%d/%y • %e - Día del mes como un número decimal, un único dígito y precedido por un espacio (intervalo de 1 a 31) • %g - Año basado en la semana, sin el siglo [00,99] • %G - Año basado en la semana, incluyendo el siglo [0000,9999] • %h - Lo mismo que %b • %H - Hora como un número decimal usando un relój de 24 horas (intervalo de 00 a 23) • %I - Hora como un número decimal usando un relój de 12 horas (intervalo de 01 a 12) • %j - Día del año como um número decimal (intervalo de 001 a 366) • %k - Hora (relój de 24 horas) digítos únicos que son precedidos por un espacio en blanco (intervalo de 0 a 23) • %l - Hora como un número decimal usando un relój de 12 horas, digítos únicos son precedidos por un espacio en blanco 26
  • 33. Modificadores de variables (intervalo de 1 a 12) • %m - Mes como número decimal (intervalo de 01 a 12) • %M - Minuto como un número decimal • %n - Caracter de nueva linea • %p - Cualquiera `am' o `pm' de acuerdo con el valor de la hora dado, o la cadena correspondiente a la local actual • %r - Hora con notación a.m. y p.m. • %R - Hora con notación de 24 horas • %S - Segundo como número decimal • %t - Caracter tab • %T - Hora actual, igual a %H:%M:%S • %u - Día de la semana como un número decimal [1,7], representando con 1 el lunes • %U - Número de la semana del año actual como un número decimal, comenzando con el primer domingo como primer dia de la primera semana • %V - Número de la semana del año actual como número decimal de acuerdo con el ISO 8601:1988, intervalo de 01 a 53, en donde 1 es la primera semana que tenga por lo menos cuatro dias en el año actual, siendo domingo el primer dia de la semana. • %w - Día de la semana como decimal, siendo domingo 0 • %W - Número de la semana del año actual como número decimal, comenzando con el primer lunes como primer dia de la primera semana • %x - Representación preferida para la fecha local actual sin la hora • %X - Representación preferida de la hora local actual sin la fecha • %y - Año como número decimal sin el siglo(intervalo de 00 a 99) • %Y - Año como número decimal incluyendo el siglo • %Z - Zona horaria, o nombre, o abreviación • %% - Un carácter `%' NOTA PARA PROGRAMADORES:: date_format es escencialmente una envoltura para la función strftime() [http://php.net/strftime] de PHP. Usted debera tener mas o menos especificadores de conversiones disponibles de acuerdo con la función strftime() [http:/ / php.net/ strftime] del sistema operacional en donde PHP fue compilado. Cheque en la pagina del manual de su sistema una lista completa de especificadores validos. Ver también $smarty.now, php function strftime() [http://php.net/strftime], {html_select_date} y date tips. default 27
  • 34. Modificadores de variables Pocisión del Parame- Tipo Requerido Default Descripción tro 1 string No empty Este es el valor por de- fecto para mostrar una variable que estuviera vacia. Este es usado para definir un valor por defecto para una variable. Si esta variable estuviera vacia o no estuviera definida, el valor por defecto es mostrado. El valor por defecto es usado como argumento. Ejemplo 5.9. default <?php $smarty->assign('articleTitle', 'Dealers Will Hear Car Talk at Noon.'); ?> Donde el template es: {$articleTitle|default:"no title"} {$myTitle|default:"no title"} Esta es la salida: Dealers Will Hear Car Talk at Noon. no title Ver también Default Variable Handling y Blank Variable Handling. escape Posición del Para- Tipo Requerido Posibles Valores Default Description metro 1 string No html,htmlall,url,qu html Este es el formato otes,hex,hexentity,j de escape a utilizar. avascript Este es usado para escapar html, url, comillas simples para escapar una variable que no este escapada, escapar hex, hexen- tity o javascript. Por default, la variable html es escapada. Ejemplo 5.10. escape <?php $smarty->assign('articleTitle', "'Stiff Opposition Expected to Casketless Funeral Plan'" ); ?> 28
  • 35. Modificadores de variables Donde el template es: {$articleTitle} {$articleTitle|escape} {$articleTitle|escape:"html"} {* escapes & " ' < > *} {$articleTitle|escape:"htmlall"} {* escapes ALL html entities *} {$articleTitle|escape:"url"} {$articleTitle|escape:"quotes"} <a href="mailto:{$EmailAddress|escape:"hex"}">{$EmailAddress|escape:"hexentity"}</a> esta es la salida: 'Stiff Opposition Expected to Casketless Funeral Plan' &#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; &#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; &#039;Stiff Opposition Expected to Casketless Funeral Plan&#039; %27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27 'Stiff Opposition Expected to Casketless Funeral Plan' <a href="mailto:%62%6f%..snip..%65%74">&#x62;&#x6f;&#x62..snip..&#x65;&#x74;</a> Ver también Escaping Smarty Parsing y Obfuscating E-mail Addresses. indent Posición del Parame- Tipo requerido Default Descripción tro 1 integer No 4 Este defíne con cuantos carácteres endentar. 2 string No (un espacio) Este defíne cual carác- ter va a ser usado para endentar. Esta endenta una cadena en cada linea, el default es 4. Como parámetro opcional, usted puede especificar el número de ca- rácteres para endentar. Como segundo parámetro opcional, usted puede especificar el carácter que desea usar para endentar. (Use "t" para tabs.) Ejemplo 5.11. indent <?php $smarty->assign('articleTitle', 'NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25.' ); ?> Donde el template es: {$articleTitle} {$articleTitle|indent} {$articleTitle|indent:10} 29
  • 36. Modificadores de variables {$articleTitle|indent:1:"t"} esta es la salida: NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25. NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25. NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25. NJ judge to rule on nude beach. Sun or rain expected today, dark tonight. Statistics show that teen pregnancy drops off significantly after 25. ver también strip y spacify. lower Esta es usada para convertir a minúsculas una variable. Ejemplo 5.12. lower <?php $smarty->assign('articleTitle', 'Two Convicts Evade Noose, Jury Hung.'); ?> Donde el template es: {$articleTitle} {$articleTitle|lower} esta es la salida: Two Convicts Evade Noose, Jury Hung. two convicts evade noose, jury hung. ver también upper y Capitalize. nl2br Todos los saltos de linea seran convertidos a etiquetas <br /> como datos de la variable. Esto equivale a la función nl2br() [http://php.net/nl2br] de PHP. Ejemplo 5.13. nl2br 30
  • 37. Modificadores de variables <?php $smarty->assign('articleTitle', "Sun or rain expectedntoday, dark tonight" ); ?> Donde el template es: {$articleTitle|nl2br} esta debe ser la salida: Sun or rain expected<br />today, dark tonight Ver también word_wrap, count_paragraphs y count_sentences. regex_replace Posición del Parame- Tipo requerido Default Descripción tro 1 string Si n/a Esta es la expresión re- gular a ser substituida. 2 string Si n/a Esta es la cadena que sustituira a la expresión regular. Localiza una expresión regular y la remplaza en la variable. Use la sintaxis para preg_replace() [http://php.net/preg_replace] del manual de PHP. Ejemplo 5.14. regex_replace <?php $smarty->assign('articleTitle', "Infertility unlikely tonbe passed on, experts say."); ?> Donde index.tpl es: {* replace each carriage return, tab and new line with a space *} {$articleTitle} {$articleTitle|regex_replace:"/[rtn]/":" "} Esta es la salida: Infertility unlikely to be passed on, experts say. Infertility unlikely to be passed on, experts say. 31
  • 38. Modificadores de variables Vea también replace y escape. replace Posición del Parame- Tipo Requerido Default Descripción tro 1 string Si n/a Esta es la cadena a ser substituida. 2 string Si n/a Esta es la cadena que ira a substituir. Una simple busqueda y substituir en la variable. Esta es equivalente a la función str_replace() [http://php.net/str_replace] de PHP. Ejemplo 5.15. replace <?php $smarty->assign('articleTitle', "Child's Stool Great for Use in Garden."); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|replace:"Garden":"Vineyard"} {$articleTitle|replace:" ":" "} Esta es la Salida: Child's Stool Great for Use in Garden. Child's Stool Great for Use in Vineyard. Child's Stool Great for Use in Garden. ver también regex_replace y escape. spacify Posición del Parame- Tipo Requerido Default Descripción tro 1 string No one space Este se inserta entre ca- da carácter de la varia- ble. Inserta un espacio entre cada carácter de una variable. Usted puede opcionalmente pasar un carácter (o una cadena) diferen- te para insertar. Ejemplo 5.16. spacify 32
  • 39. Modificadores de variables <?php $smarty->assign('articleTitle', 'Something Went Wrong in Jet Crash, Experts Say.'); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|spacify} {$articleTitle|spacify:"^^"} Esta es la Salida: Something Went Wrong in Jet Crash, Experts Say. S o m e t h i n g W e n t W r o n g i n J e t C r a s h , E x p e r t s S a y . S^^o^^m^^e^^t^^h^^i^^n^^g^^ ^^W^^e^^n^^t^^ ^^W^^r^^o^^n^^g^^ ^^i^^n^^ ^^J^^e^^t^^ ^^C^^r^^a^^s^^h^^,^^ Ver también wordwrap y nl2br. string_format Posición del Parame- Tipo Requerido Default Descripción tro 1 string Si n/a Este es el formato que debera usar. (sprintf) Esta es una manera de formatear cadenas, como números decimales y otros. Use la sintaxis de sprintf [http://php.net/sprintf] para formatearlo. Ejemplo 5.17. string_format <?php $smarty->assign('number', 23.5787446); ?> Donde index.tpl es: {$number} {$number|string_format:"%.2f"} {$number|string_format:"%d"} Esta es la Salida: 23.5787446 23.58 24 Ver también date_format. 33
  • 40. Modificadores de variables strip Este substituye todos los espacios repetidos, nuevas lineas y tabs por un unico espacio u otra cadena indicada. Nota: Si usted quiere substituir bloques de texto de un template use la función {strip}. Ejemplo 5.18. strip <?php $smarty = new Smarty; $smarty->assign('articleTitle', "Grandmother ofneight makest hole in one."); $smarty->display('index.tpl'); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|strip} {$articleTitle|strip:"&nbsp;"} Esta es la Salida: Grandmother of eight makes hole in one. Grandmother of eight makes hole in one. Grandmother&nbsp;of&nbsp;eight&nbsp;makes&nbsp;hole&nbsp;in&nbsp;one. strip_tags Posición del Parame- Tipo Requerido Default descripción tro 1 bool No true Este determina cuando las etiquetas seran rem- plazadas por ' ' o por '' Este retira las etiquetas de marcación, basicamente todo entre < y >. Ejemplo 5.19. strip_tags <?php $smarty->assign('articleTitle', "Blind Woman Gets <font face="helvetica">New Kidney</font> from Dad she Hasn't Seen in <b>years</b>."); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|strip_tags} {* same as {$articleTitle|strip_tags:true} *} {$articleTitle|strip_tags:false} 34
  • 41. Modificadores de variables Esta es la Salida: Blind Woman Gets <font face="helvetica">New Kidney</font> from Dad she Hasn't Seen in <b>years</b>. Blind Woman Gets New Kidney from Dad she Hasn't Seen in years . Blind Woman Gets New Kidney from Dad she Hasn't Seen in years. truncate Posición del Parame- Tipo Requerido Default Desdcripción tro 1 integer No 80 Este determina para cuantos carácteres trun- car. 2 string No ... Este es el texto para adicionar si el trunca- miento ocurre. La lon- gitud NO se incluye pa- ra la logitud del trunca- miento 3 boolean No false Este determina cuando truncar o no o al final de una palabra(false), o un carácter exac- to(true). 3 boolean No false Este determina cuando ocurre el truncamiento al final de la cade- na(false), o en el centro de la cadena(true). No- ta cuando este es true, entonces la palabra li- mite es ignorada. Este trunca la variable en una cantidad de cacarteres, el default es 80. Como segundo parámetro opcional, usted puede espe- cificar una cadena para mostrar al final si la variable fue truncada. Los carácteres en la cadena son incluidos tamando el ori- ginal para el truncamiento. Por default, truncate intentara cortar al final de una palabra. Se usted quisiera cortar una cantidad exacta de carácteres, pase el tercer parámetro, que es opcional, como true. Ejemplo 5.20. truncate <?php $smarty->assign('articleTitle', 'Two Sisters Reunite after Eighteen Years at Checkout Counter.'); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|truncate} {$articleTitle|truncate:30} {$articleTitle|truncate:30:""} {$articleTitle|truncate:30:"---"} 35
  • 42. Modificadores de variables {$articleTitle|truncate:30:"":true} {$articleTitle|truncate:30:"...":true} Esta es la Salida: Two Sisters Reunite after Eighteen Years at Checkout Counter. Two Sisters Reunite after Eighteen Years at Checkout Counter. Two Sisters Reunite after... Two Sisters Reunite after Two Sisters Reunite after--- Two Sisters Reunite after Eigh Two Sisters Reunite after E... upper Este es usado para convertir a mayusculas una variable. Ejemplo 5.21. upper <?php $smarty->assign('articleTitle', "If Strike isn't Settled Quickly it may Last a While."); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|upper} Esta es la Salida: If Strike isn't Settled Quickly it may Last a While. IF STRIKE ISN'T SETTLED QUICKLY IT MAY LAST A WHILE. Ver también lower y capitalize. wordwrap Posición del Parame- Tipo Requerido Default Descripción tro 1 integer No 80 Este determina en cuantas columnas cor- tar. 2 string No n Esta es la cadena usada para cortar. 3 boolean No false Este determina cuando cortar o no, o al final de una palabra(false), o en un carácter exac- to(true). 36
  • 43. Modificadores de variables Este wordwrap corta una cadena para un ancho de columna, el default es 80. Como segundo parámetro opcional, usted pue- de especificar la cadena que será usada para cortar el texto para la próxima linea (el default es un retorno de carro n). Por default, (wordwrap) intentara cortar al final de una palabra. Si usted quisiera cortar un tamaño exacto de cacarteres, pase al tercer parámetro, que es opcional, como true. Este es equivalente a la función wordwrap() [http:/ / php.net/ wordwrap] de PHP. Ejemplo 5.22. wordwrap <?php $smarty->assign('articleTitle', "Blind woman gets new kidney from dad she hasn't seen in years."); ?> Donde index.tpl es: {$articleTitle} {$articleTitle|wordwrap:30} {$articleTitle|wordwrap:20} {$articleTitle|wordwrap:30:"<br />n"} {$articleTitle|wordwrap:30:"n":true} Esta es la Salida: Blind woman gets new kidney from dad she hasn't seen in years. Blind woman gets new kidney from dad she hasn't seen in years. Blind woman gets new kidney from dad she hasn't seen in years. Blind woman gets new kidney<br /> from dad she hasn't seen in<br /> years. Blind woman gets new kidney from dad she hasn't seen in years. Ver También nl2br y {textformat}. 37
  • 44. Capítulo 6. Combinando Modificadores Usted puede aplicar cualquier cantidad de modificadores para una variable. Estos seran aplicados en el orden en el que fue- ron combinados, de izquierda a derecha. Estos deben ser separados con el carácter |(pipe). Ejemplo 6.1. Combinando Modificadores <?php $smarty->assign('articleTitle', 'Smokers are Productive, but Death Cuts Efficiency.'); ?> Donde el template es: {$articleTitle} {$articleTitle|upper|spacify} {$articleTitle|lower|spacify|truncate} {$articleTitle|lower|truncate:30|spacify} {$articleTitle|lower|spacify|truncate:30:". . ."} La salida del ejemplode arriba: Smokers are Productive, but Death Cuts Efficiency. S M O K E R S A R ....snip.... H C U T S E F F I C I E N C Y . s m o k e r s a r ....snip.... b u t d e a t h c u t s... s m o k e r s a r e p r o d u c t i v e , b u t . . . s m o k e r s a r e p. . . 38
  • 45. Capítulo 7. Funciones Integradas Tabla de contenidos capture .............................................................................................................................................. 39 config_load ........................................................................................................................................ 40 {foreach},{foreachelse} ....................................................................................................................... 42 include .............................................................................................................................................. 44 {include_php} .................................................................................................................................... 45 insert ................................................................................................................................................ 46 if,elseif,else ........................................................................................................................................ 47 {ldelim},{rdelim} ............................................................................................................................... 49 literal ................................................................................................................................................ 50 {php} ............................................................................................................................................... 50 section,sectionelse ............................................................................................................................... 51 {strip} ............................................................................................................................................... 60 Smarty cuenta con varias funciones integradas. Las funciones Integradas forman parte del lenguaje del template. Usted no puede crear funciones personalizadas con el mismo nombre, ni puede modificar las funciones integradas. capture Nombre del Atributo Tipo Requerido Default Descripción name string no default El nombre del bloque capturado assign string No n/a El nombre de la varia- ble para dar valor a la salida capturada {capture} es usado para recolectar toda la salida del template en una variable en lugar de mostrarla. Cualquier contenido en- tre {capture name="foo"} y {/capture} es recoletado en una variable especificada y el atributo name. El contenido capturado puede ser usado en el template a partir de la variable especial $smarty.capture.foo en donde foo es el valor pasado para el atributo name. Si usted no pasa un atributo name, entonces será usado "default". Todos lo comandos {capture} deben estar entre {/capture}. Usted puede anidar(colocar uno dentro de otro) comandos capture. Nota Tecnica: Smarty 1.4.0 - 1.4.4 coloca el contenido capturado dentro de la variable llamada $return. A partir de 1.4.5, este funcionamento fue cambiado para usar el atributo name, entonces en consecuencia actualice sus templa- tes. Atención Tenga cuidado cuando capture la salida del comando {insert}. Si tuviera activo el cache y tuviera comandos {insert} y usted espera que funcione con contenido de cache, no se capturara este contenido. Ejemplo 7.1. capturando contenido de template {* no queremos imprimir la fila de la tabla a menos que exista 39
  • 46. Funciones Integradas contenido para desplegar *} {capture name=banner} {include file="get_banner.tpl"} {/capture} {if $smarty.capture.banner ne ""} <tr> <td> {$smarty.capture.banner} </td> </tr> {/if} Ver También $smarty.capture, {eval}, {fetch}, fetch() y {assign}. config_load Nombre del Atributo Tipo Requerido Default Descripción file string Si n/a El nombre del archivo de configuración a in- cluir section string No n/a El nombre de la sec- ción a cargar scope string no local Como el scope carga las variables debe ser tratado de manera lo- cal, como padre y no como global. local indi- ca que las variables son cargadas en el contexto del template local. pa- rent indica que las va- riables son cargadas en el contexto actual y en el template que llamo. global indica que las variables estan disponi- bles para todos los tem- plates. global boolean No No Cuando las variables no son vistas en el tem- plate padre (al que lla- mo este), lo mismo que scope=parent. NOTA: este atributo esta obso- leto pero el atributo scope, puede dar el so- porte. Si scope es el in- dicado, este valor es ig- norado. Esta función es usada para cargar las #variables# de un archivo de configuración dentro de un template. Vea Config Files para mayor información. 40
  • 47. Funciones Integradas Ejemplo 7.2. Función {config_load} ejemplo.conf #this is config file comment # global variables pageTitle = "Main Menu" bodyBgColor = #000000 tableBgColor = #000000 rowBgColor = #00ff00 #customer variables section [Customer] pageTitle = "Customer Info" y el template {config_load file="example.conf"} <html> <title>{#pageTitle#|default:"No title"}</title> <body bgcolor="{#bodyBgColor#}"> <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> <tr bgcolor="{#rowBgColor#}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> Los archivos de configuración pueden contener secciones también. Usted puede cargar variables de una sección adicionando el atributo 'section'. nota: Config file sections es la función integrada de template {section} no tiene nada que ver uno con el otro, ellos justamente por casualidad tiene en común el convensionalismo del nombre. Ejemplo 7.3. Función config_load con section {config_load file="ejemplo.conf" section="Customer"} <html> <title>{#pageTitle#}</title> <body bgcolor="{#bodyBgColor#}"> <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}"> <tr bgcolor="{#rowBgColor#}"> <td>First</td> <td>Last</td> <td>Address</td> </tr> </table> </body> </html> Vea también Config files, Config variables, $config_dir, get_config_vars() y config_load(). 41
  • 48. Funciones Integradas {foreach},{foreachelse} Nombre del Atributo Tipo Requerido Default Descripción from array Si n/a El nombre de la matriz a la que usted estara pegando los elementos item string Si n/a El nombre de la varia- ble que es el elemento actual key string No n/a El nombre de la varia- ble que es la llave ac- tual name string No n/a El nombre del ciclo fo- reach para acessar a las propiedades del foreach Los ciclos(loop) foreach son una alternativa para loop {section}. foreach es usado para pegar cada elemento de una matriz asociativa simple. La sintaxis para foreach es mucho mas simple que section, pero tiene una desventaja de que solo puede ser usada en una única matriz. La etiqueta foreach debe tener su par /foreach. Los parámetros requeridos son from e item. El nombre del ciclo(loop) foreach puede ser cualquier cosa que usted quiera, hecho de letras, números y subrayados. Los ci- clos(loop) foreach pueden ser anidados, y el nombre de los ciclos(loop) anidados debe ser diferente uno de otro. La variable from (normalmente una matriz de valores) determina el número de veces del ciclo(loop) foreach. foreachelse y ejecutando cuando no hubieren mas valores en la variable from. Ejemplo 7.4. foreach <?php $arr = array( 1001,1002,1003); $smarty->assign('custid', $arr); ?> {* este ejemplo muestra todos los valores de la matriz $custid *} {foreach from=$custid item=curr_id} id: {$curr_id}<br /> {/foreach} Esta es la salida del ejemplo de arriba: id: 1000<br /> id: 1001<br /> id: 1002<br /> Ejemplo 7.5. foreach key // La llave contiene la llave para cada valor del ciclo(loop) //asignacion fisica de esta manera: <?php $smarty->assign('contacts', array( array('phone' => '1', 'fax' => '2', 'cell' => '3'), array('phone' => '555-4444', 'fax' => '555-3333', 42
  • 49. Funciones Integradas 'cell' => '760-1234') )); ?> {foreach name=outer item=contact from=$contacts} <hr /> {foreach key=key item=item from=$contact} {$key}: {$item}<br /> {/foreach} {/foreach} Esta es la salida del ejemplo de arriba: <hr /> phone: 1<br /> fax: 2<br /> cell: 3<br /> <hr /> phone: 555-4444<br /> fax: 555-3333<br /> cell: 760-1234<br /> Ejemplo 7.6. Ejemplo de {foreach} - con base de datos (eg PEAR o ADODB) <?php $sql = 'select contact_id, name, nick from contacts order by contact'; $smarty->assign("contacts", $db->getAssoc($sql)); ?> {foreach key=cid item=con from=$contacts} <a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br /> {/foreach} El ciclo(Loop) foreach también tiene sus propias variables para manipular las propiedades del foreach. Estas son indicadas así: {$smarty.foreach.foreachname.varname} con foreachname siendo el nombre especificado del atributo name del foreach. Ver {section} para ejemplos ide las propiedades bajo las cuales son identicos. iteration iteration es usado para mostrar la interación actual del ciclo(loop). iteration siempre comienza en 1 incrementado en uno ca- da interación. first first Toma el valor true si la interación actual del foreach es la primera. last last Toma el valor de true si la interación actual del foreach es la ultima. show 43
  • 50. Funciones Integradas show Es usado como parámetro para el foreach. show Es un valor booleano, true o false. Si es false, el foreach no será mos- trado. Si tuviera un foreachelse presente, este será alternativamente mostrado. total total Es usado para mostrar el número de interaciones del foreach. Este puede ser usado dentro o después de el. Ver tambien {section} y $smarty.foreach. include Nombre del Atributo Tipo requerido Default Descripción file string Si n/a El nombre del archivo de template a Incluir. assign string No n/a El nombre de una va- riable que contendra to- da la salida del templa- te. [var ...] [var type] No n/a Variable para pasar lo- calmente a el template Las etiquetas {include} son usadas para incluir otros templates en el template actual. Cualquier variable disponible en el template actual, también esta disponible dentro del template incluido. La etiqueta {include} debe tener el atributo "file", el cual contiene la ruta del archivo a incluir. Usted puede opcionalmente pasar el atributo 'assign', el cual especificara el nombre de una variable de template para el cual contendra toda la salida de {include} en vez de mostrarla. Ejemplo 7.7. funcion {include} <html> <head> <title>{$title}</title> </head> <body> {include file="page_header.tpl"} {* el cuerpo del template va aqui *} {include file="/$tpl_name.tpl"} <-- will replace $tpl_name with value {include file="page_footer.tpl"} </body> </html> Usted también puede pasar variables al template incluidas como atributos. Cualquier variable pasada al template incluidas como atributos estan disponibles solamente dentro el espacio del template. Las variables pasadas como atributos sobreescri- ben a las variables del template actual, en el caso en el que estas tengan el mismo nombre. Ejemplo 7.8. Función {include} pasando variables {include file="header.tpl" title="Main Menu" table_bgcolor="#c0c0c0"} 44
  • 51. Funciones Integradas {* el cuerpo del template va aqui *} {include file="footer.tpl" logo="http://my.example.com/logo.gif"} Donde header.tpl puede ser <table border='1' width='100%' bgcolor='{$table_bgcolor|default:"#0000FF"}'> <tr><td> <h1>{$title}</h1> </td></tr> </table> Ejemplo 7.9. {include} y asignacion de variables En este ejemplo asignan el contenido de nav.tpl en la variable $navbar, entonces la salida hasta arriba y hasta abajo de pagi- na. <body> {include file="nav.tpl" assign="navbar"} {include file="header.tpl" title="Main Menu" table_bgcolor="#c0c0c0"} {$navbar} {* el cuerpo del template va aqui *} {include file="footer.tpl" logo="http://my.example.com/logo.gif"} {$navbar} </body> Use la sintaxis de template resources para incluir archivos fuera del directorio $template_dir. Ejemplo 7.10. Ejemplos de recursos para la función include {* ruta absoluta *} {include file="/usr/local/include/templates/header.tpl"} {* ruta absoluta (lo mismo) *} {include file="file:/usr/local/include/templates/header.tpl"} {* ruta absoluta de windows (DEBE usar el prefijo "file:") *} {include file="file:C:/www/pub/templates/header.tpl"} {* incluir a partir del recurso de template denominado "db" *} {include file="db:header.tpl"} ver también {include_php}, {php}, Template Resources y Componentized Templates. {include_php} Nombre del Atributo Tipo Requerido Default Descripción file string Si n/a El nombre del archivo php a incluir once boolean No true Cuando incluir o no el archivo php mas de una 45
  • 52. Funciones Integradas Nombre del Atributo Tipo Requerido Default Descripción vez, ser incluido varias veces assign string No n/a El nombre de la varia- ble que recibirá la sali- da del archivo php Nota técnica: {include_php} es muy desaprovechado desde Smarty, usted puede lograr la misma funcionalidad por medio de las funciones de costumbre del template. La unica razón para usar {include_php} es si usted en reali- dad tiene la necesidad de poner en cuarentena la funcion de php fuera del directorio de plugins y su codigo de la aplicación. Vea un ejemplo de templates componentizados para detalles. Las etiquetas {include_php} son usadas para incluir un script PHP dentro de su template. Si la seguridad estuviera activada, entonces el script PHP debe estar localizado en la ruta $trusted_dir. La etiqueta include_php debe tener el atributo "file", el cual contiene la ruta del archivo PHP a ser incluido, o el relativo al $trusted_dir, o una ruta absoluta. Por default, los archivos son incluidos solo una vez a un cuando son incluidos varias veces en el template. Usted puede es- pecificar que este sea incluido todas la veces con un atributo once. Definindo como false incluira el script php cada vez que este sea incluido en el template. Usted puede opcionalmente pasar el atributo assign, el cual especificara una variable del template la cual contendra toda la salida del {include_php} en vez de mostrarla. El objeto smarty esta disponible como $this dentro del script php que usted incluyo. Ejemplo 7.11. funcion {include_php} load_nav.php <?php // carga variables de una base de datos mysql y defíne esta para el template require_once("MySQL.class.php"); $sql = new MySQL; $sql->query("select * from site_nav_sections order by name",SQL_ALL); $this->assign('sections',$sql->record); ?> Donde index.tpl es: {* ruta absoluta o relativa del $trusted_dir *} {include_php file="/path/to/load_nav.php"} {foreach item="curr_section" from=$sections} <a href="{$curr_section.url}">{$curr_section.name}</a><br /> {/foreach} Ver también {include}, {php}, {capture}, Template Resources y Componentized Templates insert Nombre del Atributo Tipo Requerido Default Descripción name string Si n/a El nombre de la fun- ción in- 46
  • 53. Funciones Integradas Nombre del Atributo Tipo Requerido Default Descripción sert(insert_name) assign string No n/a El nombre de la varia- ble del template que re- cibirá la salida script string No n/a El nombre de un php que será incluido antes que la función insert sea llamada [var ...] [var type] No n/a Variable para pasar a la función insert La etiqueta funciona parecido a las etiquetas {include}, excepto que las etiquetas insert no van para el cache cuando caching esta activado. Esta sera executada a cada invocación del template. Digamos que usted tiene un template con un banner en la parte de arriba de la pagina. El banner puede contener cualquier mezcla de HTML, imagenes, flash, etc. Así nosotros no podemos usar una liga(link) estatica aquí, y nosotros no queremos que este el contenido oculto con la pagina. Aquí vemos la etiqueta {insert}: el template conoce los valores #banner_location_id# y #site_id# (obtenidos de un archivo de configuración), y necesita llamar una función para obtener el contenido del banner. Ejemplo 7.12. función {insert} {* ejemplo de traer un banner *} {insert name="getBanner" lid=#banner_location_id# sid=#site_id#} En este ejemplo, nosotros estamos usando el nombre "getBanner" y pasando los parámetros #banner_location_id# y #site_id#. El Smarty lo buscara en la función llamada insert_getBanner() en su aplicación PHP, pasando los valores de #banner_location_id# y #site_id# como primer argumento en una matriz asociativa. Todos los nombres de las funciones in- sert en su aplicación deben ser precedidas por "insert_" para prevenir posibles problemas con nombres de funciones repeti- dos. Su función insert_getBanner() debe hacer algo con los valores pasados y retornar los resultados. Estos resultados son mostrados en el template en lugar de la etiqueta insert. En este ejemplo, el Smarty llamara esta función: in- sert_getBanner(array("lid" => "12345","sid" => "67890")); y mostrara el resultado retornado en el lugar de la etiqueta in- sert. Si usted proporciona el atributo "assign", la salida de la etiqueta {insert} será dada a esta variable en vez de ser una salida en el template. Nota: definir la salida a una variable no es util cuando el cache esta habilitado. Si usted proporciona el atributo "script", este script php será incluido (solo una vez) antes de la ejecución de la función {insert}. Este es el caso donde la función insert no exista todavia, y el script php debe ser incluido antes para que pueda fun- cionar. La ruta puede ser absuluta o relativa a $trusted_dir. Cuando la seguridad esta activada, el script debe estar en $trusted_dir. El objeto Smarty es pasado como segundo argumento. De este modo puede referenciar y modificar información del objeto Smarty dentro de la función. Nota Tecnica: Es posible tener partes del template fuera de la cache. Si usted tuviera caching activado, la etiqueta insert no podra heredar por la cache. Esta sera ejecutada dinámicamente cada vez que la pagina sea creada, igual con paginas en cache. Esto funciona bien para cosas como banners, encuestas, clima, busqueda de resultados, areas de opinión de usuario, etc. if,elseif,else 47
  • 54. Funciones Integradas Los comandos {if} del Smarty tiene mucho de la flexibilidad del comando if [http://php.net/if] de php, con algunas adiciones para la herramienta de template. Todo {if} debe tener su {/if}. {else} y {elseif} también son permitidos. Toda las condiciona- les de PHP son reconcidas, tal como ||, or, &&, and, etc. La siguiente es una lista de calificadores reconocidos, los cuales deberan estar separados los dos elementos por espacios. Nota loas articulos pueden listarse [entre corchetes] es opcional. Equivalentes al lugar donde se apliquen en PHP. Calificador Alternativa Ejemplo de Sintaxis Significado == eq $a eq $b Iguales != ne, neq $a neq $b Diferentes > gt $a gt $b Mayor que < lt $a lt $b menor que >= gte, ge $a ge $b mayor que o igual <= lte, le $a le $b menor que o igual === $a === 0 Igual e indentico ! not not $a negación (unary) % mod $a mod $b modulo is [not] div by $a is not div by 4 divisible por is [not] even $a is not even [not] es numero par (unary) is [not] even by $a is not even by $b agrupar niveles pares [not] is [not] odd $a is not odd [not] el numero es impar (unary) is [not] odd by $a is not odd by $b [not] agrupa los niveles impa- res Ejemplo 7.13. sentencia if {if $name eq "Fred"} Welcome Sir. {elseif $name eq "Wilma"} Welcome Ma'am. {else} Welcome, whatever you are. {/if} {* Un ejemplo con "or" logico *} {if $name eq "Fred" or $name eq "Wilma"} ... {/if} {* El mismo que arriba *} {if $name == "Fred" || $name == "Wilma"} ... {/if} {* La siguiente sintaxis no funcionara, el calificador de condición deben estar separados entre ellos por espacios *} {if $name=="Fred" || $name=="Wilma"} ... {/if} {* los parentesis son permitidos *} {if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#} ... 48
  • 55. Funciones Integradas {/if} {* Usted también puede colocar funciones de PHP *} {if count($var) gt 0} ... {/if} {* checa si el valor es par o impar *} {if $var is even} ... {/if} {if $var is odd} ... {/if} {if $var is not odd} ... {/if} {* checa si la variable var es divisible por 4 *} {if $var is div by 4} ... {/if} {* Checa si la variable var es igual, agrupandola por dos. i.e., 0=even, 1=even, 2=odd, 3=odd, 4=even, 5=even, etc. *} {if $var is even by 2} ... {/if} {* 0=even, 1=even, 2=even, 3=odd, 4=odd, 5=odd, etc. *} {if $var is even by 3} ... {/if} {ldelim},{rdelim} {ldelim} y {rdelim} son usados para escapar delimitadores en el template, en nuestro caso "{" or "}". Usted puede usar solo {literal}{/literal} para escapar bloques de texto. Vea tambien {$smarty.ldelim}. Ejemplo 7.14. {ldelim}, {rdelim} {* Esto mostrara los delimitadores del template *} {ldelim}funcname{rdelim} is how functions look in Smarty! La salida del ejemplo de arriba: {funcname} is how functions look in Smarty! Otros ejemplos con algunos javascript <script language="JavaScript"> function foo() {ldelim} ... code ... {rdelim} </script> esta es la salida <script language="JavaScript"> 49
  • 56. Funciones Integradas function foo() { .... code ... } </script> Vea también Escaping Smarty Parsing literal Las etiquetas literal permiten que un block de datos sea tomado literalmente, no siendo interpretado por el smarty. Esto es generalmente utilizado alrededor de bloques javascript o stylesheet, en donde pueden haber sintaxis delimitadoras que pue- dan interferir con el template. Cualquer cosa dentro de las etiquetas {literal}{/literal} no es interpretado, si no desplegado tal como esta. Si usted necesita en su template etiquetas incrustadas en su bloque de literal, considere usar {ldelim}{rdelim} para escapar delimitadores individuales en lugar de eso. Ejemplo 7.15. Etiqueta literal {literal} <script type="text/javascript"> <!-- function isblank(field) { if (field.value == '') { return false; } else { document.loginform.submit(); return true; } } // --> </script> {/literal} Ver también Escaping Smarty Parsing. {php} Las etiquetas {php} permiten a suetdd incrustar código php directamente en el template. No será escapado, no importando la definición de $php_handling. Esto es solo para usuario avanzados y normalmente no es necesario. Ejemplo 7.16. Etiqueta {php} {php} // incluyendo un script php // directamente en el template. include("/path/to/display_weather.php"); {/php} Nota técnica: Para poder tener acceso a las variables de PHP puede ser necesario usar la palabra clave global [http://php.net/global] de PHP. 50
  • 57. Funciones Integradas ver También $php_handling, {include_php}, {include} y Componentized Templates. section,sectionelse Nombre del Atributo Tipo Requerido Default Descripción name string Si n/a El nombre de la section loop mixed Si n/a El nombre de la varia- ble para determinar el número de iteracciones start integer No 0 La posición del índice de la section donde va a comenzar. Si el valor es negativo, la posición del inicio se calculara a partir del final de la matriz. Por ejemplo, si hubieran 7 valores en la matriz y comienza por - 2, el índice inicial es 5. Valores inválidos (valores fuera del tama- ño de la matriz) son au- tomáticamente trunca- dos para el valor valido mas próximo. step integer No 1 El valor del step que sera usado para el loop de la matriz. Por ejem- plo, step=2 realizara el loop con los índices 0,2,4, etc. Si step es ne- gativo, este avanzara en la matriz de atras para adelante. max integer No n/a Defíne el número má- ximo de ciclos(loops) para la section. show boolean No true Determina cuando mostrar o no esta sec- ción Las section del template son usada para realizar un ciclo(loop) de un arreglo de datos. (al agiual que un {foreach}). Todas las etiquetas section deben tener su par /section. Los parámetros requeridos son name y loop. El nombre de la section puede ser el que usted quiera, formado por letras, números y subrayados. Las sections pueden ser anidadas, y los nombres de la section anidadas deben ser diferentes unos de otros. Las variables del loop (normalmente una matriz de valores) determina el número de veces del loop de la section. Cuando estuviera mostrando una variable dentro de una section, el nombre de la section debe estar al lado de la variable dentro de corchetes []. sectionelse es ejecutado cuando no hubiera valores para la variable del loop(ciclo). Ejemplo 7.17. section <?php 51
  • 58. Funciones Integradas $data = array(1000,1001,1002); $smarty->assign('custid',$data); ?> {* this example will print out all the values of the $custid array *} {section name=customer loop=$custid} id: {$custid[customer]}<br /> {/section} <hr /> {* print out all the values of the $custid array reversed *} {section name=foo loop=$custid step=-1} {$custid[foo]}<br /> {/section} The above example will output: id: 1000<br /> id: 1001<br /> id: 1002<br /> <hr /> id: 1002<br /> id: 1001<br /> id: 1000<br /> Otro par de ejemplos sin un arreglo asignado. {section name=foo start=10 loop=20 step=2} {$smarty.section.foo.index} {/section} <hr /> {section name=bar loop=21 max=6 step=-2} {$smarty.section.bar.index} {/section} Esta es la salida del ejemplo de arriba: 10 12 14 16 18 <hr /> 20 18 16 14 12 10 Ejemplo 7.18. loop(ciclo) de la variable section <?php $id = array(1001,1002,1003); $smarty->assign('custid',$id); $fullnames = array('John Smith','Jack Jones','Jane Munson'); $smarty->assign('name',$fullnames); $addr = array('253 N 45th', '417 Mulberry ln', '5605 apple st'); $smarty->assign('address',$addr); ?> {* la variable del loop solo determina el número de veces del ciclo. Usted puede accesar a cualquier variable del template dentro de la section. Este ejemplo asume que $custid, $name y $address son todas matrizes 52
  • 59. Funciones Integradas conteniendo el mismo número de valores *} {section name=customer loop=$custid} id: {$custid[customer]}&lt;br&gt; name: {$name[customer]}&lt;br&gt; address: {$address[customer]}&lt;br&gt; &lt;p&gt; {/section} La salida del ajemplo de arriba: <p> id: 1000<br /> name: John Smith<br /> address: 253 N 45th </p> <p> id: 1001<br /> name: Jack Jones<br /> address: 417 Mulberry ln </p> <p> id: 1002<br /> name: Jane Munson<br /> address: 5605 apple st </p> Ejemplo 7.19. Nombres de section {* El nombre de la section puede ser el que usted quiera, y es usado para referenciar los datos dentro de una section *} {section name=anything loop=$custid} <p> id: {$custid[anything]}<br /> name: {$name[anything]}<br /> address: {$address[anything]} </p> {/section} Ejemplo 7.20. sections anidadas <?php $id = array(1001,1002,1003); $smarty->assign('custid',$id); $fullnames = array('John Smith','Jack Jones','Jane Munson'); $smarty->assign('name',$fullnames); $addr = array('253 N 45th', '417 Mulberry ln', '5605 apple st'); $smarty->assign('address',$addr); $types = array( array( 'home phone', 'cell phone', 'e-mail'), array( 'home phone', 'web'), array( 'cell phone') ); $smarty->assign('contact_type', $types); $info = array( 53
  • 60. Funciones Integradas array('555-555-5555', '666-555-5555', 'john@myexample.com'), array( '123-456-4', 'www.example.com'), array( '0457878') ); $smarty->assign('contact_info', $info); ?> {* Las sections pueden ser anidados tan profundamente como usted quiera. Con las sections anidadas, usted puede accesar a estructuras complejas, como una matriz multi-dimensional. En este ejemplo, $contact_type[customer] es una matriz de tipos de contacto para el cliente actual. *} {section name=customer loop=$custid} <hr> id: {$custid[customer]}<br /> name: {$name[customer]}<br /> address: {$address[customer]}<br /> {section name=contact loop=$contact_type[customer]} {$contact_type[customer][contact]}: {$contact_info[customer][contact]}<br /> {/section} {/section} la salida del ejemplo de arriba: <hr> id: 1000<br /> name: John Smith<br /> address: 253 N 45th<br /> home phone: 555-555-5555<br /> cell phone: 666-555-5555<br /> e-mail: john@myexample.com<br /> <hr> id: 1001<br /> name: Jack Jones<br /> address: 417 Mulberry ln<br /> home phone: 123-456-4<br /> web: www.example.com<br /> <hr> id: 1002<br /> name: Jane Munson<br /> address: 5605 apple st<br /> cell phone: 0457878<br /> Ejemplo 7.21. sections y matrices asociativas <?php $data = array( array('name' => 'John Smith', 'home' => '555-555-5555', 'cell' => '666-555-5555', 'email' => 'john@myexample.com'), array('name' => 'Jack Jones', 'home' => '777-555-5555', 'cell' => '888-555-5555', 'email' => 'jack@myexample.com'), array('name' => 'Jane Munson', 'home' => '000-555-5555', 'cell' => '123456', 'email' => 'jane@myexample.com') ); $smarty->assign('contacts',$data); ?> {* Este es un ejemplo que muestra los datos de una matriz asociativa dentro de una section *} 54
  • 61. Funciones Integradas {section name=customer loop=$contacts} <p> name: {$contacts[customer].name}<br /> home: {$contacts[customer].home}<br /> cell: {$contacts[customer].cell}<br /> e-mail: {$contacts[customer].email} </p> {/section} Esta es la salida del ejemplo de arriba: <p> name: John Smith<br /> home: 555-555-5555<br /> cell: 666-555-5555<br /> e-mail: john@myexample.com </p> <p> name: Jack Jones<br /> home phone: 777-555-5555<br /> cell phone: 888-555-5555<br /> e-mail: jack@myexample.com </p> <p> name: Jane Munson<br /> home phone: 000-555-5555<br /> cell phone: 123456<br /> e-mail: jane@myexample.com </p> Ejemplo usando una base de datos(eg usando Pear o Adodb) <?php $sql = 'select id, name, home, cell, email from contacts'; $smarty->assign('contacts',$db->getAll($sql) ); ?> {* salida de la base de datos, resultado en una tabla *} <table> <tr><th>&nbsp;</th><th>Name></th><th>Home</th><th>Cell</th><th>Email</th></tr> {section name=co loop=$contacts} <tr> <td><a href="view.php?id={$contacts[co].id}">view<a></td> <td>{$contacts[co].name}</td> <td>{$contacts[co].home}</td> <td>{$contacts[co].cell}</td> <td>{$contacts[co].email}</td> <tr> {/section} </table> Ejemplo 7.22. {sectionelse} {* sectionelse se ejecutara si no hubieran valores en $custid *} {section name=customer loop=$custid} id: {$custid[customer]}<br /> {sectionelse} there are no values in $custid. {/section} 55
  • 62. Funciones Integradas Las sections también tiene sus propias variables que manipulan las propiedades de section. Estas son indicadas asi: {$smarty.section.sectionname.varname} nota: NOTA: a partir de Smarty 1.5.0, la sintaxis de las variables de las propiedades de section ha sido cambiadas de {%sectionname.varname%} a {$smarty.section.sectionname.varname}. La sintaxis antigua es aun soportada, pero usted puede ver la referencia de la sintaxis nueva en los ejemplos del manual. index index es usado para mostrar el índice actual del cliclo(loop), comenzando en cero (o comienza con el atributo dado), e incre- mentando por uno (o por un atributo de paso dado). Nota Tecnica: Si las propiedades de paso y comienzo del section son modificadas, entonces estas funcionan igual a las propiedades de iteration de la section, exepto que comienzan en 0 en vez de 1. Ejemplo 7.23. {section} propiedades del index {* FYI, $custid[customer.index] y $custid[customer] are identical in meaning *} {section name=customer loop=$custid} {$smarty.section.customer.index} id: {$custid[customer]}<br /> {/section} salida del ejemplo de arriba: 0 id: 1000<br /> 1 id: 1001<br /> 2 id: 1002<br /> index_prev El index_prev es usado para mostrar el índice anterior del loop(ciclo). del primer loop(ciclo) esto es definido como -1. index_next El index_next es usado para mostrar el próximo indice del loop. del último loop, esto es uno mas que el índice actual( respe- tando la definición del atributo step que se a dado.) Ejemplo 7.24. {section} propiedades del index_next y index_prev <?php $data = array(1001,1002,1003,1004,1005); $smarty->assign('custid',$data); ?> {* FYI, $custid[cus.index] and $custid[cus] are identical in meaning *} <table> <tr> <th>index</th><th>id</th> <th>index_prev</th><th>prev_id</th> <th>index_next</th><th>next_id</th> 56
  • 63. Funciones Integradas </tr> {section name=cus loop=$custid} <tr> <td>{$smarty.section.cus.index}</td><td>{$custid[cus]}</td> <td>{$smarty.section.cus.index_prev}</td><td>{$custid[cus.index_prev]}</td> <td>{$smarty.section.cus.index_next}</td><td>{$custid[cus.index_next]}</td> </tr> {/section} </table> la salida del ejemplo de arriba esta contenido en la siguiente tabla: index id index_prev prev_id index_next next_id 0 1001 -1 1 1002 1 1002 0 1001 2 1003 2 1003 1 1002 3 1004 3 1004 2 1003 4 1005 4 1005 3 1004 5 iteration iteration es usado para mostrar la iteración actual del loop(ciclo). nota: Esto no es afectado por las propiedades del section start, step y max, distinto de las propriedades del index. Iteration también comineza con 1 en vez de 0 como index. rownum es un alias de iteration, estas funcionan de ma- nera identica. Ejemplo 7.25. {section} propiedades de iteration <?php // array of 3000 to 3015 $id = range(3000,3015); $smarty->assign('custid',$id); ?> {section name=cu loop=$custid start=5 step=2} iteration={$smarty.section.cu.iteration} index={$smarty.section.cu.index} id={$custid[cu]}<br /> {/section} salida del ejemplo de arriba: iteration=1 index=5 id=3005<br /> iteration=2 index=7 id=3007<br /> iteration=3 index=9 id=3009<br /> iteration=4 index=11 id=3011<br /> iteration=5 index=13 id=3013<br /> iteration=6 index=15 id=3015<br /> Este ejemplo utiliza la propiedad iteration para salida a una tabla bloqueando el encabezado para cada 5 renglones (utilice {if} con el operador mod). <table> {section name=co loop=$contacts} {if $smarty.section.co.iteration % 5 == 1} <tr><th>&nbsp;</th><th>Name></th><th>Home</th><th>Cell</th><th>Email</th></tr> 57
  • 64. Funciones Integradas {/if} <tr> <td><a href="view.php?id={$contacts[co].id}">view<a></td> <td>{$contacts[co].name}</td> <td>{$contacts[co].home}</td> <td>{$contacts[co].cell}</td> <td>{$contacts[co].email}</td> <tr> {/section} </table> first first es definido como true se la iteración actual de la section es la primera. last last es definido como true si la iteración actual del section es la ultima. Ejemplo 7.26. {section} propiedades first y last En este ciclo de ejemplo el arreglo $customer, en la salida es bloqueado el encabezado en la primera iteracion y en la ultima la salida es bloqueda para el pie de pagina. (Utilice la propiedad section total) {section name=customer loop=$customers} {if $smarty.section.customer.first} <table> <tr><th>id</th><th>customer</th></tr> {/if} <tr> <td>{$customers[customer].id}}</td> <td>{$customers[customer].name}</td> </tr> {if $smarty.section.customer.last} <tr><td></td><td>{$smarty.section.customer.total} customers</td></tr> </table> {/if} {/section} rownum rownum es usado para mostrar la interación actual del loop(ciclo), comenzando con 1. Es un alias para iteration, estas fun- cionan de modo identico. loop loop es usado para mostrar el ultimo número del índice del loop(ciclo) de esta section. Esto puede ser usado dentro o fuera del section. Ejemplo 7.27. {section} propiedades de index {section name=customer loop=$custid} 58
  • 65. Funciones Integradas {$smarty.section.customer.index} id: {$custid[customer]}<br /> {/section} There were {$smarty.section.customer.loop} customers shown above. La salida del ejemplo de arriba: 0 id: 1000<br /> 1 id: 1001<br /> 2 id: 1002<br /> There were 3 customers shown above. show showEs usado como parámetro para section. show Es un valor booleano, true o false. Si es false, la section no será mostrada. Si existiera un sectionelse presente, este será alternativamente mostrado. Ejemplo 7.28. section atributos de show {* $show_customer_info debe ser pasado de la aplicacion PHP, para regular cuando mostrar o no esta section shows *} {section name=customer loop=$custid show=$show_customer_info} {$smarty.section.customer.rownum} id: {$custid[customer]}<br /> {/section} {if $smarty.section.customer.show} the section was shown. {else} the section was not shown. {/if} La salida del ejemplo de arriba: 1 id: 1000<br /> 2 id: 1001<br /> 3 id: 1002<br /> the section was shown. total total es usado para mostrar el número de iteraciones que está section tendra. Este puede ser usado dentro o fuera del section. Ejemplo 7.29. {section} propiedades de total {section name=customer loop=$custid step=2} {$smarty.section.customer.index} id: {$custid[customer]}<br /> {/section} There were {$smarty.section.customer.total} customers shown above. 59
  • 66. Funciones Integradas The above example will output: 0 id: 1000<br /> 2 id: 1002<br /> 4 id: 1004<br /> There were 3 customers shown above. Ver también {foreach} y $smarty.section. {strip} Muchas veces el diseñador de web tiene problemas con los espacios en blanco y retornos de carro que afectan la salida del HTML (browser "features"), si usted tiene que colocar todas sus etiquetas juntas para tener los resultados deseados. Esto normalmente termina en un template ilegible o que no se puede leer. A cualquier cosa dentro de las etiquetas{strip}{/strip} en Smarty le son retirados los espacios en blanco y retornos de carro al inicio y al final de las lineas antes que sean mostrados. De este modo usted puede manter su template legible, y no se peo- cupara de que los espacios en blanco extras le causen problemas. Nota Técnica: {strip}{/strip} no afeta el contenido de las variables del template. Vea la función strip modifier. Ejemplo 7.30. {strip} tags {* El siguiente código se ejecutara todo junto en una sola linea de salida *} {strip} <table border='0'> <tr> <td> <A HREF="{$url}"> <font color="red">This is a test</font> </A> </td> </tr> </table> {/strip} salida del ejemplo de arriba: <table border=0><tr><td><A HREF="http://w... snipped...</td></tr></table> Note que en el ejemplo de arriba, todas las lineas comienzan y termina con etiquetas HTML. Tenga cuidado en que todas las lineas corran conjuntamente. Si usted tuviera textos planos simples en el inicio o en el final de una linea, este estaria junto, y puede no ser el resultado deseado. Vea También strip modifier 60
  • 67. Capítulo 8. Custom Functions Tabla de contenidos {assign} ............................................................................................................................................ 61 {counter} .......................................................................................................................................... 62 cycle ................................................................................................................................................. 63 {debug} ............................................................................................................................................ 64 {eval} ............................................................................................................................................... 64 {fetch} .............................................................................................................................................. 65 {html_checkboxes} ............................................................................................................................. 66 {html_image} ..................................................................................................................................... 68 {html_options} ................................................................................................................................... 68 {html_radios} ..................................................................................................................................... 70 {html_select_date} .............................................................................................................................. 72 {html_select_time} .............................................................................................................................. 75 {html_table} ...................................................................................................................................... 79 math ................................................................................................................................................. 81 {mailto} ............................................................................................................................................ 82 {popup_init} ...................................................................................................................................... 84 popup ............................................................................................................................................... 84 {textformat} ....................................................................................................................................... 88 Smarty viene con varias funciones personalizadas que usted puede usar en sus templates. {assign} Nombre del Atributo Tipo Requerido Default Descripción var string Si n/a El nombre de la varia- ble que esta ganando el valor value string Si n/a El valor que esta siendo dado {assign} es usado para definir valores a las variables de template durante la ejecución del template. Ejemplo 8.1. {assign} {assign var="name" value="Bob"} The value of $name is {$name}. Salida del ejemplo de arriba: The value of $name is Bob. 61
  • 68. Custom Functions Ejemplo 8.2. Accesando variables desde un script de PHP. {assign} Puedes accesar {assign} variables desde php usando get_template_vars(). sin embargo, las variables solo estan disponibles despues/durante la ejecución del template como en el siguiente ejemplo {* index.tpl *} {assign var="foo" value="Smarty"} <?php // this will output nothing as the template has not been executed echo $smarty->get_template_vars('foo'); // fetch the template to a dead variable $dead = $smarty->fetch('index.tpl'); // this will output 'smarty' as the template has been executed echo $smarty->get_template_vars('foo'); $smarty->assign('foo','Even smarter'); // this will output 'Even smarter' echo $smarty->get_template_vars('foo'); ?> La siguiente función optionally también puede asignar variables al template. {capture}, {include}, {include_php}, {insert}, {counter}, {cycle}, {eval}, {fetch}, {math}, {textformat} Ver también assign() y get_template_vars(). {counter} Nombre del Atributo Tipo Requerido Default Descripción name string No default El nombre del contador start number No 1 El número inicial para contar a partir de skip number No 1 El intervalo para contar direction string No up La dirección para con- tar (up/down) print boolean No true Cuando mostrar o no el valor assign string No n/a La variable del templa- te que va a recibir la sa- lida {counter} es usada para mostrar un conteo. {counter} va a depender del conteo en cada iteración. Usted puede ajustar el nú- mero, el intervalo y la dirección del conteo, asi como determinar cuando mostrar o no el conteo. Usted puede tener varios contadores al mismo tiempo, dando un nombre único para cada uno. Si usted no da un nombre, sera usado 'default' como nombre. Si usted indica el atributo especial "assign", la salida de la función counter se ira para esa variable del template en vez de ser 62
  • 69. Custom Functions mostrada en el template. Ejemplo 8.3. counter {* Inicia el conteo *} {counter start=0 skip=2}<br /> {counter}<br /> {counter}<br /> {counter}<br /> Esta es la salida: 0<br /> 2<br /> 4<br /> 6<br /> cycle Nombre del Atributo Tipo Requerido Default Descripción name string No default El nombre del ciclo values mixed Si N/A Los valores del ciclo, o una lista delimitada por coma (vea el atributo delimiter), o una matriz de valores. print boolean No true Cuando mostrar o no el valor advance boolean No true Cuando avanzar o no hacia el siguiente valor delimiter string No , El delimitador para usar el valor del atribu- to. assign string No n/a La variable del templa- te que recibirá la salida reset boolean No false Este coloca al ciclo en el primer valor y no le permite avanzar {Cycle} es usado para hacer un ciclo a través de un conjunto de valores. Esto hace mas fácil alternar entre dos o mas colores en una tabla, o ciclos a travéz de una matriz de valores. Usted puede usar el {cycle} en mas de un conjunto de valores en su template supliendo el atributo name. De cada uno de los conjuntos de valores. Usted puede forzar que el valor actual no sea mostrado definiendo el atributo print en false. Esto es útil para saltarse un va- lor. El atributo advance es usado para repetir un valor. cuando se definido en false, la próxima llamada para cycle mostrara el mismo valor. 63
  • 70. Custom Functions Si usted indica el atributo especial "assign", la saida de la función cycle ira a la variable del template en vez de ser mostrado ditectamente en el template. Ejemplo 8.4. cycle {section name=rows loop=$data} <tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"> <td>{$data[rows]}</td> </tr> {/section} <tr bgcolor="#eeeeee"> <td>1</td> </tr> <tr bgcolor="#d0d0d0"> <td>2</td> </tr> <tr bgcolor="#eeeeee"> <td>3</td> </tr> {debug} Nombre del Atributo Tipo Requerido Default Descripción output string No javascript Tipo de salida, html o javascript {debug} Muestra el debug de la consola en la pagina. Esto funciona independente de la definición de debug. Ya que este es ejecutado en tiempo de ejecución, este solo puede mostrar las variables definidas, no en el template, es decir en uso. Usted puede ver todas las variables disponibles del template con scope. Ver también Debugging console {eval} Nombre del Atributo Tipo Requerido Default Descripción var mixed Si n/a variable (o cadena) pa- ra evaluar assign string No n/a La variable del templa- te que recibirá la salida {eval} es usado para evaluar una variable como de template. Esto puede ser usado para cosas como incrustar tags(etiquetas)/variables del template dentro de las variables o tags(etiquetas)/variables dentro de las variables de un archivo de configuración. Si usted indica el atributo especial "assign", la salida de la función eval se ira para esta variable de template en vez de apare- cer en el template. Nota Técnica: Al evaluar las variables son tratas igual que el template. Ellas sigen el mismo funcionamiento para escape y seguridad tal como si ellas fueran templates. 64
  • 71. Custom Functions Nota Técnica: Las variables evaluadas son compiladas en cada invocación, las vesiones compiladas no son salvas. Sin embargo, si usted tiene activado el cache, la salida se va a fijar en la cache junto con el resto del template. Ejemplo 8.5. {eval} setup.conf ---------- emphstart = <strong> emphend = </strong> title = Welcome to {$company}'s home page! ErrorCity = You must supply a {#emphstart#}city{#emphend#}. ErrorState = You must supply a {#emphstart#}state{#emphend#}. Where index.tpl is: {config_load file="setup.conf"} {eval var=$foo} {eval var=#title#} {eval var=#ErrorCity#} {eval var=#ErrorState# assign="state_error"} {$state_error} La salida del ejemplo de arriba: This is the contents of foo. Welcome to Foobar Pub & Grill's home page! You must supply a <strong>city</strong>. You must supply a <strong>state</strong>. {fetch} Nombre del Atributo Tipo Requerido Default Descripción file string Si n/a El archivo, sitio http o ftp para mandar llamar assign string No n/a La variable del templa- te que va a recibir la sa- lida {fetch} es usado para obtener archivos de sistema local, http o ftp, y mostrar el contenido. Si el nombre del archivo comien- za con "http://", la página del web site sera traida y mostrada. Si el nombre del archivo comienza con "ftp://", el archivo será obtenido del servidor ftp y mostrado. Para archivos locales, debe ser dada la ruta completa del sistema de archivos, o una ru- ta relativa de el script php a ejecutar. Si usted indica el atributo especial "assign", la salida de la función {fetch} se ira a una variable de template en vez de ser mostrada en el template. (nuevo en Smarty 1.5.0) Nota Técnica: Esto no soporta redirecionamento http, tenga la certeza de incluirlo en la barra el seguimiento para ir a buscar donde sea necesario. Nota Técnica: Si tiene activada la seguridad en su template y usted estuviera recibiendo un archivo del sistema de archivos local, esto permitira que solo archivos de uno de los directorios estuviera definido como seguro. ($secure_dir) 65
  • 72. Custom Functions Ejemplo 8.6. fetch {* include some javascript in your template *} {fetch file="/export/httpd/www.example.com/docs/navbar.js"} {* embed some weather text in your template from another web site *} {fetch file="http://www.myweather.com/68502/"} {* fetch a news headline file via ftp *} {fetch file="ftp://user:password@ftp.example.com/path/to/currentheadlines.txt"} {* assign the fetched contents to a template variable *} {fetch file="http://www.myweather.com/68502/" assign="weather"} {if $weather ne ""} <b>{$weather}</b> {/if} Ver también {capture}, {eval} y fetch(). {html_checkboxes} Nombre del Atributo Tipo Requerido Default Descripción name string No checkbox Nombre de la lista checkbox values array Si, a menos que se este n/a Una matriz de valores utilizando el atributo para los botones check- options box output array Si, a menos que estu- n/a una matriz de salida pa- viera usando el atributo ra los botones check- options box selected string/array No empty El(s) elemento(s) checkbox marcado(s) options arreglo asociativo Si, a menos que este n/a Una matriz asociativa usando values y output de valores y salida separator string No empty Cadena de texto para separar cada checkbox labels boolean No true Adicionar la etiqueta <label> para la salida {html_checkboxes} es una función personalizada que crea un grupo de checkbox con datos privistos. Este cuida cuales items(s) estan selecionados por default. Los atributos requeridos son values y output, a menos que usted use options. Toda la salida es compatible con XHTML. Todos los parámetros que no esten en la lista de arriba son mostrados como nombre/valor dentro de cada etiqueta <input> creada. Ejemplo 8.7. {html_checkboxes} <?php $smarty->assign('cust_ids', array(1000,1001,1002,1003)); $smarty->assign('cust_names', array( 66
  • 73. Custom Functions 'Joe Schmoe', 'Jack Smith', 'Jane Johnson', 'Charlie Brown') ); $smarty->assign('customer_id', 1001); ?> donde el template es {html_checkboxes name="id" values=$cust_ids output=$cust_names selected=$customer_id separator="<br />"} o donde el codigo es: <?php $smarty->assign('cust_checkboxes', array( 1000 => 'Joe Schmoe', 1001 => 'Jack Smith', 1002 => 'Jane Johnson', 1003 => 'Charlie Brown') ); $smarty->assign('customer_id', 1001); ?> y el template es {html_checkboxes name="id" options=$cust_checkboxes selected=$customer_id separator="<br />"} salida de ambos ejemplos: <label><input type="checkbox" name="id[]" value="1000" />Joe Schmoe</label><br /> <label><input type="checkbox" name="id[]" value="1001" checked="checked" />Jack Smith</label> <br /> <label><input type="checkbox" name="id[]" value="1002" />Jane Johnson</label><br /> <label><input type="checkbox" name="id[]" value="1003" />Charlie Brown</label><br /> Ejemplo 8.8. ejemplo de base de datos (eg PEAR o ADODB): <?php $sql = 'select type_id, types from types order by type'; $smarty->assign('types',$db->getAssoc($sql)); $sql = 'select * from contacts where contact_id=12'; $smarty->assign('contact',$db->getRow($sql)); ?> {html_checkboxes name="type" options=$types selected=$contact.type_id separator="<br />"} Vea también {html_radios} y {html_options} 67
  • 74. Custom Functions {html_image} Nombre del Atributo Tipo Requerido Default Descripción file string Si n/a nombre/ruta de la ima- gen height string No Altura actual de la altura con la cual la imagen imagen debe ser mos- trada width string No Largo actual de la ima- largo con el cual la gen imagen debe ser mos- trada basedir string no document root del ser- ruta relativa para la ba- vidor web se del directorio alt string no "" descripción alternativa de la imagen href string no n/a valor href a donde la imagen será ligada {html_image} es una función habitual que genera una etiqueta HTML para una imagen. La altura y lo largo son automática- mente calculadas a partir del archivo de la imagen si ningún valor suplido. basedir es el directorio base en el cual las rutas relativas de las imagenes estan basados. Si no lo proporciona, el document root del servidor (env variable de ambiente DOCUMENT_ROOT) es usada como el directorio base. Si la $security esta ha- bilitada, la ruta para la imagen debe estar dentro de un directorio seguro. href es el valor href a donde la imagen sera ligada. Si un link es proporcionado, una etiqueta <a href="LINKVALUE"><a> es puesta alrededor de la imagen. Todos los parametros que no esten dentro de la lista de arriba son mostrados como pares de nombre/valor dentro de la eti- queta creada <img>. Nota Técnica: {html_image} requiere un acceso a disco para leer la imagen y calcular la altura y el largo. Si usted no usa cache en el template, generalmente es mejor evitar {html_image} y utilizar las etiquetas de imagen estáticas para un optimo funcionamiento. Ejemplo 8.9. html_image example where index.tpl is: ------------------- {html_image file="pumpkin.jpg"} {html_image file="/path/from/docroot/pumpkin.jpg"} {html_image file="../path/relative/to/currdir/pumpkin.jpg"} la posible saldida puede ser: <img src="pumpkin.jpg" alt="" width="44" height="68" /> <img src="/path/from/docroot/pumpkin.jpg" alt="" width="44" height="68" /> <img src="../path/relative/to/currdir/pumpkin.jpg" alt="" width="44" height="68" /> {html_options} 68
  • 75. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción values array Si, a menos que use el n/a una matriz de valores atributo options para el menu dropdown output array Si, a menos que use el n/a una matriz de salida pa- atributo options ra el menu dropdown selected string/array No empty los elemento(s) de la option selecionado(s) options arreglo asociativo Si, a menos que utilize n/a una matriz asociativa valores y salida de valores y salida name string No empty nombre del grupo se- leccionado {html_options} es una función customizada que crea un grupo html <select><option> con los datos proporcionados. Este se encarga de cuidar cuales datos han sido selecionado por default. Los atributos son valores y salidas, a menos que usted utili- ce options en lugar de eso. Si un valor es una matriz, este será tratado como un <optgroup> html, y mostrara los grupos. La recursión es soportada por <optgroup>. Todas las salidas son compatibles con XHTML. Si el atributo opcional name es dado, las etiquetas <select name="groupname"></select> encapsularan la lista de opciones. De otra manera solo es generada la lista de opciones. Todos los parámetros que no estan en la lista de arriba son exibidos como name/value-pairs dentro de las etiquetas <select>. Estas son ignoradas si la opcion name no es dada. Ejemplo 8.10. {html_options} Ejemplo 1: <?php $smarty->assign('cust_ids', array(1000,1001,1002,1003)); $smarty->assign('cust_names', array( 'Joe Schmoe', 'Jack Smith', 'Jane Johnson', 'Charlie Brown')); $smarty->assign('customer_id', 1001); ?> donde el template es: <select name=customer_id> {html_options values=$cust_ids output=$cust_names selected=$customer_id} </select> Ejemplo 2: <?php $smarty->assign('cust_options', array( 1000 => 'Joe Schmoe', 1001 => 'Jack Smith', 1002 => 'Jane Johnson', 1003 => 'Charlie Brown') 69
  • 76. Custom Functions ); $smarty->assign('customer_id', 1001); ?> donde el template es: <select name=customer_id> {html_options options=$cust_options selected=$customer_id} </select> Salida de ambos ejemplos de arriba: <select name=customer_id> <option label="Joe Schmoe" value="1000">Joe Schmoe</option> <option label="Jack Smith" value="1001" selected="selected">Jack Smith</option> <option label="Jane Johnson" value="1002">Jane Johnson</option> <option label="Charlie Brown" value="1003">Charlie Brown</option> </select> Ejemplo 8.11. {html_options} - Ejemplo con base de datos (eg PEAR o ADODB): <?php $sql = 'select type_id, types from types order by type'; $smarty->assign('types',$db->getAssoc($sql)); $sql = 'select contact_id, name, email, type_id from contacts where contact_id='.$contact_id; $smarty->assign('contact',$db->getRow($sql)); ?> Donde el template es: <select name="type_id"> <option value='null'>-- none --</option> {html_options name="type" options=$types selected=$contact.type_id} </select> vea también {html_checkboxes} y {html_radios} {html_radios} Nombre del Atributo Tipo Requerido Default Descripción name string No radio Nombre de la lista del radio values array Si, a menos que utilice n/a una matriz de valores el atributo options para radio buttons output array Si, a menos que utilice n/a una matriz de salida pa- el atributo options ra radio buttons selected string No empty El elemento del radio selccionado options arreglo asociativo Si, a menos qie utilice n/a una matriz asociativa 70
  • 77. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción valores y salida de valores y salida separator string No empty cadena de texto para separar cada objeto de radio {html_radios} es una función customizada que crea grupos de botones de radio html con los datos proporcionados. Este esta atento para saber cual objeto esta selccionado por default. Los atributos requeridos son valores y salidas, a menos que usted use option en lugar de eso. Toda salida es compatible con XHTML. Todos los parámetros que no estan en la lista de arriba son impresos como pares de name/value dentro de cada etiqueta <input> creada. Ejemplo 8.12. {html_radios} : Ejemplo 1 <?php $smarty->assign('cust_ids', array(1000,1001,1002,1003)); $smarty->assign('cust_names', array( 'Joe Schmoe', 'Jack Smith', 'Jane Johnson', 'Charlie Brown') ); $smarty->assign('customer_id', 1001); ?> Donde el template es: {html_radios name="id" values=$cust_ids output=$cust_names selected=$customer_id separator="<br />"} Ejemplo 8.13. {html_radios} : Ejemplo 2 <?php $smarty->assign('cust_radios', array( 1000 => 'Joe Schmoe', 1001 => 'Jack Smith', 1002 => 'Jane Johnson', 1003 => 'Charlie Brown')); $smarty->assign('customer_id', 1001); ?> Donde index.tpl es: {html_radios name="id" options=$cust_radios selected=$customer_id separator="<br />"} Salida de ambos ejemplos: <label for="id_1000"> <input type="radio" name="id" value="1000" id="id_1000" />Joe Schmoe</label><br /> <label for="id_1001"><input type="radio" name="id" value="1001" id="id_1001" 71
  • 78. Custom Functions checked="checked" />Jack Smith</label><br /> <label for="id_1002"><input type="radio" name="id" value="1002" id="id_1002" />Jane Johnson</label><br /> <label for="id_1003"><input type="radio" name="id" value="1003" id="id_1003" />Charlie Brown</label><br /> Ejemplo 8.14. {html_radios}- Ejemplo con base de Datos (eg PEAR o ADODB): <?php $sql = 'select type_id, types from types order by type'; $smarty->assign('types',$db->getAssoc($sql)); $sql = 'select contact_id, name, email, type_id from contacts where contact_id='.$contact_id; $smarty->assign('contact',$db->getRow($sql)); ?> y el template: {html_radios name="type" options=$types selected=$contact.type_id separator="<br />"} ver también {html_checkboxes} y {html_options} {html_select_date} Nombre del Atributo Tipo Requerido Default Descripción prefix string No Date_ Con el prefijo el nom- bre de la variable time timestamp/ No Tiempo actual en el ti- Cual date/time a usar YYYY-MM-DD mestamp de unix o el formato YYYY- MM-DD start_year string No Año actual El primer año primero en el menu dropdown, o el número de año, o el relativo al año actual (+/- N) end_year string No de la misma forma que El ultimo año en el me- start_year nu dropdown, o el nú- mero de año, o el relati- vo al año actual (+/- N) display_days boolean No true Muestra los dias o no display_months boolean No true Muestra los meses o no display_years boolean No true Muestra los años o no month_format string No %B Cual debe ser el forma- to de salida del mes dentro de (strftime) day_format string No %02d Cual debe ser el forma- 72
  • 79. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción to de salida del dia den- tro de (sprintf) day_value_format string No %d Cual debe ser el forma- to de salida del valor del dia dentro de (sprintf) year_as_text boolean No false Se mostrara o no el año como texto reverse_years boolean No false Muestra los años en or- den inverso field_array string No null si un nombre es dado, las cajas de seleción se- ran exibidas semejantes a los resultados que es- taran retornando al PHP en la forma. na- me[Day], name[Year], name[Month]. day_size string No null adiciona el tamaño al atributo para la etiqueta select si fue dada month_size string No null adiciona el tamaño del atributo para la etiqueta select si fue dada year_size string No null adiciona el tamaño del atributo para la etiqueta select si fue dada all_extra string No null adiciona atributos ex- tras para todas las eti- quetas select/input si fueron dadas day_extra string No null adiciona atributos ex- tras para todas las eti- quetas select/input si fueron dadas month_extra string No null adiciona atributos ex- tras para todas las eti- quetas select/input si fueron dadas year_extra string No null adiciona atributos ex- tras para todas las eti- quetas select/input si fueron dadas field_order string No MDY El orden para ser mos- trados los campos field_separator string No n Cadena a mostrar entre los diferentes campos month_value_format string No %m formato strftime de los valores del mes, el de- fault es %m para el nú- mero del mes. 73
  • 80. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción year_empty string No null Si es proporcionado en- tonces el primer ele- mento es el año select- box tiene este valor co- mo etiqueta y "" como valor. Esto es util para hacer una lectura en el select-box por ejemplo "por favor seccione el año". Note que este puede usar valores co- mo "-MM-DD" como atributos de time indi- cando que el año sea desmarcado. month_empty string No null Si es proporcinado en- tonces el mes es el pri- mer elemento select- box tiene este valor co- mo etiqueta y "" como valor. Note que usted puede usar valores co- mo "YYYY--DD" co- mo atributos de time indicando que el mes sea desmarcado. day_empty string No null Si es proporcinado en- tonces es dias es el pri- mer elemento select- box tiene este valor co- mo etiqueta y "" como valor. Note que usted puede usar valores co- mo "YYYY-MM--" co- mo atributos de time indicando que el dia sea desmarcado. {html_select_date} es una función customizada que crea menus dropdowns de fechas para usted. Este puede mostrar algu- nos o todos por año, mes y dia. Ejemplo 8.15. {html_select_date} Codigo del Template {html_select_date} Esta es la salida: <select name="Date_Month"> <option value="1">January</option> <option value="2">February</option> <option value="3">March</option> ..... snipped ..... 74
  • 81. Custom Functions <option value="10">October</option> <option value="11">November</option> <option value="12" selected="selected">December</option> </select> <select name="Date_Day"> <option value="1">01</option> <option value="2">02</option> <option value="3">03</option> ..... snipped ..... <option value="11">11</option> <option value="12">12</option> <option value="13" selected="selected">13</option> <option value="14">14</option> <option value="15">15</option> ..... snipped ..... <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> </select> <select name="Date_Year"> <option value="2001" selected="selected">2001</option> </select> Ejemplo 8.16. {html_select_date} {* el año seleccionado puede ser relativo al año actual *} {html_select_date prefix="StartDate" time=$time start_year="-5" end_year="+1" display_days=false} esta es la salida: (el año actual es 2000) <select name="StartDateMonth"> <option value="1">January</option> <option value="2">February</option> <option value="3">March</option> <option value="4">April</option> <option value="5">May</option> <option value="6">June</option> <option value="7">July</option> <option value="8">August</option> <option value="9">September</option> <option value="10">October</option> <option value="11">November</option> <option value="12" selected="selected">December</option> </select> <select name="StartDateYear"> <option value="1995">1995</option> <option value="1996">1996</option> <option value="1997">1997</option> <option value="1998">1998</option> <option value="1999">1999</option> <option value="2000" selected="selected">2000</option> <option value="2001">2001</option> </select> Ver también {html_select_time}, date_format, $smarty.now y date tips. {html_select_time} 75
  • 82. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción prefix string No Time_ con el prefijo el nom- bre de la variable time timestamp No current time cual date/time va a usar display_hours boolean No true Mostrar o no las horas display_minutes boolean No true Mostrar o no los minu- tos display_seconds boolean No true Mostrar o no los segun- dos display_meridian boolean No true Mostrar o no el meri- diano (am/pm) use_24_hours boolean No true Usar o no reloj de 24 horas minute_interval integer No 1 número de los interva- los de los minutos del menu dropdown second_interval integer No 1 número de los interva- los de los segundos del menu dropdown field_array string No n/a muestra los valores del arreglo con este nom- bre all_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados hour_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados minute_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados second_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados meridian_extra string No null adiciona atributos ex- tras a las etiquetas se- lect/input si fueron pro- porcionados {html_select_time} es una función customizada que crea menus dropdowns de tiempo para usted. Esta puede mostrar algu- nos valores, o todo en hora, minuto, segundo y am/pm. Los atributos de time pueden tener diferentes formatos. Este puede ser un unico timestamp o una cadena conteniendo YYYYMMDDHHMMSS o una cadena parseda por php's strtotime() [http://php.net/strtotime]. 76
  • 83. Custom Functions Ejemplo 8.17. {html_select_time} template code: -------------- {html_select_time use_24_hours=true} Esta es la salida: <select name="Time_Hour"> <option value="00">00</option> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09" selected>09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20">20</option> <option value="21">21</option> <option value="22">22</option> <option value="23">23</option> </select> <select name="Time_Minute"> <option value="00">00</option> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09">09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20" selected>20</option> <option value="21">21</option> <option value="22">22</option> <option value="23">23</option> <option value="24">24</option> <option value="25">25</option> <option value="26">26</option> <option value="27">27</option> <option value="28">28</option> <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> 77
  • 84. Custom Functions <option value="32">32</option> <option value="33">33</option> <option value="34">34</option> <option value="35">35</option> <option value="36">36</option> <option value="37">37</option> <option value="38">38</option> <option value="39">39</option> <option value="40">40</option> <option value="41">41</option> <option value="42">42</option> <option value="43">43</option> <option value="44">44</option> <option value="45">45</option> <option value="46">46</option> <option value="47">47</option> <option value="48">48</option> <option value="49">49</option> <option value="50">50</option> <option value="51">51</option> <option value="52">52</option> <option value="53">53</option> <option value="54">54</option> <option value="55">55</option> <option value="56">56</option> <option value="57">57</option> <option value="58">58</option> <option value="59">59</option> </select> <select name="Time_Second"> <option value="00">00</option> <option value="01">01</option> <option value="02">02</option> <option value="03">03</option> <option value="04">04</option> <option value="05">05</option> <option value="06">06</option> <option value="07">07</option> <option value="08">08</option> <option value="09">09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20">20</option> <option value="21">21</option> <option value="22">22</option> <option value="23" selected>23</option> <option value="24">24</option> <option value="25">25</option> <option value="26">26</option> <option value="27">27</option> <option value="28">28</option> <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> <option value="32">32</option> <option value="33">33</option> <option value="34">34</option> <option value="35">35</option> <option value="36">36</option> <option value="37">37</option> <option value="38">38</option> <option value="39">39</option> <option value="40">40</option> 78
  • 85. Custom Functions <option value="41">41</option> <option value="42">42</option> <option value="43">43</option> <option value="44">44</option> <option value="45">45</option> <option value="46">46</option> <option value="47">47</option> <option value="48">48</option> <option value="49">49</option> <option value="50">50</option> <option value="51">51</option> <option value="52">52</option> <option value="53">53</option> <option value="54">54</option> <option value="55">55</option> <option value="56">56</option> <option value="57">57</option> <option value="58">58</option> <option value="59">59</option> </select> <select name="Time_Meridian"> <option value="am" selected>AM</option> <option value="pm">PM</option> </select> Ver también $smarty.now, {html_select_date} y date tips. {html_table} Nombre del Atributo Tipo Requerido Default Descripción loop array Si n/a matriz de datos para el ciclo(loop) cols integer No 3 Número de columnas para la tabla. Si el atri- buto cols esta vacio, los renglones seran deter- minados, entonces el numero de columnas sera calculado por el numero de renglones y el numero de elementos a mostrar para ser ajus- tado a las columnas de todos los elementos que seran mostrados, si ambos, renglones y co- lumnas, son omitidos las columnas por de- fault son 3. rows integer No empty Número de renglones en la tabla. Si el atribu- to rows es vacio, las columnas seran deter- minadas, entonces el numero de renglones sera calculado por el numero de columnas y el numero de elementos 79
  • 86. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción a mostrar para ser ajus- tado el numero de ren- glones al total de ele- mentos a ser mostra- dos. inner string No cols Dirección consecutiva de los elementos en el arreglo para ser repre- sentados. cols manera en que los elementos son mostrados columna por columna. rows ma- nera en que los elemen- tos son mostrados ren- glon por renglon. table_attr string No border="1" atributos para la etique- ta table tr_attr string No empty atributos para la etique- ta tr (arreglos del ciclo) td_attr string No empty atributos para la etique- ta td (arreglos del ciclo) trailpad string No &nbsp; valor de relleno de las celdas para el ultimo renglon con (si hay al- guno) hdir string No right dirección de una linea para ser representada. posibles valores: left (left-to-right), right (right-to-left) vdir string No down Dirección de las co- lumnas para ser repre- sentadas. posibles valo- res: down (top-to-bottom), up (bottom-to-top) {html_table} Es una función customizada que transforma un arreglo de datos en una tabla HTML. El atributo cols determi- na el número de columnas que tendra la tabla. Los valores table_attr, tr_attr y td_attr determinan los atributos dados para las etiquetas tabla, tr y td. Si tr_attr o td_attr son arreglos, ellos entraran en un ciclo. trailpad y el valor depositado dentro de trailing cells en la ultima linea de la tabla si existe alguna presente. Ejemplo 8.18. html_table php code: --------- <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->assign('data',array(1,2,3,4,5,6,7,8,9)); $smarty->assign('tr',array('bgcolor="#eeeeee"','bgcolor="#dddddd"')); $smarty->display('index.tpl'); ?> 80
  • 87. Custom Functions template code: -------------- {html_table loop=$data} {html_table loop=$data cols=4 table_attr='border="0"'} {html_table loop=$data cols=4 tr_attr=$tr} La salida de ambos ejemplos: <table border="1"> <tr><td>1</td><td>2</td><td>3</td></tr> <tr><td>4</td><td>5</td><td>6</td></tr> <tr><td>7</td><td>8</td><td>9</td></tr> </table> <table border="0"> <tr><td>1</td><td>2</td><td>3</td><td>4</td></tr> <tr><td>5</td><td>6</td><td>7</td><td>8</td></tr> <tr><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr> </table> <table border="1"> <tr bgcolor="#eeeeee"><td>1</td><td>2</td><td>3</td><td>4</td></tr> <tr bgcolor="#dddddd"><td>5</td><td>6</td><td>7</td><td>8</td></tr> <tr bgcolor="#eeeeee"><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr> </table> math Nombre del Atributo Tipo Requerido Default Descripción equation string Si n/a La ecuación a ejecutar format string No n/a El formato del resulta- do (sprintf) var numeric Si n/a Valor de la variable de la ecuación assign string No n/a Variable de template cuya salida sera asigna- da [var ...] numeric Si n/a Valor de la variable de la ecuación {math} permite diseñar ecuaciones matemáticas dentro del template. Cualquier variable numérica del template puede ser usada en ecuaciones, y el resultado es mostrado en lugar de la etiqueta. Las variables usadas en ecuaciones son pasadas co- mo parámetros, que pueden ser variables de template o valores estáticos. +, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, srans y tan son todos los operadores validos. Verifique la documentación de PHP para mas información acerca de estas funciones matemáticas. Si usted proporciona el atributo especial "assign", la salida de la función matemática será atribuido a esta variable de tem- plate en vez de ser mostrada en el template. Nota Técnica: {math} es una función de muy alto rendimiento debido a que se puede usar con la función eval() [http://php.net/eval] de PHP. Hacer las matemáticas en PHP es mucho mas eficiente, asi en cualquier momento es posible hacer calculos matemáticos en PHP asignarlos a una variable y lanzar los resultados al template. Defíniti- vamente evite llamadas repetitivas de funciones matemáticas, dentro de los ciclos {section}. Ejemplo 8.19. {math} 81
  • 88. Custom Functions Ejemplo a: {* $height=4, $width=5 *} {math equation="x + y" x=$height y=$width} Salida del ejemplo de arriba: 9 Ejemplo b: {* $row_height = 10, $row_width = 20, #col_div# = 2, assigned in template *} {math equation="height * width / division" height=$row_height width=$row_width division=#col_div#} Salida del ejemplo de arriba: 100 Ejemplo c: {* you can use parenthesis *} {math equation="(( x + y ) / z )" x=2 y=10 z=2} Salida del ejemplo de arriba: 6 Ejemplo d: {* you can supply a format parameter in sprintf format *} {math equation="x + y" x=4.4444 y=5.0000 format="%.2f"} Salida del ejemplo de arriba: 9.44 {mailto} Nombre del Atributo Tipo Requerido Default Descripción address string Yes n/a La dirección de correo electronico(e-mail) text string No n/a El texto para mostrar, el default es la direc- ción de correo (e-mail) encode string No none Como codificar el e- mail. Puede ser none, hex, javascript o 82
  • 89. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción javas- cript_charcode. cc string No n/a La dirección de co- rreo(e-mail) para man- dar una copia el car- bon(cc). Separados por una coma. bcc string No n/a Dirección de correo electronico(e-mail) pa- ra mandar una copia al carbon ofuscada(bcc). Separando las direccio- nes por comas. subject string No n/a Asunto del correo elec- tronico(e-mail). newsgroups string No n/a newsgroup para enviar. separando las direccio- nes por comas. followupto string No n/a Direcciones para acom- pañar. Separe las direc- ciones con comas. extra string No n/a Cualquier otra informa- ción que usted quiera pasar por el link, tal co- mo plantillas de estilo {mailto} automatiza el proceso de creación de links de correo electronico(e-mail) y opcionalmente los codifica. Codificar el correo electronico(e-mail) hace mas difícil que las web spiders tomen las direciones de nuestro sitio. Nota Técnica: javascript es probablemente el codificador mas utilizado, aunque usted puede utilizar también codi- ficación hexadecimal. Ejemplo 8.20. {mailto} {mailto address="me@example.com"} <a href="mailto:me@example.com" >me@example.com</a> {mailto address="me@example.com" text="send me some mail"} <a href="mailto:me@example.com" >send me some mail</a> {mailto address="me@example.com" encode="javascript"} <script type="text/javascript" language="javascript"> eval(unescape('%64%6f% ... snipped ...%61%3e%27%29%3b')) </script> {mailto address="me@example.com" encode="hex"} <a href="mailto:%6d%65.. snipped..3%6f%6d">&#x6d;&..snipped...#x6f;&#x6d;</a> {mailto address="me@example.com" subject="Hello to you!"} <a href="mailto:me@example.com?subject=Hello%20to%20you%21" >me@example.com</a> {mailto address="me@example.com" cc="you@example.com,they@example.com"} <a href="mailto:me@example.com?cc=you@example.com%2Cthey@example.com" >me@example.com</a> {mailto address="me@example.com" extra='class="email"'} <a href="mailto:me@example.com" class="email">me@example.com</a> 83
  • 90. Custom Functions {mailto address="me@example.com" encode="javascript_charcode"} <script type="text/javascript" language="javascript"> <!-- {document.write(String.fromCharCode(60,97, ... snipped ....60,47,97,62))} //--> </script> ver también escape, Obfuscating E-mail Addresses y {textformat} {popup_init} {popup} es una integración de overLib [http://www.bosrup.com/web/overlib/], una biblioteca usada para ventanas popup. Esta es usada como contexto de infomación sensitiva, como ventanas de ayuda o herramientas. {popup_init} debe ser usada una vez hasta arriba de cada pagina donde usted planea usar la función popup. overLib [http://www.bosrup.com/web/over- lib/] fue escrita por Erik Bosrup, y la pagina esta localizada en http://www.bosrup.com/web/overlib/. A partir da versión 2.1.2 de Smarty, overLib NO viene con la distribución. Descargar el overLib, coloque el archivo over- lib.js dentro de su document root e indique la ruta relativa en el parámetro "src" de {popup_init}. Ejemplo 8.21. popup_init <head> {* popup_init debe ser llamado una sola vez hasta arriba de la pagina *} {popup_init src="/javascripts/overlib.js"} </head> popup Nombre del Atributo Tipo Requerido Default Descripción text string Si n/a El text/html para mos- trar en la ventana po- pup trigger string No onMouseOver El que va a ser usado para que aparezca la ventana. Puede ser on- MouseOver u onClick sticky boolean No false Hace que el poppup se quede cerca hasta que se cierre caption string No n/a Defíne el texto para el título fgcolor string No n/a El color que va a ser usado dentro de la caja popup bgcolor string No n/a El color del borde de la caja popup textcolor string No n/a Defíne el color del tex- to dentro de la caja po- pup 84
  • 91. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción capcolor string No n/a Defíne el color del títu- lo de la caja closecolor string No n/a Defíne el color del tex- to para cerrar textfont string No n/a Defíne el color del tex- to para ser usado en el texto principal captionfont string No n/a Defíne el tipo de letra para ser usado en el Tí- tulo closefont string No n/a Defíne el tipo de letra para el texto "Close" textsize string No n/a Defíne el tipo de letra del texto principal captionsize string No n/a Defíne el tamaño del ti- po de letra del título closesize string No n/a Defíne el tamaño del ti- po de letra del texto "Close" width integer No n/a Defíne el ancho de la caja height integer No n/a Defíne la altura de la caja left boolean No false Hace que el popups va- ya para la izquierda del ratón right boolean No false Hace que el popups va- ya para la derecha del ratón center boolean No false Hace que el popups va- ya al centro del ratón above boolean No false Hace que el popups va- ya por encima del rató. NOTA:solamente es posible si el height fue definido below boolean No false Hace que el popups va- ya por abajo del ratón border integer No n/a Torna en gruesos o fi- nos los bordes del po- pups offsetx integer No n/a A que distancia del ra- tón aparecera el popup, horizontalmente offsety integer No n/a A que distancia del ra- tón aparecera el popup, verticalmente fgbackground url to image No n/a Defíne una imagen pa- ra usar en vez del color del popup. 85
  • 92. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción bgbackground url to image No n/a defíne una imagen para ser usada como borde en vez de un color para el popup. NOTA:Usted debe definir bgcolor como "" o el color apa- recera también. NOTA: Cuando tuviera un link "Close", el Netscape rediseñara las celdas de la tabla, haciendo que las cosas aparezcan in- correctamente closetext string No n/a Defíne el texto "Close" a otra cosa noclose boolean No n/a No muestra el texto "Close" pegado con el título status string No n/a Defíne el texto en la barra de estado del na- vegador autostatus boolean No n/a Defíne el texto en la barra de estado para el texto del popup. NO- TA: sobreescribe la de- finición del status. autostatuscap string No n/a Defíne el texto de la barra de estado como el texto del título NOTA: sobreescribe el status y autostatus inarray integer No n/a Indica al overLib desde que índice de la matriz ol_text debe leer el tex- to, localizada en over- lib.js. Este parámetro puede ser usado en vez del texto caparray integer No n/a Indica al overLib a par- tir de que índice de la matriz ol_caps leer el título capicon url No n/a Muestra la imagen an- tes del título snapx integer No n/a Instantanea el popup a una posición constante en una cuadricula hori- zontal snapy integer No n/a Instantanea el popup a una posición constante en una cuadricula verti- cal fixx integer No n/a Cierra el popups en una 86
  • 93. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción posición horizontal No- ta: pasa por encima de otros colocados hori- zontal fixy integer No n/a Cierra popups en posi- ción vertical Note: pasa por encima de otros co- locados vertical background url No n/a Defíne una imagen pa- ra ser usada como fon- do en vez de la tabla padx integer,integer No n/a Rellena el fondo de la imagen con espacios en blanco horizontal para colocar el texto. Nota: este es un comando de dos parámetros pady integer,integer No n/a Rellena el fondo de la imagen con espacios en blanco vertical para co- locar el texto. Nota: es- te es un comando de dos parámetros fullhtml boolean No n/a Permite a usted contro- lar completamente el html sobre la figura de fondo. El código HTML es esperado en el atributo "text" frame string No n/a Controla popups en fra- mes diferentes. Para mayores informes so- bre esta función vea la pagina de overlib timeout string No n/a LLama especificamen- te a una función javas- cript y toma el valor que retorna, como el texto que se va a mos- trar en la ventana po- pup delay integer No n/a Hace que el popup fun- cione como un tooltip. Este aparecera solo con un retraso en milesimas de segundo hauto boolean No n/a Determina automática- mente si el popup debe aparecer a la izquierda o a la derecha del ratón. vauto boolean No n/a Determina automática- mente si el popup debe aparecer abajo o arriba 87
  • 94. Custom Functions Nombre del Atributo Tipo Requerido Default Descripción del ratón. {popup} es usado para crear ventanas popup con javascript. {popup_init} DEBE ser llamado primero para poder trabajar. Ejemplo 8.22. popup {* popup_init debe ser llamado una vez hasta arriba de la pagina *} {popup_init src="/javascripts/overlib.js"} {* crea un link con una ventana popup que aparece cuando se pasa el mouse sobre este *} <a href="mypage.html" {popup text="This link takes you to my page!"}>mypage</a> {* usted puede usar html, links, etc en el texto del popup *} <a href="mypage.html" {popup sticky=true caption="mypage contents" text="<ul><li>links</li><li>pages</li><li>images</li></ul>" snapx=10 snapy=10}>mypage</a> Ver también {popup_init} y overLib [http://www.bosrup.com/web/overlib/]. {textformat} Nombre del Atributo Tipo Requerido Default Descripción style string No n/a estilo pre-definido indent number No 0 Número de caracteres para endentar cada li- nea. indent_first number No 0 Número de caracteres para endentar la prime- ra linea indent_char string No (single space) El carácter (o cadena de caracteres) para en- dentar wrap number No 80 Cuantos caracteres ten- dra cada linea wrap_char string No n Caracter (o cadena de caracteres) a usar para saltar cada linea wrap_cut boolean No false Si es true, wrap saltara la linea en el carácter exacto en vez de saltar al final de la palabra. assign string No n/a La variable del templa- te que recibirá la salida {textformat} es una función de bloque usada para formatear texto. Básicamente limpa espacios y caracteres especiales, y formatea los párrafos cortando el texto al final de la palabra y endentando lineas. Usted puede definir los parámetros explícitamente, o usar un estilo pre-definido. Actualmente el único estilo disponible es "email". 88
  • 95. Custom Functions Ejemplo 8.23. {textformat} {textformat wrap=40} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} Salida del ajemplo de arriba: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {textformat wrap=40 indent=4} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} Salida del ejemplo de arriba: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo 89
  • 96. Custom Functions foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {textformat wrap=40 indent=4 indent_first=4} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} Salida del ejemplo de arriba: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {textformat style="email"} This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. {/textformat} Salida del ejemplo de arriba: This is foo. This is foo. This is foo. This is foo. This is foo. This is foo. 90
  • 97. Custom Functions This is bar. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. Ver también {strip} y {wordwrap}. 91
  • 98. Capítulo 9. Config Files Los archivos de configuración son utiles para diseñar y administrar variables globales para los templates a partir de un ar- chivo. Un ejemplo son los colores del template. Normalmente si usted quiere cambiar el esquema de colores de una aplica- ción, usted debe ir a cada uno de los archivos del template y cambiar los colores. Con un archivo de configuración, los colo- res pueden estar mantenidos en un lugar y solo necesita actualizar este para cambiar los colores. Ejemplo 9.1. Ejemplo de sintaxis de un archivo de configuración # global variables pageTitle = "Main Menu" bodyBgColor = #000000 tableBgColor = #000000 rowBgColor = #00ff00 [Customer] pageTitle = "Customer Info" [Login] pageTitle = "Login" focus = "username" Intro = """This is a value that spans more than one line. you must enclose it in triple quotes.""" # hidden section [.Database] host=my.domain.com db=ADDRESSBOOK user=php-user pass=foobar Los valores de las variables pueden estar entre comillas, mas no es necesario. Usted puede usar comillas simples o dobles. Si usted tuviera un valor que ocupe mas de una linea, coloque todo el valor entre tres comillas ("""). Usted puede colocar comentarios en un archivo de configuración con cualquier sintaxis que no sea valida en un archivo de configuración. Noso- tros recomendamos usar un # en el princio de cada linea. Este archivo de configuración tiene dos secciones. Los nombres de secciones debe estar entre corchetes []. Los nombres de sección pueden ser cadenas arbitrarias que no contengan los simbolos [ or ]. Las cuatro variables en la cabecera son varia- bles globales, o no son variables de sección. Estas variables son siempre cargadas del archivo de configuración. Si una sec- ción en particular fuera cargada, entonces las variables globales y las variables de esta sección son cargadas. Si una variable existe como global y dentro de una sección, la variable de sección será utilizada. Si usted tuviera dos variables en la misma sección con el mismo nombre, la ultima será utilizada. Los archivos de configuración son cargados en el template con una función incrustada {config_load}. (Ver También con- fig_load() ). Usted puede ocultar variables o secciones enteras colocando un punto antes del nombre de la variable. Esto es útil si su apli- cación lee los archivos de configuración y los datos sensibles a partir de ellos que la herramienta del template no lo necesita. Si usted tiene a otras personas realizando la edición de templates, usted tendra la certesa que ellos no leeran datos sensibles del archivo de configuración cargando estos en el template. Ver También {config_load}, $config_overwrite, get_config_vars(), clear_config() y config_load() 92
  • 99. Capítulo 10. Debugging Console Incluso en Smarty existe una consola para debug. La consola informa a usted de todos los templates incluidos, las variables definidas y las variables de archivos de configuración de la llamada actual del template. Incluso un template llamado "de- bug.tpl" viene con la distribución de Smarty el cual controla el formateo de la consola. Defina $debugging en true en el Smarty, y si es necesario defina $debug_tpl para la ruta del recurso debug.tpl (Esto es SMARTY_DIR por default). Cuando usted carga una pagina, una consola en javascript abrira una ventana popup y dara a usted el nombre de todos los templates incluidos y las variables definidas en la pagina actual. Para ver las variables disponibles para un template en particular, vea la función {debug}. Para desabilitar la consola del debug, defina $debugging en false. Usted puede activar temporalmente la consola del debug colocando SMARTY_DEBUG en la URL si usted activo esta opción con $debugging_ctrl. Nota Técnica: La consola de debug no funciona cuando usted usa la API fetch(), solo cuando estuviera usando display(). Es un conjunto de comandos javascript adicionados al final del template generado. Si a usted no le gusta el javascript, usted puede editar el template debug.tpl para formatear la salida como usted quiera. Los datos del de- bug no son guardados en cache y los datos del debug.tpl no son incluidos en la consola debug. nota: Los tiempos de carga de cada template y de archivos de configuración son en segundos, o en fracciones de segundo. Vea también troubleshooting, $error_reporting y trigger_error(). 93
  • 100. Parte III. Smarty For Programmers Tabla de contenidos 11. Constantes .................................................................................................................................... 96 SMARTY_DIR .................................................................................................................. 96 SMARTY_CORE_DIR ........................................................................................................ 96 12. Clase Variables de Smarty ............................................................................................................... 97 $template_dir ..................................................................................................................... 97 $compile_dir ...................................................................................................................... 97 $config_dir ........................................................................................................................ 98 $plugins_dir ....................................................................................................................... 98 $debugging ........................................................................................................................ 98 $debug_tpl ......................................................................................................................... 98 $debugging_ctrl .................................................................................................................. 99 $autoload_filters ................................................................................................................. 99 $compile_check .................................................................................................................. 99 $force_compile ................................................................................................................... 99 $caching ............................................................................................................................ 99 $cache_dir ........................................................................................................................ 100 $cache_lifetime ................................................................................................................. 100 $cache_handler_func .......................................................................................................... 100 $cache_modified_check ...................................................................................................... 100 $config_overwrite .............................................................................................................. 100 $config_booleanize ............................................................................................................ 101 $config_read_hidden .......................................................................................................... 101 $config_fix_newlines .......................................................................................................... 101 $default_template_handler_func ........................................................................................... 101 $php_handling ................................................................................................................... 101 $security .......................................................................................................................... 102 $secure_dir ....................................................................................................................... 102 $security_settings ............................................................................................................... 102 $trusted_dir ....................................................................................................................... 103 $left_delimiter ................................................................................................................... 103 $right_delimiter ................................................................................................................. 103 $compiler_class ................................................................................................................. 103 $request_vars_order ........................................................................................................... 103 $request_use_auto_globals ................................................................................................... 103 $error_reporting ................................................................................................................. 103 $compile_id ...................................................................................................................... 103 $use_sub_dirs .................................................................................................................... 104 $default_modifiers ............................................................................................................. 104 $default_resource_type ....................................................................................................... 104 13. La clase Methods() de Smarty ......................................................................................................... 105 14. Cache ......................................................................................................................................... 146 Configurando el Cache ........................................................................................................ 146 Multiples caches por pagina ................................................................................................. 148 Cache Groups .................................................................................................................... 149 Controlando salida de Cacheabilidad de plugins ....................................................................... 150 15. Caracteristicas Avanzadas ............................................................................................................... 152 Objetos ............................................................................................................................ 152 Prefilters .......................................................................................................................... 153 94
  • 101. Smarty For Programmers Postfilters ......................................................................................................................... 153 Filtros de salida ................................................................................................................. 154 Función manipuladora de cache ............................................................................................ 154 Recursos .......................................................................................................................... 156 16. Extendiendo Smarty con plugins ...................................................................................................... 160 Como funcionan los Plugins ................................................................................................. 160 Nombres convencionales ..................................................................................................... 160 Escribiendo Plugins ............................................................................................................ 161 Funciones de Template ........................................................................................................ 161 Modificadores ................................................................................................................... 163 Block Functions ................................................................................................................. 164 Funciones Compiladoras ..................................................................................................... 165 Prefiltros/Postfiltros ............................................................................................................ 166 Filtros de Salida ................................................................................................................. 167 Fuentes ............................................................................................................................ 167 Inserts .............................................................................................................................. 169 95
  • 102. Capítulo 11. Constantes Tabla de contenidos SMARTY_DIR .................................................................................................................................. 96 SMARTY_CORE_DIR ........................................................................................................................ 96 SMARTY_DIR Esta debe ser la ruta completa del path para la localización de los archivos de clases de Smarty. Si esta no fuera definida, Entonces Smarty intentara determinar el valor apropiado automáticamente. Si es definido, el path debe finalizar con una diagonal. Ejemplo 11.1. SMARTY_DIR <?php // set path to Smarty directory *nix style define('SMARTY_DIR','/usr/local/lib/php/Smarty/libs/'); // path to Smarty windows style define('SMARTY_DIR','c:/webroot/libs/Smarty/libs/'); // hack (not recommended) that works on both *nix and wind // Smarty is assumend to be in 'includes' dir under script define('SMARTY_DIR',str_replace("","/",getcwd()).'/includes/Smarty/libs/'); // include the smarty class Note 'S' is upper case require_once(SMARTY_DIR.'Smarty.class.php'); ?> Ver también $smarty.const y $php_handling constants SMARTY_CORE_DIR Esta debe ser la ruta completa de localización del sistema de archivos de Smarty core. Si no es definido, Smarty tomara por default esta constante de libs/ bajo el sub-directory SMARTY_DIR. Si es definida, la ruta debe terminar con una diagonal. Use esta constante cuando necesite incluir manualmente algun archivo de core.* Ejemplo 11.2. SMARTY_CORE_DIR <?php // load core.get_microtime.php require_once(SMARTY_CORE_DIR.'core.get_microtime.php'); ?> Ver también $smarty.const 96
  • 103. Capítulo 12. Clase Variables de Smarty Tabla de contenidos $template_dir ..................................................................................................................................... 97 $compile_dir ...................................................................................................................................... 97 $config_dir ........................................................................................................................................ 98 $plugins_dir ....................................................................................................................................... 98 $debugging ........................................................................................................................................ 98 $debug_tpl ......................................................................................................................................... 98 $debugging_ctrl .................................................................................................................................. 99 $autoload_filters ................................................................................................................................. 99 $compile_check .................................................................................................................................. 99 $force_compile ................................................................................................................................... 99 $caching ............................................................................................................................................ 99 $cache_dir ........................................................................................................................................ 100 $cache_lifetime ................................................................................................................................. 100 $cache_handler_func .......................................................................................................................... 100 $cache_modified_check ...................................................................................................................... 100 $config_overwrite .............................................................................................................................. 100 $config_booleanize ............................................................................................................................ 101 $config_read_hidden .......................................................................................................................... 101 $config_fix_newlines .......................................................................................................................... 101 $default_template_handler_func ........................................................................................................... 101 $php_handling ................................................................................................................................... 101 $security .......................................................................................................................................... 102 $secure_dir ....................................................................................................................................... 102 $security_settings ............................................................................................................................... 102 $trusted_dir ....................................................................................................................................... 103 $left_delimiter ................................................................................................................................... 103 $right_delimiter ................................................................................................................................. 103 $compiler_class ................................................................................................................................. 103 $request_vars_order ........................................................................................................................... 103 $request_use_auto_globals ................................................................................................................... 103 $error_reporting ................................................................................................................................. 103 $compile_id ...................................................................................................................................... 103 $use_sub_dirs .................................................................................................................................... 104 $default_modifiers ............................................................................................................................. 104 $default_resource_type ....................................................................................................................... 104 $template_dir Este es el nombre por default del directorio del template. Si usted no proporciona un tipo de recurso que incluya archivos, entonces estos se encontraran aquí. Por default "./templates", esto significa que lo buscara en el directorio del templa- tes en el mismo directorio que esta ejecutando el script PHP. Nota Técnica: No es recomendado colocar este directorio bajo el directorio document root de su servidor web. $compile_dir Ese es el nombre del directorio donde los templates compilados están localizados, Por default están en "./templates_c" , 97
  • 104. Clase Variables de Smarty esto significa que lo buscara en el directorio de templates en el mismo directorio que esta ejecutando el script php. Este di- rectorio debe tener permiso de escritura para el servidor web (ver la instalación). también $use_sub_dirs. Nota Técnica: Esa configuración debe ser un path relativo o un path absoluto. include_path no se usa para escribir archivos. Nota Técnica: No es recomendado colocar este directorio bajo el directorio document root de su servidor web. Ver también $compile_id y $use_sub_dirs. $config_dir Este es el directorio usado para almacenar archivos de configuración usados en los templates. El default es "./configs", esto significa que lo buscara en el directorio de templates en el mismo directorio que esta ejecutando el script php. Nota Técnica: No es recomendado colocar este directorio bajo el directorio document root de su servidor web. $plugins_dir Este es el directorio (o directorios) donde Smarty procurara ir a buscar los plugins que sean necesarios. El default es "plu- gins" bajo el SMARTY_DIR. Si usted proporciona un path relativo, Smarty procurara ir primero bajo el SMARTY_DIR, Entonces relativo para el cwd(current working directory), Entonces relativo para cada entrada de su PHP include path. Si $plugins_dir es un arreglo de directorios, Smarty buscara los plugins para cada directorio de plugins en el orden en el que fueron proporcionados. Nota Técnica: Para un mejor funcionamiento, no configure su plugins_dir para que use el include path PHP. Use un path absoluto, o un path relativo para SMARTY_DIR o el cwd (current working directory). Ejemplo 12.1. multiple $plugins_dir <?php $smarty->plugins_dir = array( 'plugins', // the default under SMARTY_DIR '/path/to/shared/plugins', '../../includes/my/plugins' ); ?> $debugging Este habilita el debugging console. La consola es una ventana de javascript que informa a usted sobre los archivos del tem- plate incluidos y las variables destinadas a la pagina del template actual. Ver también {debug}, $debug_tpl, y $debugging_ctrl $debug_tpl Este es el nombre del archivo de template usado para el debug de la consola. Por default, es nombrado debug.tpl y esta localizado en el SMARTY_DIR. Ver también $debugging y Debugging console 98
  • 105. Clase Variables de Smarty $debugging_ctrl Esto permite rutas alternativas para habilitar el debug. NONE no significa que métodos alternativos son permitidos. URL significa cuando la palabra SMARTY_DEBUG fue encontrada en el QUERY_STRING, que el debug está habilitado para la llamada del script. Si $debugging es true, ese valor es ignorado. Ver también Debugging console. $autoload_filters Si existe algun filtro que usted desea cargar en cada llamada de template, usted puede especificar cual variable usar y el Smarty ira automáticamente a cargarlos para usted. La variable es un arreglo asociativo donde las llaves son tipos de filtro y los valores son arreglos de nombres de filtros. Por ejemplo: <?php $smarty->autoload_filters = array('pre' => array('trim', 'stamp'), 'output' => array('convert')); ?> Ver también register_outputfilter(), register_prefilter(), register_postfilter() y load_filter() $compile_check En cada llamada de la aplicación PHP, Smarty prueba para ver si el template actual fue modificado (diferentes time stamp) desde la ultima compilación. Si este fue modificado, se recompilara el template. Si el template no fue compilado, este ira a compilar de cualquier manera esa configuración. Por default esta variable es determinada como true. Una vez que la aplica- ción esta en producción (los templates no seran modificados), el paso compile_check no es necesario. asegurese de determi- nar $compile_check a "false" para un mejor funcionamiento. Note que si usted modifica está para "false" y el archivo de template está modificado, usted *no* vera los cambios desde el template hasta que no sea recompilado. Si el caching esta habilitado y compile_check está habilitado, entonces los archivos de cache tienen que ser regenerados si el archivo de tem- plate es muy complejo o el archivo de configuración fue actualizado. vea $force_compile o clear_compiled_tpl(). $force_compile Este forza al Smarty a (re)compilar templates en cada llamada. Esta configuración sobrescribe $compile_check. Por default este es desabilitado. Es útil para el desarrollo y debug. Nunca debe ser usado en ambiente de producción. Si el cache esta habilitado, los archivo(s) de cache seran regenerados todo el tiempo. $caching Este informa al Smarty si hay o no salida de cache para el template en el $cache_dir. Por default tiene asignado 0, o desabi- litado. Si su template genera contenido redundante, es necesario ligar el $caching. Esto tendra un benefico significativo en el rendimiento. Usted puede tener multiples caches para el mismo template. Un valor de 1 o 2 caching habilitados. 1 anuncia a Smarty para usar la variable actual $cache_lifetime hasta determinar si el cache expiro. Un valor 2 anuncia a Smarty para usar el valor $cache_lifetime al tiempo en que le cache fue generado. De esta manera usted puede determinar el $cache_lifetime inmediatamente antes de buscar el template para tener el control cuando este cache en particular expira. Vea también is_cached(). Si $compile_check está habilitado, el contenido del cache se regenerara si alguno de los dos templates o archivos de confi- guración que son parte de este cache estuviera modificado. Si $force_compile está habilitado, el contenido del cache siem- pre sera regenerado. Ver También $cache_dir, $cache_lifetime, $cache_handler_func, $cache_modified_check y Caching section. 99
  • 106. Clase Variables de Smarty $cache_dir Este es el nombre del directorio donde los caches del template son almacenados. Por default es "./cache", esto significa que buscara el directorio de cache en el mismo directorio que ejecuta el scripts PHP. Este directorio debe ser regrabable por el servidor web (ver intalación). Usted puede usar también su propia función habitual de mantenimiento de cache para manipular los archivos de cache, que ignorará está configuración. Ver tambien $use_sub_dirs. Nota Técnica: Esta configuración debe ser cualquiera de estas dos, un path relativo o absoluto. include_path no es usado para escribir archivos. Nota Técnica: No es recomendado colocar este directorio bajo el directorio document root del servidor web. Ver también $caching, $use_sub_dirs, $cache_lifetime, $cache_handler_func, $cache_modified_check y Caching section. $cache_lifetime Este es la duración del tiempo en segundos que un cache de template es valido. Una vez que este tiempo está expirado, el cache sera regenerado. $caching debe ser asignado a "true" para $cache_lifetime hasta tener algún propósito. Un valor de -1 forza el cache a nunca expirar. Un valor de 0 forzara a que el cache sea siempre regenerado (bueno solo para probar, el mé- todo mas eficiente para desabilitar cache es asignar $caching = false.) Si $force_compile está habilitado, los archivos de cache serán regenerados todo el tiempo, efectivamente desabilitando ca- ching. Usted puede limpiar todos los archivos de cache con la función clear_all_cache(), o archivos individuales de cache (o grupos) con la función clear_cache(). Nota Técnica: Si usted quisiera dar a ciertos templates su propio tiempo de vida de cache, usted puede hacer esto asignando $caching = 2, entonces determina $cache_lifetime a un único valor justo antes de llamar display() o fetch(). $cache_handler_func Usted puede proporcionar una función por default para manipular archivos de cache en vez de usar el metodo incrustado usando el $cache_dir. Para mas detalles vea la sección cache handler function section. $cache_modified_check Si es asignado true, Smarty respetara el If-Modified-Since encabezado enviado para el cliente. Si el timestamp del archivo de cache no fue alterado desde la ultima visita, entonces un encabezado "304 Not Modified" sera enviado en vez del conte- nido. Esto funciona solamente en archivos de cache sin etiquetas {insert}. Ver también $caching, $cache_lifetime, $cache_handler_func, y Caching section. $config_overwrite Si es asignado true, las variables leidas en el archivo de configuración se sobreescribiran unas a otras. De lo contrario, las variables seran guardadas en un arreglo. Esto es útil si usted quiere almacenar arreglos de datos en archivos de configura- ción, solamente lista tiempos de cada elemento múltiplo. true por default. Ejemplo 12.2. Arreglo de variables de configuración Este ejemplo utiliza {cycle} para la salida a una tabla alternando colores por renglon rojo/verde/azul con $config_overwrite = false. 100
  • 107. Clase Variables de Smarty El archivo de configuración. # row colors rowColors = #FF0000 rowColors = #00FF00 rowColors = #0000FF El template con ciclo {section}. <table> {section name=r loop=$rows} <tr bgcolor="{cycle values=#rowColors#}"> <td> ....etc.... </td> </tr> {/section} </table> Ver también {config_load}, config files, get_config_vars(), clear_config() y config_load(). $config_booleanize Si es asignado true, los valores del archivo de configuración de on/true/yes y off/false/no se convierten en valores booleanos automáticamente. De esta forma usted puede usar los valores en un template como: {if #foobar#} ... {/if}. Si foobar estuvie- ra on, true o yes, la condición {if} se ejecutara. true es el default. $config_read_hidden Si es asignado true, esconde secciones (nombres de secciones comenzando con un periodo) en el archivo de configuración pueden ser leidos del template. Tipicamente desearia esto como false, de esta forma usted puede almacenar datos sensibles en el archivo de configuración como un parámetro de base de datos y sin preocuparse que el template los carge. false es el default. $config_fix_newlines Si es asignado true, mac y dos newlines (r y rn) en el archivo de configuración seran convertidos a n cuando estos fueran interpretados. true es el defaut. $default_template_handler_func Esta función es llamada cuando un template no puede ser obtenido desde su recurso. $php_handling Este informa al Smarty como manipular códigos PHP contenidos en los templates. Hay cuatro posibles configuraciones, siendo el default SMARTY_PHP_PASSTHRU. Observe que esto NO afectara los códigos php dentro de las etiquetas {php}{/php} en el template. • SMARTY_PHP_PASSTHRU - Smarty echos tags as-is. • SMARTY_PHP_QUOTE - Smarty abre comillas a las etiquetas de entidades html. • SMARTY_PHP_REMOVE - Smarty borra las etiquetas del template. 101
  • 108. Clase Variables de Smarty • SMARTY_PHP_ALLOW - Smarty ejecuta las etiquetas como código PHP. nota: Incrustar codigo PHP dentro del template es sumamente desalentador. Use custom functions o modifiers en vez de eso. $security $security true/false, el default es false. Security es bueno para situaciones cuando usted tiene partes inconfiables editando el template (via ftp por ejemplo) y usetd quiere reducir los riesgos de comportamiento de seguridad del sistema a través del lenguaje del template. Al habilitar la seguridad forza las siguientes reglas del lenguaje del template, a menos que especifique control con $security_settings: • Si $php_handling está asignado a SMARTY_PHP_ALLOW, este es implicitamente cambiado a SMARTY_PHP_PASSTHRU • Las funciones PHP no son permitidas en sentencias {if}, excepto quellas que esten especificadas en $security_settings • Los templates solo pueden ser incluidos en el directorio listado en arreglo $secure_dir • Los archivos locales solamente pueden ser traidos del directorio listado en $secure_dir usando el arreglo {fetch} • Estas etiquetas {php}{/php} no son permitidas • Las funciones PHP no son permitidas como modificadores, excepto si estan especificados en el $security_settings $secure_dir Este es un arreglo de todos los directorios locales que son considerados seguros. {include} y {fetch} usan estos (directorios) cuando security está habilitada. Ver también Security settings, y $trusted_dir. $security_settings Estas son usadas para cancelar o especificar configuraciones de seguridad cuando security esta habilitado. Estas son las po- sibles configuraciones. • PHP_HANDLING - true/false. la configuracion de $php_handling no es checada por security. • IF_FUNCS - Este es un arreglo de nombres de funciones PHP permitidas en los bloques IF. • INCLUDE_ANY - true/false. Si es asignado true, algun template puede ser incluido para un archivo de sistema, a pesar de toda la lista de $secure_dir. • PHP_TAGS - true/false. Si es asignado true, las etiquetas {php}{/php} son permitidas en los templates. • MODIFIER_FUNCS - Este es un arreglo de nombres de funciones PHP permitidas usadas como modificadores de va- riables. • ALLOW_CONSTANTS - true/false. Si es asignado true, la constante a travez de {$smarty.const.name} es autorizada en el template. El default es asignado "false" por seguridad. 102
  • 109. Clase Variables de Smarty $trusted_dir $trusted_dir solamente es usado cuando $security está habilitado. Este es un arreglo de todos los directorios que son consi- derados confiables. Los directorios confiables son de donde usted extraera sus script PHP que son ejecutados directamente desde el template con {include_php}. $left_delimiter Este es el delimitador izquierdo usado por el lenguaje de template. El default es "{". Ver también $right_delimiter y escaping smarty parsing. $right_delimiter Este es el delimitador derecho usado por el lenguaje de template. El default es "}". ver también $left_delimiter y escaping smarty parsing. $compiler_class Especifica el nombre del compilador de clases que Smarty usara para compilar los templates. El default es 'Smarty_Compiler'. Solo para usuarios avanzados. $request_vars_order El orden en el cual las variables requeridas seran registradas, similar al variables_order en el php.ini Ver también $smarty.request y $request_use_auto_globals. $request_use_auto_globals Especifica si el Smarty debe usar variables globales del php $HTTP_*_VARS[] ($request_use_auto_globals=false valor por default) o $_*[] ($request_use_auto_globals=true). Esto afecta a los templates que hacen uso de {$smarty.request.*}, {$smarty.get.*} etc. . Atención: Si usted asigna $request_use_auto_globals a true, variable.request.vars.order no tendran efecto los valores de configuracion de php gpc_order sera usados. $error_reporting Cuando este valor es asignado a non-null-value este valor es usado como un nivel error_reporting [http:/ / php.net/ error_reporting] dentro de display() y fetch(). Cuando debugging es habilitado este valor es ignorado y el error-level no es tocado. Ver también trigger_error(), debugging y Troubleshooting. $compile_id Identificador de compilación persistente. Como una alternativa para pasar el mismo compile_id a cada llamada de función, usted puede asignar este compile_id y este será usado implicitamente después. Con el compile_id usted puede trabajar con limitacion porque usted no puede usar el mismo $compile_dir para diferentes $template_dirs. Si usted asigna distintos compile_id para cada template_dir entonces Smarty puede hacer la compilacion de los templates por cada compile_id. 103
  • 110. Clase Variables de Smarty Si usted tiene por ejemplo un prefilter este localiza su template (es decir: traduce al lenguaje las dependencias por partes) y lo compila, entonces usted debe usar el lenguaje actual como $compile_id y usted obtendrá un conjunto de plantillas compi- ladas para cada idioma que usted utilice. otro ejemplo puede ser si usa el mismo directorio para compilar multiples dominios / multiples host virtuales. Ejemplo 12.3. $compile_id <?php $smarty->compile_id = $_SERVER['SERVER_NAME']; $smarty->compile_dir = 'path/to/shared_compile_dir'; ?> $use_sub_dirs Smarty puede crear subdirectorios bajo los directorios templates_c y cache si $use_sub_dirs es asignado true. En un ambien- te donde hay potencialmente decenas de miles de archivos creados, esto puede ayudar la velocidad de sistema de archivos. Por otro lado, algunos ambientes no permiten que procesos de PHP creen directorios, este debe ser desabilitado. El valor por defaulr es false (disabled). Los Sub directorios son mas eficientes, entonces aprovechelo si puede. Teóricamente usted obtiene mayor eficiencia en sun sistema de archivos con 10 directorios que contengan 100 archivos, que con un directorio que contenga 1000 archivos. Este era ciertamente un caso con Solaris 7 (UFS)... con un nuevo sistema de archivos como ext3 y un levantado especial, la diferencia es casi nula. Nota Técnica: $use_sub_dirs=true doesn't trabaja con safe_mode=On [http://php.net/features.safe-mode], esto es porque es switchable y porque puede estar en off por default. Nota Técnica: Desde Smarty-2.6.2 use_sub_dirs esta por default en false. Ver también $compile_dir, y $cache_dir. $default_modifiers Este es un arreglo de modificadores implicitamente aplicados para cada variable en el template. Por Ejemplo, cada variable HTML-escape por default, usa el arreglo('escape:"htmlall"'); Para hacer que las variables excenten los modificadores por de- fault, pase el modificador especial "smarty" con un valor de parámetro "nodefaults" modificando esto, tal como {$var|smarty:nodefaults}. $default_resource_type Este anuncia a Smarty el tipo de recurso a usar implicitamente. El valor por default es 'file', significa que $smarty->display('index.tpl'); y $smarty->display('file:index.tpl'); son identicos en el significado. Para mas detalles vea el capitulo resource. 104
  • 111. Capítulo 13. La clase Methods() de Smarty Tabla de contenidos append() ........................................................................................................................................... 106 append_by_ref ................................................................................................................................... 107 assign() ............................................................................................................................................ 108 assign_by_ref .................................................................................................................................... 109 clear_all_assign() ............................................................................................................................... 110 clear_all_cache .................................................................................................................................. 111 clear_assign() .................................................................................................................................... 112 clear_cache() ..................................................................................................................................... 113 clear_compiled_tpl() ........................................................................................................................... 114 clear_config() .................................................................................................................................... 115 config_load() ..................................................................................................................................... 116 display() ........................................................................................................................................... 117 fetch() .............................................................................................................................................. 119 get_config_vars() ............................................................................................................................... 121 get_registered_object() ........................................................................................................................ 122 get_template_vars() ............................................................................................................................ 123 is_cached() ....................................................................................................................................... 124 load_filter() ....................................................................................................................................... 125 register_block() ................................................................................................................................. 126 register_compiler_function .................................................................................................................. 127 register_function() .............................................................................................................................. 128 register_modifier() ............................................................................................................................. 129 register_object() ................................................................................................................................. 130 register_outputfilter() .......................................................................................................................... 131 register_postfilter() ............................................................................................................................. 132 register_prefilter() .............................................................................................................................. 133 register_resource ................................................................................................................................ 134 trigger_error ...................................................................................................................................... 135 template_exists() ................................................................................................................................ 136 unregister_block ................................................................................................................................ 137 unregister_compiler_function() ............................................................................................................. 138 unregister_function() .......................................................................................................................... 139 unregister_modifier() .......................................................................................................................... 140 unregister_object() ............................................................................................................................. 141 unregister_outputfilter() ...................................................................................................................... 142 unregister_postfilter() ......................................................................................................................... 143 unregister_prefilter() ........................................................................................................................... 144 unregister_resource() .......................................................................................................................... 145 105
  • 112. La clase Methods() de Smarty append() append()agregando elementos a una matriz asignada append() Descripción void append (mixed var) void append (string varname, mixed var [, bool merge]) Este es usado para adicionar un elemento en un arreglo asignado. Si usted adiciona una cadena como valor, este se converti- ra en un valor del arreglo y entonces lo adiciona. Usted puede explicitamente pasar pares de nombres/valores, o arreglos asociativos conteniendo los pares nombre/valor. Si usted pasa el tercer parámetro opcional como true, el valor se únira al arreglo actual en vez de ser adicionado. Nota Tecnica: El parametro merge es la llave respectiva del arreglo, asi si usted asocia dos arreglos indexados nu- mericamente, estos se sobre escriben uno al otro o tener como resultado llaves no-secuenciales. Este es diferente a la funcion array_merge() de PHP la cual limpia las llaves numericas y las vuelve a renumerar. Ejemplo 13.1. append <?php // passing name/value pairs $smarty->append("Name", "Fred"); $smarty->append("Address", $address); // passing an associative array $smarty->append(array('city' => 'Lincoln', 'state' => 'Nebraska')); ?> Ver también append_by_ref(), assign() y get_template_vars() 106
  • 113. La clase Methods() de Smarty append_by_ref append_by_refpasando valores por referencia append_by_ref Descipción void append_by_ref (string varname, mixed var [, bool merge]) Este es usado para pasar valores al templete por referencia. Si usted pasa una variable por referencia entonces cambiara su valor, el valor asignado sufrira el cambio también. Para objetos, append_by_ref() también envia una copia en memoria del objeto adicionado. Vea el manual de PHP en referenciando variables para una mejor explicación del asunto. Si usted pasa el tercer parámetro en true, el valor será mezclado con el arreglo en ves de ser adicionado. Nota Tecnica: El parametro merge es la llave respectiva del arreglo, asi si usted asocia dos arreglos indexados nu- mericamente, estos se sobre escriben uno al otro o tener como resultado llaves no-secuenciales. Este es diferente a la funcion array_merge() de PHP la cual limpia las llaves numericas y las vuelve a renumerar. Ejemplo 13.2. append_by_ref <?php // appending name/value pairs $smarty->append_by_ref("Name", $myname); $smarty->append_by_ref("Address", $address); ?> Ver también append() y assign(). 107
  • 114. La clase Methods() de Smarty assign() assign()pasando valores para el template assign() Descripción void assign (mixed var) void assign (string varname, mixed var) Usted puede explicitamente pasar pares de nombres/valores, o un arreglo asociativo conteniendo el par de nombre/valor. Ejemplo 13.3. assign() <?php // pasando pares de nombre/valor $smarty->assign('Name', 'Fred'); $smarty->assign('Address', $address); // pasando un arreglo asosiativo $smarty->assign(array('city' => 'Lincoln', 'state' => 'Nebraska')); // pasando un row desde una base de datos (eg adodb) $sql = 'select id, name, email from contacts where contact ='.$id; $smarty->assign('contact', $db->getRow($sql)); ?> Accesando estos en el template con {$Name} {$Address} {$city} {$state} {$contact.id}, {$contact.name},{$contact.email} ?> Para ver una asignacion de arreglos mas compleja {foreach} y {section} Vea también assign_by_ref(), get_template_vars(), clear_assign(), append() y {assign} 108
  • 115. La clase Methods() de Smarty assign_by_ref assign_by_refpasando valores por referencia assign_by_ref Descripción void assign_by_ref (string varname, mixed var) Este es usado para asignar valores por referencia al template en vez de hacer una copia. Vea el manual de PHP en la parte sobre referencia de variables para una explicación mas detallada. Nota Técnica: Este es usado para asignar valores por referencia al template. Si ested asigna una variable por refe- rencia entonces cambiara este valor, el valor asignado exprimentara el cambio también. Para objetos, as- sign_by_ref() también exite una copia del objetos asignado en memoria. Vea el manual de PHP en refereciando va- riables para una mejor explicación. Ejemplo 13.4. assign_by_ref() <?php // passing name/value pairs $smarty->assign_by_ref('Name', $myname); $smarty->assign_by_ref('Address', $address); ?> Ver también assign(), clear_all_assign(), append() y {assign} 109
  • 116. La clase Methods() de Smarty clear_all_assign() clear_all_assign()>limpia el valor de todas las variables asignadas clear_all_assign() Descripción void clear_all_assign (void) Ejemplo 13.5. clear_all_assign() <?php // passing name/value pairs $smarty->assign('Name', 'Fred'); $smarty->assign('Address', $address); // will output above print_r( $smarty->get_template_vars() ); // clear all assigned variables $smarty->clear_all_assign(); // will output nothing print_r( $smarty->get_template_vars() ); ?> Ver también clear_assign(), clear_config(), assign() y append() 110
  • 117. La clase Methods() de Smarty clear_all_cache clear_all_cachelimpia completamente el cache del template clear_all_cache void clear_all_cache ([int expire_time]) Como un parámetro opcional, usted puede proporcionar un periodo minimo en segundos que el archivo de cache debe tener antes de ser anulado. Ejemplo 13.6. clear_all_cache <?php // clear the entire cache $smarty->clear_all_cache(); ?> Ver también clear_cache(), is_cached() y caching 111
  • 118. La clase Methods() de Smarty clear_assign() clear_assign()limpia el valor de una variable asignada clear_assign() Descripción void clear_assign (mixed var) Este puede ser un valor simple, o un arreglo de valores. Ejemplo 13.7. clear_assign() <?php // clear a single variable $smarty->clear_assign('Name'); // clear multiple variables $smarty->clear_assign(array('Name', 'Address', 'Zip')); ?> Ver también clear_all_assign(), clear_config(), get_template_vars(), assign() y append() 112
  • 119. La clase Methods() de Smarty clear_cache() clear_cache()Esto limpia el cache de un template especifico clear_cache() Descripción void clear_cache (string template [, string cache_id [, string compile_id [, int expire_time]]]) Si usted tiene multiples caches en este archivo, usted puede limpiar un cache especifico proporcionando el cache_id como segundo parámetro Usted también puede pasar el $compile_id como un tercer parámetro. Usted puede "agrupar" templates conjuntamente de esta manera estos pueden ser removidos como un grupo. Vea el caching section para mayor información. Como un cuarto parámetro opcional, usted puede proporcionar un periodo minimo en segundos que el archivo de cache de- be tener antes de ser anulado. Ejemplo 13.8. clear_cache() <?php // clear the cache for a template $smarty->clear_cache('index.tpl'); // clear the cache for a particular cache id in an multiple-cache template $smarty->clear_cache('index.tpl', 'CACHEID'); ?> Ver también clear_all_cache() y caching. 113
  • 120. La clase Methods() de Smarty clear_compiled_tpl() clear_compiled_tpl()Esto limpia la vesion compilada del recurso de un template especifico clear_compiled_tpl() Descripción void clear_compiled_tpl ([string tpl_file [, string compile_id [, int exp_time]]]) Esto limpia la versión compilada del recurso del template especificado, o todos los archivos de templates compilados si no fueron especificados. si usted pasa $compile_id solo sera compilado este template especificado $compile_id es limpiado. Si usted lo pasa con ex_time, entonces solo compilara los templates anteriores al exp_time segundo seran limpiados, por de- fault todos los templates son compilados y limpiados independientemente de su tiempo de vida. Esta función es solo para uso avanzado, normalmente no es necesaria. Ejemplo 13.9. clear_compiled_tpl() <?php // clear a specific template resource $smarty->clear_compiled_tpl("index.tpl"); // clear entire compile directory $smarty->clear_compiled_tpl(); ?> 114
  • 121. La clase Methods() de Smarty clear_config() clear_config()Esto limpia todas las variables de configuración clear_config() Descripción void clear_config ([string var]) Esto limpia todas las variables de configuración asignadas. Si es proporcionado el nombre de una variable, solo esa variable es limpiada. Ejemplo 13.10. clear_config() <?php // clear all assigned config variables. $smarty->clear_config(); // clear one variable $smarty->clear_config('foobar'); ?> Ver también get_config_vars(), config variables, config files, {config_load}, config_load() y clear_assign() 115
  • 122. La clase Methods() de Smarty config_load() config_load()Carga el archivo de configuración y lo asigna al template config_load() Descripción void config_load (string file [, string section]) Esto carga el archivo de configuración de datos y lo asigna al template. Esto funciona idéntico a la función {config_load}. Nota Técnica: A partir de Smarty 2.4.0, las variables de template asignadas son mantenidas a través de fetch() y display(). Las variables de configuración cargadas de config_load() son siempre de alcance global. Los archivos de configuracion también son compilados para execución rapida, y respetar el force_compile y compile_check de con- figuración. Ejemplo 13.11. config_load() <?php // load config variables and assign them $smarty->config_load('my.conf'); // load a section $smarty->config_load('my.conf', 'foobar'); ?> Ver también {config_load}, get_config_vars(), clear_config(), y config variables 116
  • 123. La clase Methods() de Smarty display() display()Despliega el Template display() Descripción void display (string template [, string cache_id [, string compile_id]]) Este despliega el template diferente de fetch(). Cargando un tipo valido de path template resource. Como un segundo pará- metro opcional, usted puede pasar un identificador de cache. Vea el caching section para mayor información. Como tercer parametro opcional, usted puede pasar compile_id. Este en el caso que usted quira compilar diferentes versio- nes del mismo Tempalte, tal como tener separadas varios Templates compilados de diferentes lenguajes. Otro uso para com- pile_id es cuando usted usa mas de un $template_dir pero solo un $compile_dir. Ponga separado compile_id por cada $template_dir, de otra manera los tempate con el mismo nombre se sobre escibiran uno sobre otro. Uste puede poner tam- bién la variable $compile_id una vez en lugar de pasar esta por cada llamada a la función. Ejemplo 13.12. display() <?php include("Smarty.class.php"); $smarty = new Smarty; $smarty->caching = true; // only do db calls if cache doesn't exist if(!$smarty->is_cached("index.tpl")) { // dummy up some data $address = "245 N 50th"; $db_data = array( "City" => "Lincoln", "State" => "Nebraska", "Zip" => "68502" ); $smarty->assign("Name","Fred"); $smarty->assign("Address",$address); $smarty->assign($db_data); } // display the output $smarty->display("index.tpl"); ?> Use la sintaxis template resources para mostrar archivos fuera del directorio $template_dir. Ejemplo 13.13. Ejemplos de recursos de la función display <?php // absolute filepath $smarty->display('/usr/local/include/templates/header.tpl'); // absolute filepath (same thing) $smarty->display('file:/usr/local/include/templates/header.tpl'); 117
  • 124. La clase Methods() de Smarty // windows absolute filepath (MUST use "file:" prefix) $smarty->display('file:C:/www/pub/templates/header.tpl'); // include from template resource named "db" $smarty->display('db:header.tpl'); ?> Ver también fetch() y template_exists(). 118
  • 125. La clase Methods() de Smarty fetch() fetch()Retorna la salida del template fetch() Descripción string fetch (string template [, string cache_id [, string $compile_id]]) Este retorna la salida del template en vez de desplegarla. Proporcionando un tipo y path valido template resource. Como un segundo parámetro opcional, usted puede pasar el identificador de cache. vea el caching section para mayor información. Como tercer parametro opcional, usted puede pasar compile_id. Este en el caso que usted quira compilar diferentes versio- nes del mismo Tempalte, tal como tener separadas varios Templates compilados de diferentes lenguajes. Otro uso para com- pile_id es cuando usted usa mas de un $template_dir pero solo un $compile_dir. Ponga separado compile_id por cada $template_dir, de otra manera los tempate con el mismo nombre se sobre escibiran uno sobre otro. Uste puede poner tam- bién la variable $compile_id una vez en lugar de pasar esta por cada llamada a la función. Ejemplo 13.14. fetch() <?php include('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; // only do db calls if cache doesn't exist if(!$smarty->is_cached('index.tpl')) { // dummy up some data $address = '245 N 50th'; $db_data = array( 'City' => 'Lincoln', 'State' => 'Nebraska', 'Zip' => '68502' ); $smarty->assign('Name','Fred'); $smarty->assign('Address',$address); $smarty->assign($db_data); } // capture the output $output = $smarty->fetch('index.tpl'); // do something with $output here echo $output; ?> Ejemplo 13.15. Usando fetch() y enviando a un e-mail El template email_body.tpl 119
  • 126. La clase Methods() de Smarty Dear {$contact.name}, Welcome and thankyou for signing up as a member of our user group, Click on the link below to login with your user name of '{$contact.login_id}' so you can post in our forums. http://{$smarty.server.SERVER_NAME}/index.php?page=login List master Some user group {include file="email_disclaimer.tpl"} El template email_disclaimer.tpl usando el modificador {textformat}. {textformat wrap=40} Unless you are named "{$contact.name}", you may read only the "odd numbered words" (every other word beginning with the first) of the message above. If you have violated that, then you hereby owe the sender 10 GBP for each even numbered word you have read {/textformat} y el script de PHP usando la función mail() [http://php.net/function.mail] <?php // get contact from database eg using pear or adodb $query = 'select name, email, login_id from contacts where contact_id='.$contact_id; $contact = $db->getRow($sql); $smarty->assign('contact', $contact); mail($contact['email'], 'Subject', $smarty->fetch('email_body.tpl')); ?> Ver también {fetch} display(), {eval}, y template_exists(). 120
  • 127. La clase Methods() de Smarty get_config_vars() get_config_vars()retorna el valor asignado a la variable de configuración get_config_vars() Descripción array get_config_vars ([string varname]) Si no tiene un parámetro asignado, un arreglo de todas las variables de los archivos de configuración es retornado. Ejemplo 13.16. get_config_vars() <?php // get loaded config template var 'foo' $foo = $smarty->get_config_vars('foo'); // get all loaded config template vars $config_vars = $smarty->get_config_vars(); // take a look at them print_r($config_vars); ?> Ver también clear_config(), {config_load}, config_load() y get_template_vars(). 121
  • 128. La clase Methods() de Smarty get_registered_object() get_registered_object()Este retorna una referencia para un objeto registrado. get_registered_object() Descripción array get_registered_object (string object_name) Este es útil dentro de una función habitual cuando usted necesita acesar directamente a un objeto registrado. Ver objects pa- ra mas información; Ejemplo 13.17. get_registered_object() <?php function smarty_block_foo($params, &$smarty) { if (isset($params['object'])) { // get reference to registered object $obj_ref = &$smarty->get_registered_object($params['object']); // use $obj_ref is now a reference to the object } } ?> Ver también register_object(), unregister_object() y objects section 122
  • 129. La clase Methods() de Smarty get_template_vars() get_template_vars()Retorna el valor asignado a una variable get_template_vars() descripción array get_template_vars ([string varname]) Si no tiene un parámetro dado, un arreglo de todas las variables asignadas es retornado. Ejemplo 13.18. get_template_vars <?php // get assigned template var 'foo' $foo = $smarty->get_template_vars('foo'); // get all assigned template vars $tpl_vars = $smarty->get_template_vars(); // take a look at them print_r($tpl_vars); ?> Ver también assign(), {assign}, assign_by_ref(), append(), clear_assign(), clear_all_assign() y get_config_vars() 123
  • 130. La clase Methods() de Smarty is_cached() is_cached()Retorna true si hay cache valido para ese template is_cached() Descripción bool is_cached (string template [, string cache_id [, string compile_id]]) Esto solamente funciona si caching está asignado a true. ver también caching section. Ejemplo 13.19. is_cached() <?php $smarty->caching = true; if(!$smarty->is_cached("index.tpl")) { // do database calls, assign vars here } $smarty->display("index.tpl"); ?> Usted también puede pasar un identificador de $cache como un segundo parámetro opcional en el caso que usted quiera multiples caches para el template dado. Usted puede proporcionar el identidicador como un tercer parametro opcional. Si usted omite ese parametro la persistencia del $compile_id es usada. Si usted no quiere pasar el identificador de cache solamente quiere pasar el compile id debe pasar null como el identidfica- dor de cache. Ejemplo 13.20. is_cached() con templates con multiple-cache <?php $smarty->caching = true; if(!$smarty->is_cached("index.tpl", "FrontPage")) { // do database calls, assign vars here } $smarty->display("index.tpl", "FrontPage"); ?> Nota técnica: Si is_cached retorna true el carga actualmente la salida del cache y lo guarda internamente. cual- quier subsecuente llama a display() o fetch() y retorna este internamente guardando la salida y no intenta volver a cargar el archivo del cache. Esto previene una condicion de la carrera que puede ocurrir cuando un segundo proce- so limpie el cache entre las llamadas a is_cached mostradas en el ejemplo de arriba. Esto significa tambien llamar al clear_cache() y otros cambios en el cache-settings que no tiene efecto despues que is_cached retorna true. Ver también clear_cache(), clear_all_cache(), y caching section. 124
  • 131. La clase Methods() de Smarty load_filter() load_filter()Carga un filtro de plugin load_filter() Descripción void load_filter (string type, string name) El primer argumento especifíca el tipo de filtro a cargar y puede ser uno de los siguientes: 'pre', 'post', o 'output'. El segundo argumento especifíca el nombre del filtro del plugin, por ejemplo, 'trim'. Ejemplo 13.21. loading filter plugins <?php $smarty->load_filter('pre', 'trim'); // load prefilter named 'trim' $smarty->load_filter('pre', 'datefooter'); // load another prefilter named 'datefooter' $smarty->load_filter('output', 'compress'); // load output filter named 'compress' ?> Ver también register_prefilter(), register_postfilter(), register_outputfilter(), $autoload_filters y Advanced features. 125
  • 132. La clase Methods() de Smarty register_block() register_block()Registra dinamicamente bloques de funciones de plugins register_block() Descripción void register_block (string name, mixed impl, bool cacheable, mixed cache_attrs) Use este para registrar dinámicamente bloques de funciones de plugins. Pase el bloque de nombres de función, seguido por una llamada de función PHP que implemente esto. La llamada de una funcion-php impl puede ser cualquier (a) cadena conteniendo el nombre de la función o (b) un arreglo con el formato array(&$object, $method) con &$object siendo la referencia a un objeto y $method siendo una cade- na conteniendo el nombre del método o (c) un arreglo con el formato array(&$class, $method) con $class siendo un nombre de clase y $method siendo un método de esta clase. cacheable y cache_attrs pueden ser omitidos en la mayoria de los casos. Vea Controlando modos de salida de cache de los plugins para saber como usar las propiedades. Ejemplo 13.22. register_block() <?php $smarty->register_block('translate', 'do_translation'); function do_translation ($params, $content, &$smarty, &$repeat) { if (isset($content)) { $lang = $params['lang']; // do some translation with $content return $translation; } } ?> Donde el template es: {* template *} {translate lang="br"} Hello, world! {/translate} Ver también unregister_block() y Plugin Block Functions. 126
  • 133. La clase Methods() de Smarty register_compiler_function register_compiler_functionRegistra dinamicamente un plugin de una funcion compiladora register_compiler_function Descripción bool register_compiler_function (string name, mixed impl, bool cacheable) Pase el nombre de la función compiladora, seguido por la función PHP que implemente esto. La llamada a la funcion-php impl puede ser a. a una cadena conteniendo el nombre de la función b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre del método c. un arreglo con la forma array(&$class, $method) con $class siendo el nombre de una clase y $method siendo el método de esta clase. cacheable puede ser omitido en la mayoria de los casos. Vea Controlando modos de Salida de Cache de los Plugins para ob- tener mayor información. Ver también unregister_compiler_function() y Plugin Compiler Functions. 127
  • 134. La clase Methods() de Smarty register_function() register_function()Registra dinamicamente un plugin de función para un template register_function() Descripción void register_function (string name, mixed impl [, bool cacheable [, mixed cache_attrs]]) Pase en el template el nombre de la función, seguido por el nombre de la función PHP que implementa esto. La llamada a la funcion-php impl puede ser: a. a una cadena conteniendo el nombre de la función o b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre del método c. un arreglo con la forma array(&$class, $method) con $class siendo el nombre de una clase y $method siendo un metodo de esa clase. cacheable y cache_attrs pueden ser omitidos en la mayoria de los caasos. Vea Controlando modos de Salida Cache de los Plugins para obtener mayores informes. Ejemplo 13.23. register_function() <?php $smarty->register_function('date_now', 'print_current_date'); function print_current_date($params, &$smarty) { if(empty($params['format'])) { $format = "%b %e, %Y"; } else { $format = $params['format']; return strftime($format,time()); } } ?> y en el template {date_now} {* or to format differently *} {date_now format="%Y/%m/%d"} Ver también unregister_function() y Plugin functions. 128
  • 135. La clase Methods() de Smarty register_modifier() register_modifier()mofidica dinámicamente plugins registrados register_modifier() Descripción void register_modifier (string name, mixed impl) Pase en el template el nombre del modificador, seguido de la función PHP que implemente esto. La llamada de la funcion-php impl puede ser a. una cadena conteniendo el nombre de la función b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre de un metodo c. un arreglo con la forma array(&$class, $method) con $class siendo el nombre de una clase y $method siendo un metodo de esta clase. Ejemplo 13.24. register_modifier() <?php // let's map PHP's stripslashes function to a Smarty modifier. $smarty->register_modifier('sslash', 'stripslashes'); ?> template <?php {* use 'sslash' to strip slashes from variables *} {$var|sslash} ?> Ver También unregister_modifier(), register_function(), modifiers, Extending Smarty with plugins y Creating Plugin modi- fiers, 129
  • 136. La clase Methods() de Smarty register_object() register_object()Registr un objeto para usar en el template register_object() Descripción void register_object (string object_name, object object, array allowed_methods_properties, boolean format, array block_methods) Vea object section para ejemplos. Vea también get_registered_object(), y unregister_object(). 130
  • 137. La clase Methods() de Smarty register_outputfilter() register_outputfilter()Registra dinamicamente filtros de salida register_outputfilter() Descripción void register_outputfilter (mixed function) Use este para registrar dinámicamente filtros de salida para operaciones en la salida del template antes de mostrarlo. Vea Filtros de Salida de Templates para mayores informes de como configurar una función de filtro de salida. La llamada de la funcion-php function puede ser a. una cadena conteniendo un nombre de función b. un arreglo con la forma array(&$object, $method) con &$object siendo referencia a un objeto y $method sien- do una cadena conteniendo el nombre de un metodo c. un arreglo con la forma array(&$class, $method) con $class siendo el nombre de la clase y $method siendo un método de esta clase. Vea también unregister_outputfilter(), register_prefilter(), register_postfilter(), load_filter(), $autoload_filters y template output filters. 131
  • 138. La clase Methods() de Smarty register_postfilter() register_postfilter()Resgistr dinamicamente postfiltros register_postfilter() Descripción void register_postfilter (mixed function) Use esto para registrar dinámicamente postfiltros para correr templates directos después de ser compilados. Vea postfiltros de template para mayores informes de como configurar funciones de postfiltering. La llamada de la funcion-php function puede ser: a. una cadena conteniendo un nombre de función b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre de un método c. un arreglo con la forma array(&$class, $method) con $class siendo un nombre de clase y $method siendo un método de esta clase. Vea También unregister_postfilter(), register_prefilter(), register_ouputfilter(), load_filter(), $autoload_filters y template output filters. 132
  • 139. La clase Methods() de Smarty register_prefilter() register_prefilter()Registra dinamicamente prefiltros register_prefilter() Descripción void register_prefilter (mixed function) Use esto para registrar prefiltros dinámicamente para correr templates antes de que estos sean compilados. Vea template prefilters para mayores informes de como configurar una función de prefiltering. La llamada de la funcion-php function puede ser: a. una cadena conteniendo un nombre de función b. un arreglo con la forma array(&$object, $method) con &$object siendo una referencia para un objeto y $method siendo una cadena conteniendo el nombre de un método c. un arreglo con la forma array(&$class, $method) con $class siendo un nombre de clase y $method siendo un método de esta clase. Ver también unregister_prefilter(), register_postfilter(), register_ouputfilter(), load_filter(), $autoload_filters y template out- put filters. 133
  • 140. La clase Methods() de Smarty register_resource register_resourceRegistra dinamicamente un plugin de recurso register_resource Descripción void register_resource (string name, array resource_funcs) Use esto para registrar dinámicamente un recurso de plugin con Smarty. Pase el nombre o el recurso y o el arreglo de fun- ciones que implementa esto. Vea template resources para mayor información de como configurar una función para mandar llamar templates. Nota técnica: El nombre del recurso debe tener al menos dos caracteres de largo. Un nombre de recurso de un ca- rácter será ignorado y usado como parte del path del archivo como, $smarty->display('c:/path/to/index.tpl'); La php-funcion-array resource_funcs debe tener 4 o 5 elementos. Con 4 elementos los elementos son las llamadas para las respectivas funciones de recurso "source", "timestamp", "secure" y "trusted". Con 5 elementos el primer elemento tiene que ser un objeto por referencia o un nombre de clase del objeto o una clase implementando el recurso y los 4 elementos si- guientes tiene que ser los nombres de los métodos implementando "source", "timestamp", "secure" y "trusted". Ejemplo 13.25. register_resource <?php $smarty->register_resource('db', array('db_get_template', 'db_get_timestamp', 'db_get_secure', 'db_get_trusted')); ?> Ver también unregister_resource() y template resources 134
  • 141. La clase Methods() de Smarty trigger_error trigger_errorDespliega un mensaje de error trigger_error Descripción void trigger_error (string error_msg [, int level]) Esta función puede ser usada para la salida de un mensaje de error usando Smarty. El parámetro level es uno de los valores usados para la función de php trigger_error() [http://php.net/trigger_error], ex.: E_USER_NOTICE, E_USER_WARNING, etc. Por default es E_USER_WARNING. Ver también $error_reporting, debugging y Troubleshooting. 135
  • 142. La clase Methods() de Smarty template_exists() template_exists()Verifica si el template especificado existe template_exists() Descripción bool template_exists (string template) Este puede aceptar un path para el template en el filesystem o un recurso de cadena especificando el template. Ejemplo 13.26. template_exists() Este ejemplo utiliza $_GET['page'] este incluye el contenido del template. Si el template no existe entonces un error de pa- gina es deplegado en su lugar. El page_container.tpl <html> <head><title>{$title}</title></head> <body> {include file='page_top.tpl'} {* include middle content page *} {include file=$page_mid} {include file='page_footer.tpl'} </body> y el script PHP <?php // set the filename eg index.inc.tpl $mid_template = $_GET['page'].'.inc.tpl'; if( !$smarty->template_exists($mid_template) ){ $mid_template = 'page_not_found.inc.tpl'; } $smarty->assign('page_mid', $mid_template); $smarty->display('page_container.tpl'); ?> Ver también display(), fetch(), {include} y {insert} 136
  • 143. La clase Methods() de Smarty unregister_block unregister_blockDes-registra dinamicamente un plugin de bloque de funciones unregister_block Descripción void unregister_block (string name) Use esto para des-registrar dinámicamente un bloque de funciones de plugin. Pase en el bloque el nombre de la función. Ver también register_block() y Block Functions Plugins. 137
  • 144. La clase Methods() de Smarty unregister_compiler_function() unregister_compiler_function()des-registrar dinámicamente una función de compilación unregister_compiler_function() Descripción void unregister_compiler_function (string name) Pase el nombre de la función compiladora. Ver también register_compiler_function() y Plugin Compiler Functions. 138
  • 145. La clase Methods() de Smarty unregister_function() unregister_function()des-registrar dinámicamente una función de plugin del template unregister_function() Descripción void unregister_function (string name) Pase en el template el nombre de la función. Ejemplo 13.27. unregister_function() <?php // nosotros no queremos que el dise&ntilde;ador del template tenga acceso a // nuestros archivos de sistema $smarty->unregister_function("fetch"); ?> Ver también register_function() . 139
  • 146. La clase Methods() de Smarty unregister_modifier() unregister_modifier()des-registrar dinámicamente un modificador de plugin unregister_modifier() Descripción void unregister_modifier (string name) Pase en el template el nombre del modificador. Ejemplo 13.28. unregister_modifier() <?php // nosotros no queremos que el dise&ntilde;ador de template use strip tags // para los elementos $smarty->unregister_modifier("strip_tags"); ?> Ver también register_modifier() y Plugin modifiers, 140
  • 147. La clase Methods() de Smarty unregister_object() unregister_object()Des-registra dinamicamente un objeto unregister_object() Descripción void unregister_object (string object_name) Ver también register_object() y objects section 141
  • 148. La clase Methods() de Smarty unregister_outputfilter() unregister_outputfilter()des-registra dinámicamente un filtro de salida unregister_outputfilter() Descripción void unregister_outputfilter (string function_name) Use este para des-registrar dinámicamente un filtro de salida. Ver también register_outputfilter() y template output filters. 142
  • 149. La clase Methods() de Smarty unregister_postfilter() unregister_postfilter()Des-registra dinamicamente un postfiltro unregister_postfilter() Descripción void unregister_postfilter (string function_name) Ver también register_postfilter() y template post filters. 143
  • 150. La clase Methods() de Smarty unregister_prefilter() unregister_prefilter()Des-registra dinamicamente un prefiltro unregister_prefilter() Descripción void unregister_prefilter (string function_name) Ver también register_prefilter() y pre filters. 144
  • 151. La clase Methods() de Smarty unregister_resource() unregister_resource()Des-registra dinamicamente un plugin de recurso unregister_resource() Descripción void unregister_resource (string name) Pase en el parámetro el nombre del recurso. Ejemplo 13.29. unregister_resource() <?php $smarty->unregister_resource("db"); ?> Ver también register_resource() y template resources 145
  • 152. Capítulo 14. Cache Tabla de contenidos Configurando el Cache ........................................................................................................................ 146 Multiples caches por pagina ................................................................................................................. 148 Cache Groups .................................................................................................................................... 149 Controlando salida de Cacheabilidad de plugins ....................................................................................... 150 Caching es usado para aumentar la velocidad de llamada de display() o fetch() salvando esto en un archivo de salida. Si hay una versión de cache disponible para la llamada, este es mostrado en vez de regresar la salida de datos. Caching puede hacer cosas tremendamente rápidas, especialmente templates con largo tiempo de computo. Desde la salida de datos de display() o fetch() está en cache, un archivo de cache podría ser compuesto por diversos archivos de templates, archivos de configura- ción, etc. Dado que sus templates son dinámicos, es importante tener cuidado de como usa la cache y por cuanto tiempo. Por ejemplo, si usted esta mostrando la pagina principal de su web site y esta no tiene cambios muy frecuentes en su contenido, esta pue- de funcionar bien en la cache por una hora o mas. por otro lado, si usted esta mostrando una pagina con un mapa de tiempo que contenga nueva información por minuto, no tiene sentido hacer cache nuestra página. Configurando el Cache Lo primero que se tiene que hacer es habilitar el cache. esto es configurar $caching = true (o 1.) Ejemplo 14.1. Habilitando Cache <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; $smarty->display('index.tpl'); ?> Con el caching habilitado, la llamada a la función display('index.tpl') traera el template como siempre, pero también salvara una copia en el archivo de salida (una copia de cache) en el $cache_dir. En la proxima llamada de display('index.tpl'), la co- pia en cache sera usada en vez de traer nuevamente el template. Nota Técnica: Los archivos en el $cache_dir son nombrados similarmente al nombre del archivo de template. Aunque ellos tengan una extensión ".php", ellos no son realmente scripts ejecutables de php. No edite estos archi- vos! Cada pagina en cache tiene un periodo de tiempo limitado determinado por $cache_lifetime. El default del valor es 3600 se- gundos, o 1 hora. Después de este tiempo expira, el cache es regenerado. Es posible dar tiempos individuales para caches con su propio tiempo de expiración para configuración $caching = 2. Vea la documentación en $cache_lifetime para mas detalles. Ejemplo 14.2. Configurando cache_lifetime por cache 146
  • 153. Cache <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = 2; // lifetime is per cache // set the cache_lifetime for index.tpl to 5 minutes $smarty->cache_lifetime = 300; $smarty->display('index.tpl'); // set the cache_lifetime for home.tpl to 1 hour $smarty->cache_lifetime = 3600; $smarty->display('home.tpl'); // NOTE: the following $cache_lifetime setting will not work when $caching = 2. // The cache lifetime for home.tpl has already been set // to 1 hour, and will no longer respect the value of $cache_lifetime. // The home.tpl cache will still expire after 1 hour. $smarty->cache_lifetime = 30; // 30 seconds $smarty->display('home.tpl'); ?> Si $compile_check está habilitado, cada archivo de template y archivo de configuración que está involucrado con el archivo en cache es checado por modificadores. Si alguno de estos archivos fue modificado desde que el ultimo cache fue generado, el cache es regenerado inmediatamente. Esto es una forma de optimizar ligeramente el rendimiento de las cabeceras, dejar $compile_check determinado false. Ejemplo 14.3. Habilitando $compile_check <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; $smarty->compile_check = true; $smarty->display('index.tpl'); ?> Si $force_compile está habilitado, los archivos de cache siempre seran regenerados. Esto definitivamente desactiva el ca- ching. $force_compile generalmente es usado para propositos de debug solamente, una forma mas eficiente de desactivar el caching es asignando $caching = false (ó 0.) La función is_cached() puede ser usada para testar si un template tiene un cache valido o no. Si usted tiene un template con cache que requiera alguna cosa como un retorno de base de datos, usted puede usar esto para saltar este proceso. Ejemplo 14.4. Usando is_cached() <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; if(!$smarty->is_cached('index.tpl')) { // No cache available, do variable assignments here. $contents = get_database_contents(); $smarty->assign($contents); } 147
  • 154. Cache $smarty->display('index.tpl'); ?> Usted puede guardar partes de su pagina dinámica con la función de template {insert}. Vamos a decir que su pagina entera puede tener cache excepto para un banner que es mostrado abajo del lado derecho de su pagina. Usando la función insert pa- ra el banner, usted puede guardar ese elemento dinámico dentro de un contenido de cache. Vea la documentación en {insert} para detalles y ejemplos. Usted puede limpiar todos los archivos de cache con la función clear_all_cache(), los archivos de cache individuales (o gru- pos) con la función clear_cache(). Ejemplo 14.5. Limpiando el cache <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; // clear out all cache files $smarty->clear_all_cache(); // clear only cache for index.tpl $smarty->clear_cache('index.tpl'); $smarty->display('index.tpl'); ?> Multiples caches por pagina Usted puede tener multiples archivos de cache para una simples llamada de display() o fetch(). Vamos a decir que una lla- mada a display('index.tpl') debe tener varios contenidos de salida diferentes dependiendo de alguna condición, y usted quie- re separar los caches para cada una. Usted puede hacer esto pasando un cache_id como un segundo parámetro en la llamada de la función. Ejemplo 14.6. Pasando un cache_id para display() <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; $my_cache_id = $_GET['article_id']; $smarty->display('index.tpl',$my_cache_id); ?> Arriba, nosotros pasamos la variable $my_cache_id a display() con el cache_id. Para cada valor unico de $my_cache_id, un cache por separado sera generado para cada index.tpl. En este ejemplo, "article_id" fue pasado en URL y es usado como el cache_id. Nota Técnica: Tenga mucho cuidado cuando pase valores del cliente (web browser) dentro de Smarty (o alguna aplicación PHP). Aunque el ejemplo de arriba usar el article_id desde una URL parece facil, esto podría tener fata- 148
  • 155. Cache les consecuencias. El cache_id es usado para crear un directorio en el sistema de archivos, entonces si el usuario decide pasar un valor extremadamente largo para article_id, o escribir un script que envia article_ids aleatorios en un paso rápido, esto posiblemente podría causar problemas a nivel del servidor. Tenga la certeza de limpiar algún dato pasado antes de usarlo. En este ejemplo, tal vez usted sabia que el article_id tiene un largo de 10 caracteres es- te es constituido solamente de alfanuméricos, y debe ser un article_id valido en la base de datos. Verifique esto! Asegurarse de pasar el mismo cache_id como el segundo parámetro para is_cached() y clear_cache(). Ejemplo 14.7. Pasando un cache_id para is_cached() <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; $my_cache_id = $_GET['article_id']; if(!$smarty->is_cached('index.tpl',$my_cache_id)) { // No cache available, do variable assignments here. $contents = get_database_contents(); $smarty->assign($contents); } $smarty->display('index.tpl',$my_cache_id); ?> Usted puede limpar todos los caches para un cache_id en particular pasando el primer parámetro null a clear_cache().. Ejemplo 14.8. Limpando todos los caches para un cache_id en particular <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; // clear all caches with "sports" as the cache_id $smarty->clear_cache(null,"sports"); $smarty->display('index.tpl',"sports"); ?> De esta manera, usted puede "agrupar" sus caches conjuntamente dando les el mismo cache_id. Cache Groups Usted puede hacer agrupamientos mas elaborados configurando grupos de cache_id. Esto se logra con la separación de cada sub-grupo con una barra vertical "|" en el valor del cache_id. Usted puede tener tantos sub-grupos como guste. Usted puede pensar que los grupos de cache son parecidos a un directorio para organizar. por ejemplo, un grupo de cache con "a|b|b" podria pensarse como la estructura del directorio "a/b/c/". clear_cache(null,"a|b|c") esto seria para quitar los ar- chivos "/a/b/c/*". clear_cache(null,"a|b") esto seria para quitar los archivos "/a/b/*". Si usted espicifica el compile_id como clear_cache(null,"a|b","foo") este tratara de agregarlo al grupo de cache "/a/b/c/foo/". Si usted especifica el nombre del tem- plate tal como clear_cache("foo.tpl","a|b|c") entonces el smarty intentara borrar "/a/b/c/foo.tpl". Usted no puede borrar un nombre de template especifico bajo multiples grupos de cache como "/a/b/*/foo.tpl", el grupo de cache trabaja solo de iz- 149
  • 156. Cache quierda a derecha. Usted puede necesitar para su grupos de templates un unico grupo de cache jerarquico para poder lim- piarlos como grupos. El agupamiento de cache no debe ser confundido con su directorio jerarquico del template, El agrupamiento de cache no tie- ne ninguna ciencia de como sus templates son estructurados. Por ejemplo, si usted tiene una estructura dis- play('themes/blue/index.tpl'), usted no puede limpiar el cache para todo bajo el diretorio "themes/blue". Si usted quiere ha- cer esto, usted debe agruparlos en el cache_id, como display('themes/blue/index.tpl','themes|blue'); Entonces usted puede limpiar los caches para el tema azul con clear_cache(null,'themes|blue'); Ejemplo 14.9. Grupos de cache_id <?php require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; // clear all caches with "sports|basketball" as the first two cache_id groups $smarty->clear_cache(null,"sports|basketball"); // clear all caches with "sports" as the first cache_id group. This would // include "sports|basketball", or "sports|(anything)|(anything)|(anything)|..." $smarty->clear_cache(null,"sports"); // clear the foo.tpl cache file with "sports|basketball" as the cache_id $smarty->clear_cache("foo.tpl","sports|basketball"); $smarty->display('index.tpl',"sports|basketball"); ?> 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(), re- gister_compiler_function() y register_function() es llamado $cacheable y el default es true que es también el comportamien- to 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 ca- cheados 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"; 150
  • 157. Cache } $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 pa- gina 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. 151
  • 158. Capítulo 15. Caracteristicas Avanzadas Tabla de contenidos Objetos ............................................................................................................................................ 152 Prefilters .......................................................................................................................................... 153 Postfilters ......................................................................................................................................... 153 Filtros de salida ................................................................................................................................. 154 Función manipuladora de cache ............................................................................................................ 154 Recursos .......................................................................................................................................... 156 Objetos El Smarty permite acceso a objetos de PHP a través de sus templates. Hay dos formas de accesarlos. Una forma es registran- do objetos para el template, entonces acceselos mediante sintaxis similar a las funciones habituales. La otra es asignar obje- tos 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 propieda- des. 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áme- tro 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 fun- ciones de costumbre los obtienen. Un arreglo asociativo es pasado como el primer parámetro, y el objeto smarty como el se- gundo. Si usted quiere que los parámetros pasados uno de cada vez por cada argumento pasen como parámetros de un obje- to 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 compor- tan como block-function-plugins. Ejemplo 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 152
  • 159. Caracteristicas Avanzadas $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)} Prefilters Los prefilters de Template son funciones de PHP que corren sus templates antes de ser compilados. Esto es bueno para pro- cesar por adelantado sus templates y remover comentarios no deseados, vigilando a las personas que coloquen en sus tem- plates, etc. Los Prefilters pueden ser registrado o cargado del directorio de plugins usando la función load_filter() o por la configura- ción de la variable $autoload_filters. El Smarty pasara el código fuente del template como el primer argumento, y espera que la función le retorne el código fuen- te del template resultante. Ejemplo 15.2. usando un prefiltro prefilter de template <?php // ponga esto en su aplicación function remove_dw_comments($tpl_source, &$smarty) { return preg_replace("/<!--#.*-->/U","",$tpl_source); } // registrar el prefilter $smarty->register_prefilter("remove_dw_comments"); $smarty->display("index.tpl"); ?> Esto eliminara todos los comentarios en el codigo del template. Postfilters Los postfilters de template son funciones de PHP con las cuales sus templates son corridos inmediatamente después de ser compilados. Los postfilters pueden ser registrado o cargados del directorio de plugins usando la función load_filter() o por la variable de configuración $autoload_filters. El Smarty pasara el código fuente del template compilado como el primer ar- gumento, y espera que la función retorne el resultado del procesamiento. 153
  • 160. Caracteristicas Avanzadas Ejemplo 15.3. Usando un postfilter de template <?php // ponga esto en su aplicaci&oacute;n function add_header_comment($tpl_source, &$smarty) { return "<?php echo "<!-- Created by Smarty! -->;n" ?>;n".$tpl_source; } // registra el postfilter $smarty->register_postfilter("add_header_comment"); $smarty->display("index.tpl"); ?> Observe como hacer la compilacion para Smarty del template index.tpl: <!-- Created by Smarty! --> {* rest of template content... *} Filtros de salida Cuando el template es invocado a través de display() o fetch(), su salida puede ser enviada a través de uno o mas filtros de salida. Este es diferente a los postfilters porque los postfilters operan en los templates compilados antes de ser salvados en disco, y los filtros de salida operan en la salida del template cuando este es ejecutado. Los Filtros de Salida pueden ser registrado o cargados del directorio de plugins usando la función load_filter() o configuran- do a variable $autoload_filters. El Smarty pasara la salida como el primer argumento, y espera que la función retorne el re- sultado del procesamiento. Ejemplo 15.4. Usando un filtro de salida de template <?php // ponga esto en su aplicación function protect_email($tpl_output, &$smarty) { $tpl_output = preg_replace('!(S+)@([a-zA-Z0-9.-]+.([a-zA-Z]{2,3}|[0-9]{1,3}))!', '$1%40$2', $tpl_output); return $tpl_output; } // registra el outputfilter $smarty->register_outputfilter("protect_email"); $smarty->display("index.tpl"); // Ahora cualquier ocurrencia de una direcci&oacute;n de email en la salida // del template tendra una simple protecci&oacute;n contra spambots ?> Función manipuladora de cache Como una alternativa al uso del mecanismo de caching por default basado en archivo, usted puede especificar una función habitual de manipulación de cache que será usada para leer, escribir y limpar archivos de cache. Cree una función en su aplicación para que Smarty la use como un manipulador de cache. Defina el nombre de la variable 154
  • 161. Caracteristicas Avanzadas de clase en el $cache_handler_func. El Smarty ahora usara esta para manipular datos en el cache. El primer parámetro es la acción, que puede ser uno de estos 'read', 'write' y 'clear'. El segundo parámetro es el objeto de Smarty. El tercer parámetro es el contenido que esta en el cache. Sobre 'write', el Smarty pasa el contenido en cache en estos parámetros. sobre 'read', el Smarty espera que su función acepte este parámetro por referencia y poblar estos con los datos en cache. Sobre 'clear', el Smarty pasa una variable en cero desde aquí que esta no es usada. El cuarto parámetro es el nombre del archivo de templa- te(necesario para leer/escribir). El quinto parámetro es la cache_id (opcional). El sexto parámetro es la compile_id (opcional). NOTA: El ultimo parámetro ($exp_time) fue adicionado en el Smarty-2.6.0. Ejemplo 15.5. ejemplo usando MySQL como una fuente de cache <?php /* ejemplo de uso: include('Smarty.class.php'); include('mysql_cache_handler.php'); $smarty = new Smarty; $smarty->cache_handler_func = 'mysql_cache_handler'; $smarty->display('index.tpl'); mysql database is expected in this format: create database SMARTY_CACHE; create table CACHE_PAGES( CacheID char(32) PRIMARY KEY, CacheContents MEDIUMTEXT NOT NULL ); */ function mysql_cache_handler($action, &$smarty_obj, &$cache_content, $tpl_file=null, $cache_id=null, $c { // set db host, user and pass here $db_host = 'localhost'; $db_user = 'myuser'; $db_pass = 'mypass'; $db_name = 'SMARTY_CACHE'; $use_gzip = false; // create unique cache id $CacheID = md5($tpl_file.$cache_id.$compile_id); if(! $link = mysql_pconnect($db_host, $db_user, $db_pass)) { $smarty_obj->_trigger_error_msg("cache_handler: could not connect to database"); return false; } mysql_select_db($db_name); switch ($action) { case 'read': // read cache from database $results = mysql_query("select CacheContents from CACHE_PAGES where CacheID='$C if(!$results) { $smarty_obj->_trigger_error_msg("cache_handler: query failed."); } $row = mysql_fetch_array($results,MYSQL_ASSOC); if($use_gzip && function_exists("gzuncompress")) { $cache_content = gzuncompress($row["CacheContents"]); } else { 155
  • 162. Caracteristicas Avanzadas $cache_content = $row["CacheContents"]; } $return = $results; break; case 'write': // save cache to database if($use_gzip && function_exists("gzcompress")) { // compress the contents for storage efficiency $contents = gzcompress($cache_content); } else { $contents = $cache_content; } $results = mysql_query("replace into CACHE_PAGES values( '$CacheID', '".addslashes($contents)."') "); if(!$results) { $smarty_obj->_trigger_error_msg("cache_handler: query failed."); } $return = $results; break; case 'clear': // clear cache info if(empty($cache_id) && empty($compile_id) && empty($tpl_file)) { // clear them all $results = mysql_query("delete from CACHE_PAGES"); } else { $results = mysql_query("delete from CACHE_PAGES where CacheID='$CacheID } if(!$results) { $smarty_obj->_trigger_error_msg("cache_handler: query failed."); } $return = $results; break; default: // error, unknown action $smarty_obj->_trigger_error_msg("cache_handler: unknown action "$action""); $return = false; break; } mysql_close($link); return $return; } ?> Recursos Los templates pueden venir de una variedad de fuentes. Cuando usted muestra un template con display() o fetch(), o incluye un template dentro de otro template, usted suministra un tipo de recurso, seguido por la ruta correcta y el nombre del tem- plate. Si un recurso no es dado explicitamente el valor de $default_resource_type es asumido. Templates desde $template_dir Los templates desde el $template_dir no requieren recursos del template, aunque usted puede usar el file: resource for con- sistancy(recurso por consistencia). Justamente proporcionando la ruta(path) del template que usted quiere usar en relación al directorio root $template_dir. Ejemplo 15.6. Usando templates desde $template_dir 156
  • 163. Caracteristicas Avanzadas <?php // desde el script de PHP $smarty->display("index.tpl"); $smarty->display("admin/menu.tpl"); $smarty->display("file:admin/menu.tpl"); // igual al de arriba ?> {* dentro del template de Smarty *} {include file="index.tpl"} {include file="file:index.tpl"} {* igual al de arriba *} Templates partiendo de cualquier directorio Los templates de fuera del $template_dir requieren el file: tipo de recurso del template, seguido por la ruta absoluta y el nombre del template. Ejemplo 15.7. usando templates desde cualquier directorio <?php // desde el script de PHP $smarty->display("file:/export/templates/index.tpl"); $smarty->display("file:/path/to/my/templates/menu.tpl"); ?> dentro del template Smarty: {include file="file:/usr/local/share/templates/navigation.tpl"} Rutas de archivos de Windows Si usted esta utilizando una maquina con windows, las rutas de los archivos normalmente incluyen la letra del drive (C:) en el comienzo del nombre de la ruta. Asegurarse de usar "file:" en la ruta para evitar conflictos de nombres y poder obtener los resultados desados. Ejemplo 15.8. usando templates con rutas de archivos de windows <?php // dentro del script de PHP $smarty->display("file:C:/export/templates/index.tpl"); $smarty->display("file:F:/path/to/my/templates/menu.tpl"); ?> dentro del template de Smarty {include file="file:D:/usr/local/share/templates/navigation.tpl"} Templates partiendo de otras fuentes Se pueden retomar templates usando cualquier fuente posible a la que usted pueda acceder con PHP: base de datos, sockets, LDAP, etc. Usted puede hacer esto escribiendo las funciones de plugin de recurso y registrandolas con Smarty. 157
  • 164. Caracteristicas Avanzadas Vea la sección resource plugins para mayor informacion sobre las funciones que puede utilizar. nota: Nota Usted puede activar manualmente el recurso file incrustado, pero no puede suministrar un recurso que busca templates a partir del sistema de archivos de alguna otra forma registrando bajo otro nombre de recurso. Ejemplo 15.9. Usando recursos habituales <?php // ponga estas funciones en algun lugar de su aplicación function db_get_template ($tpl_name, &$tpl_source, &$smarty_obj) { // llame su base de datos parta traer los datos al template, // poblando el $tpl_source $sql = new SQL; $sql->query("select tpl_source from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_source = $sql->record['tpl_source']; return true; } else { return false; } } function db_get_timestamp($tpl_name, &$tpl_timestamp, &$smarty_obj) { // llame su base de datos para traer los datos y poblar el $tpl_timestamp. $sql = new SQL; $sql->query("select tpl_timestamp from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_timestamp = $sql->record['tpl_timestamp']; return true; } else { return false; } } function db_get_secure($tpl_name, &$smarty_obj) { // asume que todos los templates son seguros return true; } function db_get_trusted($tpl_name, &$smarty_obj) { // no usar para templates } // registrar el nombre del recurso "db" $smarty->register_resource("db", array("db_get_template", "db_get_timestamp", "db_get_secure", "db_get_trusted")); // usando el recurso a partir del script PHP $smarty->display("db:index.tpl"); ?> usando el recurso dentro del template de Smarty {include file="db:/extras/navigation.tpl"} 158
  • 165. Caracteristicas Avanzadas Función manipuladora de Template por default Usted puede especificar la función que será usada para devolver el contenido del template dentro del evento del template no puede ser retomado desde su recurso. Un uso distinto es para crear templates que no existen "on-the-fly" (templates cuyo contenido cambia mucho, bastante variable). Ejemplo 15.10. usando la función manipuladora de template por default <?php // ponga esta funci&oacute;n en algun lugar de su aplicaci&oacute;n function make_template ($resource_type, $resource_name, &$template_source, &$template_timestamp, &$smar { if( $resource_type == 'file' ) { if ( ! is_readable ( $resource_name )) { // create the template file, return contents. $template_source = "This is a new template."; $template_timestamp = time(); $smarty_obj->_write_file($resource_name,$template_source); return true; } } else { // not a file return false; } } // defina la funci&oacute;n manipuladora por default $smarty->default_template_handler_func = 'make_template'; ?> 159
  • 166. Capítulo 16. Extendiendo Smarty con plugins Tabla de contenidos Como funcionan los Plugins ................................................................................................................. 160 Nombres convencionales ..................................................................................................................... 160 Escribiendo Plugins ............................................................................................................................ 161 Funciones de Template ........................................................................................................................ 161 Modificadores ................................................................................................................................... 163 Block Functions ................................................................................................................................. 164 Funciones Compiladoras ..................................................................................................................... 165 Prefiltros/Postfiltros ............................................................................................................................ 166 Filtros de Salida ................................................................................................................................. 167 Fuentes ............................................................................................................................................ 167 Inserts .............................................................................................................................................. 169 La version 2.0 introduce la arquitectura de plugin que es usada para casi todas las funcionalidades adaptables del Smarty. Esto incluye: • funciones • modificadores • funciones de bloque • funciones de compilación • prefiltros • postfiltros • filtros de salida • recursos(fuentes) • inserts Con la excepción de recursos, la compatibildad con la forma antigua de funciones de manipulación de registro via register_* API es conservada. Si usted no uso el API en lugar de eso modifico las variables de clase $custom_funcs, $custom_mods, y otras directamente, entonces usted va a necesitar ajustar sus scripts para cualquiera que use el API o con- vertir sus funciones habituales en plugins. Como funcionan los Plugins Los plugins son siempre cargados cuando son requeridos. solo los calificativos especificos, funciones, recursos, etc convo- cados en scripts del template seran leidos. Además, cada plugin es cargado una sola vez, aun si usted tiene corriendo varias instancias diferentes de Smarty dentro de la misma petición. Pre/posfiltros y salidas de filtros son una parte de un caso especial. Dado que ellos no son mensionados en los templates, ellos deben ser registrados o leidos explicitamente mediante funciones de API antes de que el template sea procesado. El or- den en el cual son ejecutados multiples filtros del mismo tipo depende del orden en el que estos son registrados o leidos. El directorio de directory puede ser una cadena que contenga una ruta o un arreglo que contenga multiples rutas. Para insta- lar un plugin, simplemente coloquelo en el directorio y el Smarty lo usara automáticamente. Nombres convencionales 160
  • 167. Extendiendo Smarty con plugins Los archivos y funciones de Plugin deben seguir una convención de apariencia muy especifica a fin de que pueda ser locali- zada por el Smarty. Los archivos de plugin deben ser nombrados de la siguiente forma: type.name.php Donde type es uno de los siguientes tipo de plugin: • function • modifier • block • compiler • prefilter • postfilter • outputfilter • resource • insert Y name seria un identificador valido (solo, letras, números, y underscores). Algunos ejemplos: function.html_select_date.php, resource.db.php, modifier.spacify.php. Las funciones de plugin dentro de los archivos de plugin deben ser nombradas de la siguiente forma: smarty_type, _name() El significado de type and name son los mismo que loas anteriores. El Smarty mostrara mensajes de error apropiados si el archivo de plugins que es necesario no es encontrado, o si el archivo a la función de plugin esta nombrado inadecuadamente. Escribiendo Plugins Los Plugins pueden ser leidos por el Smarty automáticamente del sistema de archivos o pueden ser registrados en tiempo de ejecución por medio de una de las funciones de API register_* . Estos también pueden ser usados con la función API unre- gister_*. Para los plugins que son registrados en tiempo de ejecución, el nombre de la(s) función(es) de plugin no tiene que seguir la convención de apariencia. Si un plugin depende de alguna función alimentada por otro plugin (como es el caso con algunos plugins incrustados con el Smarty), entonces la forma apropiada para leer el plugin necesario es esta: <?php require_once $smarty->_get_plugin_filepath('function', 'html_options'); ?> Como regla general, el objeto Smarty siempre es pasado a los plugins como ultimo parámetro (con dos excepciones: los mo- dificadores no pasan el objeto de Smarty del todo y los blocks obtenidos son pasados &$repeat después el objeto de Smarty para manter compatibilidad con antiguas versiones de Smarty). Funciones de Template void smarty_function_name()($params, &$smarty); 161
  • 168. Extendiendo Smarty con plugins array $params; object &$smarty; Todos los atributos pasados para las funciones de template a partir del template estan contenidas en $params como un arre- glo asociativo. La salida(valor de retorno) de la función será substituida en el lugar de la etiqueta de la función en el template (la función fetch(), por ejemplo). Alternativamente, la función puede simplemente ejecutar alguna otra tarea sin tener alguna salida (la función assign()). Si la función necesita pasar valores a algunas variables del template o utilizar alguna otra funcionalidad del Smarty, esta puede usar el objeto $smarty alimentandolo para hacer eso. Vea tambien: register_function(), unregister_function(). Ejemplo 16.1. Función de plugin con salida <?php /* * Smarty plugin * ------------------------------------------------------------- * File: function.eightball.php * Type: function * Name: eightball * Purpose: outputs a random magic answer * ------------------------------------------------------------- */ function smarty_function_eightball($params, &$smarty) { $answers = array('Yes', 'No', 'No way', 'Outlook not so good', 'Ask again soon', 'Maybe in your reality'); $result = array_rand($answers); return $answers[$result]; } ?> que puede ser usada en el template de la siguiente forma: Question: Will we ever have time travel? Answer: {eightball}. Ejemplo 16.2. Función de plugin sin salida <?php /* * Smarty plugin * ------------------------------------------------------------- * File: function.assign.php * Type: function * Name: assign * Purpose: assign a value to a template variable * ------------------------------------------------------------- */ function smarty_function_assign($params, &$smarty) 162
  • 169. Extendiendo Smarty con plugins { if (empty($params['var'])) { $smarty->trigger_error("assign: missing 'var' parameter"); return; } if (!in_array('value', array_keys($params))) { $smarty->trigger_error("assign: missing 'value' parameter"); return; } $smarty->assign($params['var'], $params['value']); } ?> Modificadores Los modificadores son funciones que son aplicadas a una variable en el template antes de ser mostrada o usada en algun otro contexto. Los modificadores pueden ser encadenados conjuntamente. mixed smarty_modifier_name()($value, $param1); mixed $value; [mixed $param1, ...]; El primer parámetro en el modificador de plugin es el valor sobre el cual el modificador es precisa para funcionar. El resto de los parámetros pueden ser opcionales, dependiendo de cual tipo de operación va a ser ejecutada. El modificador debe retornar el resultado de su procesamiento. Vea Tambien register_modifier(), unregister_modifier(). Ejemplo 16.3. Plugin modificador simple Este plugin básicamente es un alias de una función incorporada en PHP. Este no tiene ningun parámetro adicional. <?php /* * Smarty plugin * ------------------------------------------------------------- * File: modifier.capitalize.php * Type: modifier * Name: capitalize * Purpose: capitalize words in the string * ------------------------------------------------------------- */ function smarty_modifier_capitalize($string) { return ucwords($string); } ?> Ejemplo 16.4. Plugin modificador mas complejo <?php /* * Smarty plugin * ------------------------------------------------------------- * File: modifier.truncate.php 163
  • 170. Extendiendo Smarty con plugins * Type: modifier * Name: truncate * Purpose: Truncate a string to a certain length if necessary, * optionally splitting in the middle of a word, and * appending the $etc string. * ------------------------------------------------------------- */ function smarty_modifier_truncate($string, $length = 80, $etc = '...', $break_words = false) { if ($length == 0) return ''; if (strlen($string) > $length) { $length -= strlen($etc); $fragment = substr($string, 0, $length+1); if ($break_words) $fragment = substr($fragment, 0, -1); else $fragment = preg_replace('/s+(S+)?$/', '', $fragment); return $fragment.$etc; } else return $string; } ?> Block Functions void smarty_block_name()($params, $content, &$smarty, &$repeat); array $params; mixed $content; object &$smarty; boolean &$repeat; Las funciones de bloque son funciones de forma: {func} .. {/func}. En otras palabras, estas encapsulan un bloque del tem- plate y operan el contenido de este bloque. Las funciones de bloque toman precedencia sobre las funciones habituales con el mismo nombre, es decir, usted no puede tener ambas, las funciones habituales {func} y las funciones de bloque {func} .. {/func}. Por default la implementación de su función es llamada dos veces por el Smarty: una vez por la etiqueta de apertura, y la otra por la etiqueta de cierre (vea &$repeat abajo para ver como hacer cambios a esto). Solo la etiqueta de apertura de la función de bloque puede tener atributos. Todos los atributos pasados a las funciones de template estan contenidos en $params como un arreglo asociativo. Usted puede accesar a cualquiera de estos valores direc- tamente, e.g. $params['start']. Los atributos de la etiqueta de apertura son también son accesibles a su función cuando se procesa la etiqueta de cierre. El valor de la variable $content depende de que si su función es llamada por la etiqueta de cierre o de apertura. En caso de que la etiqueta sea de apertura, este será null, si la etiqueta es de cierre el valor será del contenido del bloque del template. Se debe observar que el bloque del template ya a sido procesado por el Smarty, asi todo lo que usted recibirá es la salida del template, no el template original. El parámetro &$repeat es pasado por referencia para la función de implementación y proporciona la posibilidad de contro- lar cuantas veces será mostrado el bloque. Por default $repeat es true en la primera llamada de la block-function (etiqueta de apertura del bloque) y false en todas las llamadas subsecuentes a la función de boque (etiqueta de cierre del boque). Cada vez que es implementada la función retorna con el &$repeat siendo true, el contenido entre {func} .. {/func} es eva- luado y es implementado a la función es llamada nuevamente con el nuevo contenido del bloque en el parámetro $content. Si usted tiene funciones de bloque anidadas, es posible descubrir cual es el padre de la función de bloque accesando la varia- ble $smarty->_tag_stack. Solo hacer un var_dump() sobre ella y la estrutura estara visible. Vea tambien: register_block(), unregister_block(). 164
  • 171. Extendiendo Smarty con plugins Ejemplo 16.5. Función de bloque <?php /* * Smarty plugin * ------------------------------------------------------------- * File: block.translate.php * Type: block * Name: translate * Purpose: translate a block of text * ------------------------------------------------------------- */ function smarty_block_translate($params, $content, &$smarty, &$repeat) { if (isset($content)) { $lang = $params['lang']; // do some intelligent translation thing here with $content return $translation; } } ?> 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 habi- tual 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, to- do 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 *} 165
  • 172. Extendiendo Smarty con plugins {tplheader} El codigo PHP resultante en el template compilado seria algo asi: <?php echo 'index.tpl compiled at 2002-02-20 20:02'; ?> Prefiltros/Postfiltros Los Plugins Prefilter y postfilter con muy similares en concepto; donde ellos difieren es en la ejecución -- mas precisamente en el tiempo sus ejecuciones. string smarty_prefilter_name()($source, &$smarty); string $source; object &$smarty; Los Prefilters son usados para procesar el fuente del template inmediatamente antes de la compilación. El primer parámetro de la función del prefilter es el fuente del template, posiblemente modificado por algunos otros prefilters. El Plugin es su- puesto que retorne el fuente modificado. Observe que este código no es salvado en ningun lugar, este es solo usado para la compilación. string smarty_postfilter_name()($compiled, &$smarty); string $compiled; object &$smarty; Los Postfilters son usados para procesar la salida compilada del template (el código PHP) inmediatamente después de que la compilacion es terminada pero antes de que el template compilado sea salvado en el sistema de archivos. El primer paráme- tro para la función postfilter es el código del template compilado, posiblemente modificado por otros postfilters. El plugin se supone retornara la versión modificada de este código. Ejemplo 16.7. prefilter plugin <?php /* * Smarty plugin * ------------------------------------------------------------- * File: prefilter.pre01.php * Type: prefilter * Name: pre01 * Purpose: Convert html tags to be lowercase. * ------------------------------------------------------------- */ function smarty_prefilter_pre01($source, &$smarty) { return preg_replace('!<(w+)[^>]+>!e', 'strtolower("$1")', $source); } ?> Ejemplo 16.8. postfilter plugin <?php /* * Smarty plugin * ------------------------------------------------------------- * File: postfilter.post01.php 166
  • 173. Extendiendo Smarty con plugins * Type: postfilter * Name: post01 * Purpose: Output code that lists all current template vars. * ------------------------------------------------------------- */ function smarty_postfilter_post01($compiled, &$smarty) { $compiled = "<pre>n<?php print_r($this->get_template_vars()); ?>n</pre>" . $compiled; return $compiled; } ?> Filtros de Salida Los Filtros de salida operan en la salida del template, después que el template es cargado y ejecutado, pero antes que la sali- da sea mostrada. string smarty_outputfilter_name()($template_output, &$smarty); string $template_output; object &$smarty; El primer parámetro de la función de filtro de salida es la salida del template que necesita ser procesada, y el segundo pará- metro es la instancia del Smarty invocando el plugin. El plugin debe hacer el procesamiento y retornar los resultados. Ejemplo 16.9. plugin de filtro de salida <?php /* * Smarty plugin * ------------------------------------------------------------- * File: outputfilter.protect_email.php * Type: outputfilter * Name: protect_email * Purpose: Converts @ sign in email addresses to %40 as * a simple protection against spambots * ------------------------------------------------------------- */ function smarty_outputfilter_protect_email($output, &$smarty) { return preg_replace('!(S+)@([a-zA-Z0-9.-]+.([a-zA-Z]{2,3}|[0-9]{1,3}))!', '$1%40$2', $output); } ?> Fuentes Las fuentes de los plugins son como una forma generica de suministrar código fuente de template o componentes de script PHP al Smarty. Algunos ejemplos de fuentes: base de datos, LDAP, memoria compartida, sockets, etc. Existe un total de 4 funciones que necesitan estar registradas para cada tipo de fuente. Cada función recibirá el fuente reque- rido como primer parámetro y el objeto de Smarty como ultimo parámetro. El resto de los parámetros dependen de la fun- ción. bool smarty_resource_name_source()($rsrc_name, &$source, &$smarty); string $rsrc_name; string &$source; object &$smarty; bool smarty_resource_name_timestamp()($rsrc_name, &$timestamp, &$smarty); string $rsrc_name; 167
  • 174. Extendiendo Smarty con plugins int &$timestamp; object &$smarty; bool smarty_resource_name_secure()($rsrc_name, &$smarty); string $rsrc_name; object &$smarty; bool smarty_resource_name_trusted()($rsrc_name, &$smarty); string $rsrc_name; object &$smarty; La primera función debe devolver el recurso. Su segundo parámetro es una variable pasada por referencia donde el resultado debe ser almacenado. La función debe retornar true si esta pudo recuperar satisfactoriamente el recurso y en caso contrario retornara false. La segunda función debe devolver la ultima modificación del recurso requerido (como un timestamp Unix). El segundo pa- rámetro es una variable pasada por referencia donde el timestamp sera almacenado. La función debe retornar true si el ti- mestamp pudo ser determinado satisfactoriamente, y en caso contrario retornara false. La tercera función debe retornar true o false, dependiendo si el recurso requerido es seguro o no. Esta función es usada solo para recursos de template pero esta debe ser definida. La cuarta función debe retornar true o false, dependiendo si el recurso requerido es seguro o no. Esta función es usada solo para componetes de script de PHP solicitado por las etiquetas include_php o insert con el atributo src. Sin embargo, este debe ser definido para los recurso del template. Vea también register_resource(), unregister_resource(). Ejemplo 16.10. Plugin resource (recurso) <?php /* * Smarty plugin * ------------------------------------------------------------- * File: resource.db.php * Type: resource * Name: db * Purpose: Fetches templates from a database * ------------------------------------------------------------- */ function smarty_resource_db_source($tpl_name, &$tpl_source, &$smarty) { // do database call here to fetch your template, // populating $tpl_source $sql = new SQL; $sql->query("select tpl_source from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_source = $sql->record['tpl_source']; return true; } else { return false; } } function smarty_resource_db_timestamp($tpl_name, &$tpl_timestamp, &$smarty) { // do database call here to populate $tpl_timestamp. $sql = new SQL; $sql->query("select tpl_timestamp from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_timestamp = $sql->record['tpl_timestamp']; return true; } else { 168
  • 175. Extendiendo Smarty con plugins return false; } } function smarty_resource_db_secure($tpl_name, &$smarty) { // assume all templates are secure return true; } function smarty_resource_db_trusted($tpl_name, &$smarty) { // not used for templates } ?> Inserts Los Plugins Insert son usados para implementar funciones que son invocadas por las etiquetas insert en el template. string smarty_insert_name()($params, &$smarty); array $params; object &$smarty; El primer parámetro de la función es un arreglo asociativo de atributos pasados al insert. La función insert debe retornar el resultado que ira a sustituir el lugar de la etiqueta insert en el template. Ejemplo 16.11. insert plugin <?php /* * Smarty plugin * ------------------------------------------------------------- * File: insert.time.php * Type: time * Name: time * Purpose: Inserts current date/time according to format * ------------------------------------------------------------- */ function smarty_insert_time($params, &$smarty) { if (empty($params['format'])) { $smarty->trigger_error("insert time: missing 'format' parameter"); return; } $datetime = strftime($params['format']); return $datetime; } ?> 169
  • 176. Parte IV. Appendixes Tabla de contenidos 17. Localización de Errores .................................................................................................................. 171 Errores Smarty/PHP ........................................................................................................... 171 18. Consejos y Trucos ......................................................................................................................... 173 Manipulación de Variables Vacias ......................................................................................... 173 Manipulación del valor default de una variable ........................................................................ 173 Pasando la variable titulo a la cabecera del template .................................................................. 174 Fechas ............................................................................................................................. 174 WAP/WML ...................................................................................................................... 175 Templates con Componetes .................................................................................................. 176 Ofuscando direcciones de E-mail .......................................................................................... 177 19. Fuentes ....................................................................................................................................... 178 20. ERRORES ................................................................................................................................... 179 170
  • 177. Capítulo 17. Localización de Errores Tabla de contenidos Errores Smarty/PHP ........................................................................................................................... 171 Errores Smarty/PHP El Smarty puede obtener muchos errores tales como, atributos de etiquetas perdidos o nombres de variables mal formadas. Si este ocurre, Usted vera un error similar al siguiente: Ejemplo 17.1. Errores de Smarty Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah' in /path/to/smarty/Smarty.class.php on line 1041 Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name in /path/to/smarty/Smarty.class.php on line 1041 Smarty te mostra el nombre del template, el número de la linea y el error. Después de esto, el error consiste en el número de la linea de la clase Smarty donde ocurrio el error. Existen ciertos errores que el Smarty no puede entender, tales como un etiqueta de cierre errado. Estos tipos de erros nor- malmente termina en una interpretacion de error del tiempo de compilacion de PHP. Ejemplo 17.2. Errores de analisis gramatical de PHP Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75 Cuando usted encuentra un error de analisis de PHP, el número de la linea de error corresponde al script PHP compilado, no al template en si. Normalmente usted puede en el template localizar el error de sinxis. Algunas cosas que usted puede bus- car: falta de cierre de etiquetas para {if}{/if}} o {section}{/section}, o sintaxis de la lógica dentro de una etiqueta {if}. Si usted no encuentra el error, usted tendra que abrir el archivo PHP compilado y dirigirse al número de linea mostrado, donde el correspondiente error esta en el template. Ejemplo 17.3. Otros errores comunes • Warning: Smarty error: unable to read resource: "index.tpl" in... or Warning: Smarty error: unable to read resource: "site.conf" in... 171
  • 178. Localización de Errores • El $template_dir no existe o es incorrecto, o el archivo index.tpl no esta en la carpeta templates/ • La función {config_load} esta dentro del template (o config_load() habia sido llamado) y cualquira de los dos $config_dir es incorrecto, no exista o site.conf no existe en el directorio. • Fatal error: Smarty error: the $compile_dir 'templates_c' does not exist, or is not a directory... Cualquiera de las dos el $compile_dir es asignado incorrectamente, el directorio no existe, o templates_c es un archi- vo y no un directorio. • Fatal error: Smarty error: unable to write to $compile_dir '.... El $compile_dir no puede ser reescrito por el servidor web. Vea a fondo la pagina de permisos del instalación de smarty. • Fatal error: Smarty error: the $cache_dir 'cache' does not exist, or is not a directory. in /.. Esto significa que $caching es habilitado y cualquiera de los dos; el $cache_dir es asignado incorrectamente, o el direc- torio no existe, o cache es un archivo y no un directorio. • Fatal error: Smarty error: unable to write to $cache_dir '/... Esto significa que $caching es habilitado y el $cache_dir no puede ser rescrito por el web server. Ver ampliamente la pa- gina de permisos de la instalacion de smarty. Vea también debugging, $error_reporting y trigger_error(). 172
  • 179. Capítulo 18. Consejos y Trucos Tabla de contenidos Manipulación de Variables Vacias ......................................................................................................... 173 Manipulación del valor default de una variable ........................................................................................ 173 Pasando la variable titulo a la cabecera del template .................................................................................. 174 Fechas ............................................................................................................................................. 174 WAP/WML ...................................................................................................................................... 175 Templates con Componetes .................................................................................................................. 176 Ofuscando direcciones de E-mail .......................................................................................................... 177 Manipulación de Variables Vacias Cuando usted en algunas ocaciones quiere imprimir un valor que usted defíne a una variable vacia en vez de imprimir nada, tal como imprimir "&nbsp;" a fin de que el plano del fondo de la tabla funcione correctamente. Muchos usarian una senten- cia {if} para manejar esto, mas existe otra forma con Smarty, usando el modificador de la variable default. Ejemplo 18.1. Imprimiendo &nbsp; cuando una variable esta vacia {* the long way *} {if $title eq ""} &nbsp; {else} {$title} {/if} {* the short way *} {$title|default:"&nbsp;"} Ver tambien default y Default Variable Handling. Manipulación del valor default de una variable Si una variable es usada frecuentemente en sus templates, aplicando el modificador default toda vez que este es mencionado puede evitar un bit desagradable. Usted puede remediar esto con la atribución de un valor por default a la variable con la función {assign}. Ejemplo 18.2. Atribuyendo el valor por default a una variable en el template {* ponga esto en algun lugar en la parte de arriba de su template *} {assign var="title" value=$title|default:"no title"} {* Si el $titulo estaba vacio, este ahora tendra el valor "sin titulo" cuando usted lo exiba *} 173
  • 180. Consejos y Trucos {$title} Vea tambiéen default y Blank Variable Handling. Pasando la variable titulo a la cabecera del template Cuando la mayoria de sus templates usan los mismo encabezados y los mismos pies de pagina, es común dividirlos uno en cada template y entonces incluirlos {include}. Que pasara si el encabezado necesita tener un titulo diferente, dependiendo de que pagina estas viniendo? usted puede pasar el titulo en el encabezado cuando este es incluido. Ejemplo 18.3. Pasando la variable titulo al encabezado del template mainpage.tpl {include file="header.tpl" title="Main Page"} {* template body goes here *} {include file="footer.tpl"} archives.tpl {config_load file="archive_page.conf"} {include file="header.tpl" title=#archivePageTitle#} {* template body goes here *} {include file="footer.tpl"} header.tpl <html> <head> <title>{$title|default:"BC News"}</title> </head> <body> footer.tpl </body> </html> Cuando la pagina principal es mostrada, el titulo de la "Página Principal" es pasado al template header.tpl, y será poste- riormente usado como el titulo. Cuando la pagina de archivo es mostrada, el titulo sera "Archivos". Observelo en el ejemplo de archivo, nosotros estamos usando una variable del archivo archives_page.conf en vez de una variable codificada ri- gida. Tambien note que "BC news" es mostrada si la variable $titulo no esta definida, usando el modificador de la variable default. Fechas Como una regla basica, siempre pase fechas al Smarty como timestamps. Esto permite al diseñador de template utilizar da- te_format para el control completo sobre el formato de fechas, y también facilita la comparación de fechas si es necesario. nota: En el Smarty 1.4.0, usted puede parsar fechas al Smarty como timestamps unix,mysql, o cualquier otra fecha interpretable por strtotime() [http://php.net/strtotime]. 174
  • 181. Consejos y Trucos Ejemplo 18.4. Usando date_format {$startDate|date_format} Esta es la salida: Jan 4, 2001 {$startDate|date_format:"%Y/%m/%d"} Esta es la Salida: 2001/01/04 {if $date1 < $date2} ... {/if} Cuando usa {html_select_date} en un template, el programador normalmente va a querer convertir la salida de un formula- rio de vuelta al formato timestamp. Aquí esta una función para ayudar con esto. Ejemplo 18.5. Convirtiendo elementos en forma de fecha de vuelta a un timestamp <?php // esto asume que la forma de sus elementos son nombradas como // startDate_Day, startDate_Month, startDate_Year $startDate = makeTimeStamp($startDate_Year, $startDate_Month, $startDate_Day); function makeTimeStamp($year="", $month="", $day="") { if(empty($year)) { $year = strftime("%Y"); } if(empty($month)) { $month = strftime("%m"); } if(empty($day)) { $day = strftime("%d"); } return mktime(0, 0, 0, $month, $day, $year); } ?> Vea también {html_select_date}, {html_select_time}, date_format y $smarty.now, WAP/WML Los templates WAP/WML requieren de un encabezado de Content-Type [http:/ / php.net/ header] de PHP para ser pasado junto con el template. La forma mas fácil de hacer esto seria escribir una función de manera habitual que imprima el encabe- zado. Si usted esta usando el sistema de cache, este no funcionara, entonces nosotros haremos esto usando una etiqueta de {insert} (recuerde que las etiquetas insert no son "cacheadas!"). Asegurarse que no exista ninguna salida al navegador antes 175
  • 182. Consejos y Trucos del template, de otro modo el encabezado fallara. Ejemplo 18.6. Usando insert para escribir un encabezado WML Content-Type <?php // Asegurarse que el apache esta configurado para las extenciones .wml ! // ponga esta función en algun lugar de su aplicación, o en Smarty.addons.php function insert_header($params) { // this function expects $content argument if (empty($params['content'])) { return; } header($params['content']); return; } ?> Su template de Smarty debe comenzar con la etiqueta insert, como en el ejemplo: {insert name=header content="Content-Type: text/vnd.wap.wml"} <?xml version="1.0"?> <!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml"> <!-- begin new wml deck --> <wml> <!-- begin first card --> <card> <do type="accept"> <go href="#two"/> </do> <p> Welcome to WAP with Smarty! Press OK to continue... </p> </card> <!-- begin second card --> <card id="two"> <p> Pretty easy isn't it? </p> </card> </wml> Templates con Componetes Tradicionalmente, programar templates en sus aplicaciones es de la siguiente forma: Primero, usted acumula sus variables dentro de su aplicación PHP, (talvez como requisiciones de una base de datos). Entonces, usted instancia su objeto Smarty assign(), atribuye valores a las variables y muestra el template display(). Por ejemplo nosotros tenemos un registrador de existencias en nuestro template. Nosotros recolectaremos los datos de las existencias en nuestra aplicación, entonces damos valor a estas variables en el template y lo mostramos. Ahora esto seria genial si usted adicionara este registrador de almace- namiento (stock ticker) a cualquier aplicación simplemente incluyendolo en el template, y no preocuparse hacerca de como ir a traer los datos al frente? Usted puede escribir este plugin haciendo que traiga un contenido y asignarlo a la variable del template. Ejemplo 18.7. Templates con Componetes 176
  • 183. Consejos y Trucos function.load_ticker.php - deja el archivo en $plugins directory <?php // deja el archivo "function.load_ticker.php" en el directorio de plugins // configura nuestra funci&oacute;n para traer los datos almacenados function fetch_ticker($symbol) { // ponga la lógica aquí que traera $ticker_name // y $ticker_price de algun recurso return $ticker_info; } function smarty_function_load_ticker($params, &$smarty) { // llama la función $ticker_info = fetch_ticker($params['symbol']); // asigna las variables al template $smarty->assign($params['assign'], $ticker_info); } ?> index.tpl {load_ticker symbol="YHOO" assign="ticker"} Stock Name: {$ticker.name} Stock Price: {$ticker.price} Vea también {include_php}, {include} y {php}. Ofuscando direcciones de E-mail Usted desea saber como su direccion de E-mail consigue entrar en tantas listas de e-mail de spam? Una direccion unica spammers recolecta direcciones de E-mail y de paginas web. Para ayudar a combatir este problema, usted puede hacer que su direccion de E-mail aparesca en javascript mostrado en el codigo HTML, este mismo aparecera y funcionara correcta- mente en el navegador. Esto se puede hacer con el plugin {mailto}. Ejemplo 18.8. Ejemplo de ofuscamiento de una direccion de E-mail {* in index.tpl *} Send inquiries to {mailto address=$EmailAddress encode="javascript" subject="Hello"} Nota Técnica: Este metodo no es 100% a pueba de fallas. Un spammer podría crear un programa para recolectar el e-mail y para decodificar estos valores, mas no es muy común. Vea también escape y {mailto}. 177
  • 184. Capítulo 19. Fuentes La pagina principal del Smarty está localizada en http://smarty.php.net/. Usted puede ingresar a la lista de email enviando un e-mail a smarty-general-subscribe@lists.php.net. El archivo de la lista de e-mail puede ser visto en http:/ / marc.theaimsgroup.com/?l=smarty-general&r=1&w=2. 178
  • 185. Capítulo 20. ERRORES Revise el archivo de BUGS que viene con la ultima distribución del Smarty, o Revise el website. 179