Chapitre 5. Modificateurs de variables

Les modificateurs de variables peuvent être appliqués aux variables, fonctions utilisateurs ou chaînes de caractères. Pour appliquer un modificateur de variable, tappez une valeure suivie de | (pipe) et du nom du modificateur. Un modificateur de variable est succeptible d'accepter des paramètres additionnels, qui en affectent le comportement. Ces paramètres suivent le nom du modificateur et sont séparés par un : (deux points).

{* applique un modificateur à une variable *}
{$titre|upper}

{* modificateur avec paramètres *}
{$titre|truncate:40:"..."}

{* applique un modificateur à un paramètre de fonction *}
{html_table loop=$mavariable|upper}
{* avec paramètres *}
{html_table loop=$mavariable|truncate:40:"..."}

{* applique un modificateur à une chaine de caractères *}
{"foobar"|upper}

{* utilise date_format pour mettre en forme la date *}
{$smarty.now|date_format:"%d/%m/%Y"}

{* applique un modificateur à une fonction utilisateur *}
{mailto|upper address="moi@domaine.dom"}

Si vous appliquez un modificateur de variable à un tableau plutôt qu'à une variable simple, le modificateur sera appliqué à chaque valeur du tableau. Si vous souhaitez que le modificateur travaille réellement avec le tableau en tant que tel, vous devez préfixer le nom du modificateur avec un symbole @ comme ceci: {$titreArticle|@count} (Affiche le nombre d'élements du tableau $titreArticle.)

Les modificateurs sont chargés automatiquement depuis votre répertoire de plugin $plugins_dir (voir aussi: convention de nommage) ou peuvent être enregistrés explicitement (voir: register_modifier).

De même, toutes les fonction php peuvent être utilisées comme modificateur, sans autre déclaration. (L'exemple avec @count ci dessus utilise la fonction count(), et non un modificateur Smarty. Utiliser des fonctions PHP en tant que modificateur comporte deux risques: Premièrement: il arrive que l'ordre des paramètres ne soit pas celui attendu ({"%2.f"|sprintf:$float} fonctionne, mais demande une syntaxe plus naturelle, par exemple{$float|string_format:"%2.f"} fourni dans la distribution Smarty). Deuxièmement : lorsque $security est activé, les fonctions php utilisées en tant que modificateur doivent être explicitement déclarées comme connues dans le tableau $security_settings['MODIFIER_FUNCS'].

Voir aussi register_modifier(), register_function(), étendre Smarty avec des plugins et les modifieurs.

{$titreArticle}
{$titreArticle|capitalize}
{$titreArticle|capitalize:true}

Le nouveau php5 est vraiment performant !
Le Nouveau php5 Est Vraiment Performant !
Le Nouveau Php5 Est Vraiment Performant !