← Volver a la documentación

Referencia de la sintaxis de Templite

Templite es el motor de plantillas de <TextField>, y es pequeño a propósito. No hay un lenguaje aparte que aprender. Cada etiqueta se compila directamente a PHP y el archivo compilado se guarda en caché: el análisis ocurre una vez por cambio, no en cada petición.

Una variable se muestra entre llaves: {title}. Una colección se recorre con una cláusula «in»: {item in $articles} ... {end}. «item» es un prefijo que usted elige para evitar choques con otros bucles de la misma página; dentro del bucle, cada campo se convierte en {item_title}, {item_date}, etc. Cada elemento recibe además automáticamente {item_id}, su posición en la colección empezando por cero.

Las condiciones se escriben como PHP normal: {if $count > 3} ... {elseif $count == 0} ... {else} ... {end}. La condición se evalúa de verdad como PHP, así que cualquier expresión que pondría en un if normal funciona aquí, llamadas a funciones incluidas.

Quedan dos etiquetas. {include 'themes/mytheme/header'} inserta otra plantilla; así es como las páginas comparten una cabecera y un pie. Y {?cualquier php} pasa a PHP puro para los casos raros en que una etiqueta no basta, por ejemplo un cálculo puntual que no quiere llevar a un archivo controlador solo para mostrar un valor.

Todo se compila en un simple archivo .php dentro de core/tmp/, así que puede abrir una plantilla compilada y ver exactamente en qué se convirtieron sus etiquetas. Cuando un bucle no se comporta, suele ser la salida más rápida: olvide la teoría y lea el foreach generado.

Para los atributos HTML y cualquier texto escrito por un visitante, use mejor {=title}: el valor se escapa entonces para HTML.