Capítulo 5. Modificadores de variables

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).

{* 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,

{$articleTitle}
{$articleTitle|capitalize}
{$articleTitle|capitalize:true}

next x-men film, x3, delayed.
Next X-Men Film, x3, Delayed.
Next X-Men Film, X3, Delayed.