Table of Contents
Los modificadores de variables pueden ser aplicados a variables,
funciones habituales o cadenas. Para aplicar un modificador, 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).
Example 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 simbolo
@ antes del nombre del modificador, así como:
{$articleTitle|@count} (esto mostrara el número de
elementos 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
utilizadas 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 declaradas como variables de una matriz
$security_settings['MODIFIER_FUNCS']
.
Ver también register_modifier(), register_function(), Extending Smarty with plugins y modifiers,
| Posicion del Parametro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
| 1 | boolean | No | false | Este determina que palabra con digitos no debe ser convertida |
Este es usado para convertir a mayuscula la primera letra de todas la palabras de una variable.
Example 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.