Модификаторы переменных в языке шаблонов Smarty

Модификаторы переменных могут быть прмменены к переменным, пользовательским функциям или строкам. Для их применения надо после модифицируемого значения указать символ | (вертикальная черта) и название модификатора. Так же модификаторы могут принимать параметры, которые влияют на их поведение. Эти параметры следуют за названием модификатора и разделяются : (двоеточием).

{* Выводим заголовок большими буквами *}
<h2>{$title|upper}</h2>
 
{* Ограничим $topic 40-а символами и добавим "..." в конце *}
Topic: {$topic|truncate:40:"..."}
 
{* форматируем строку *}
{"now"|date_format:"%Y/%m/%d"}
 
{* Применение модификатора к функции *}
{mailto|upper address="me@domain.dom"}

Если модификатор применяется к переменной-массиву, то он будет применен к каждому элементу массива. Если же требуется применить модификатор к массиву, как к переменной, то необходимо перед именем модификатора указать символ @. Пример: {$articleTitle|@count} выведет количество елементов в массиве $articleTitle.

Преобразует bb-теги в тексте в html форматирование.

{$commentText|bbcode}

Первые буквы каждого слова преобразуются в заглавные.

{$articleTitle}
{$articleTitle|capitalize}

Возвращает количество символов в строке.

{$articleTitle}
{$articleTitle|count_characters}

Данная строка добавляется к модифицируемому значению.

{$articleTitle|cat:" yesterday."}

Возвращает количество абзацев в строке.

Возвращает количество предложений.

Возвращает количество слов.

Формирует дату и время по заданному формату strftime(). Даты могут быть в виде unix timestamps, mysql timestamps или в любом другом виде, который поймет strtotime(). Проектировщики шаблонов могут использовать date_format для контроля над форматом выводимых дат. Если дата, переданная модификатору, пуста, то второй параметр используется как дата.

{$smarty.now|date_format} {* текущая дата. *}
{$smarty.now|date_format:"%D %T"} {* дата и время. *}

%a - сокращенное название дня недели, в зависимости от текущей локали
%A - полное название дня недели, в зависимости от текущей локали
%b - сокращенное нащвание месяца, в зависимости от текущей локали
%B - полное название месяца, в зависимости от текущей локали
%c - формат даты и времени по умолчанию для текущей локали
%C - номер века (год, деленный на 100, представленный в виде целого в промежутке от 00 до 99) 
%d - день месяца в десятичном формате (от 00 до 31) 
%D - синоним %m/%d/%y 
%e - день месяца в десятичном формате без ведущего нуля (от 1 до 31) 
%g - Week-based year within century [00,99]
%G - Week-based year, including the century [0000,9999]
%h - синоним %b 
%H - часы по 24-часовым часам (от 00 до 23) 
%I - часы по 12-часовым часам (от 01 до 12) 
%j - день года (от 001 до 366) 
%k - часы по 24-часовым часам без ведущего нуля (от 0 до 23)
%l - часы по 12-часовым часам без ведущего нуля (от 1 до 12)
%m - номер месяца (от 01 до 12) 
%M - минуты
%n - символ новой строки
%p - `am' или `pm', в зависимости от заданного формата времени и текущей локали.
%r - time in a.m. and p.m. notation 
%R - time in 24 hour notation 
%S - секунды
%t - символ табуляции
%T - время в формате %H:%M:%S 
%u - номер дня недели [1,7], где 1-ый день - понедельник
%U - номер недели в году, считая первое воскресенья года первым днем первой недели 
%V - номер недели в году (по ISO 8601:1988) в диапазоне от 01 до 53, где первая неделя та, у которой хотя бы 4 дня находятся в данном году. Понедельник считается первым днем недели. 
%w - номер дня недели, где 0 - воскресенье
%W - номер недели в году, считаю первый понедельник первым днем первой недели.

Используется для установки значения по умолчанию для переменной. Если переменная оказывается пустой, то выводится значение по умолчанию. Модификатор принимает один параметр.

{$articleTitle|default:"no title"}
{$myTitle|default:"no title"}

«Защищает» специальные символы в переменной. Используется для защиты специальных символов html, защиты специальных символов url, защиты одиночных кавычек, конвертации в шестандцатеричный вид (hex), конвертации каждого символа в шестандцатеричное html представление (hexentity), защита специальных символов javascript.

{$articleTitle}
{$articleTitle|escape}
{$articleTitle|escape:"html"}    {* защищает  & " ' < > *}
{$articleTitle|escape:"htmlall"} {* защищает все ВСЕ html объекты *}
{$articleTitle|escape:"url"}
{$articleTitle|escape:"quotes"}
<a href="mailto:{$EmailAddress|escape:"hex"}">{$EmailAddress|escape:"hexentity"}</a>

Вставляет в начало каждой строки заданное количество заданных символов. По умолчанию вставляется 4 пробела.

Все буквы в переменной становятся маленькими.

Заменяет все переносы строк на тэг <br /> в заданной переменной. Это эквивалент PHP функции nl2br().

Добавляет пробел между разрядами крупных чисел. Например 65000 приводится к виду 65 000.

Выполняется поиск и замена по регулярному выражению в переменной. Используется синтаксис для функции preg_replace() из руководства по PHP.

Выполняется простой поиск и замена строки.

{$articleTitle}
{$articleTitle|replace:"Garden":"Vineyard"}
{$articleTitle|replace:" ":"   "}

Spacify позволяет вставить пробел между каждым символом переменной. Можно также указать другой символ (или строку) для вставки

Форматирует строку по указанному формату. Используется синтаксис форматирования PHP функции sprintf.

{$number}
{$number|string_format:"%.2f"}
{$number|string_format:"%d"}

Заменяет все повторные пробелы, новые строки и знаки табуляции на одиночный пробел или на заданную строку.

Вырезает HTML теги, обычно все между < и >.

Обрезает переменную по указанной длине (по умолчанию 80). Вторым параметром можно указать текст, который будет добавлен в конец обрезанной строки. По умолчанию truncate будет пытаться вырезать слово, которой лежит на вырезаемой границе, целиком. Можно указать третий параметр true, если надо обрезать строку точно по определенному символу.

{$articleTitle}
{$articleTitle|truncate}
{$articleTitle|truncate:30}
{$articleTitle|truncate:30:""}
{$articleTitle|truncate:30:"---"}
{$articleTitle|truncate:30:"":true}
{$articleTitle|truncate:30:"...":true}

Заменяет все маленькие буквы на большие.

Переносит строку по количеству столбцов (по умолчанию 80). Можно указать строку, которая будет вставлятся на месте переноса (по умолчанию символ новой строки). По умолчанию wordwrap пытается переносить по словам, но если указать третим параметром true, то переноситься будет по конкретному символу.

{$articleTitle}
{$articleTitle|wordwrap:30}
{$articleTitle|wordwrap:20}
{$articleTitle|wordwrap:30:"<br>\n"}
{$articleTitle|wordwrap:30:"\n":true}

Можно применять любой количество модификаторов к переменной. Они будут применять в порядке их упоминания слева направо. Модификаторы должны быть разделены символом | (вертикальная черта).

{$articleTitle}
{$articleTitle|upper|spacify}
{$articleTitle|lower|spacify|truncate}
{$articleTitle|lower|truncate:30|spacify}
{$articleTitle|lower|spacify|truncate:30:". . ."}

Следующая глава