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

<code smarty>
{* Выводим заголовок большими буквами *}
<h2>{$title|upper}</h2>

{* Ограничим $topic 40-а символами и добавим "..." в конце *}
Topic: {$topic|truncate:40:"..."}

{* форматируем строку *}
{"now"|date_format:"%Y/%m/%d"}

{* Применение модификатора к функции *}
{mailto|upper address="me@domain.dom"}
</code>

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

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

<code smarty>
{$commentText|bbcode}
</code>

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

<code smarty>
{$articleTitle}
{$articleTitle|capitalize}
</code>

==== count_characters ====
Возвращает количество символов в строке. 
<code smarty>
{$articleTitle}
{$articleTitle|count_characters}
</code>

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

<code smarty>
{$articleTitle|cat:" yesterday."}
</code>

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

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

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

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

^ Позиция параметра ^ Тип ^ Обязателен ^ По умолчанию ^ Описание ^
| 1 | строка (string) | Нет | %d.%m.%Y | Формат вывода даты. |
| 2 | строка (string) | Нет | n/a | Если модифицируемое значение пусто, то используется это. |

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

<file>
%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 - номер недели в году, считаю первый понедельник первым днем первой недели.
</file>

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

<code smarty>
{$articleTitle|default:"no title"}
{$myTitle|default:"no title"}
</code>

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

^Позиция параметра ^Тип ^Обязателен ^Возможные значения ^По умолчанию ^Описание ^
|1 | строка (string) |Нет |html, htmlall, url, quotes, hex, hexentity, javascript |html |Формат защиты (escape). |

<code smarty>
{$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>
</code>

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

^ Позиция параметра ^ Тип ^ Обязателен ^ По умолчанию ^ Описание ^
| 1 | целое (integer) | Нет | 4 | Количество символов для вставки. |
| 2 | строка (string) | Нет | (один пробел) | Символ для вставки. |

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

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

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

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

^ Позиция параметра ^ Тип ^ Обязателен ^ По умолчанию ^ Описание ^
| 1 | строка (string) | Да | n/a | Регулярное выражение для замены. |
| 2 | строка (string) | Да | n/a | Строка для замены. |

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

^ Позиция параметра ^ Тип ^ Обязателен ^ По умолчанию ^ Описание ^
| 1 | строка (string) | Да | n/a | Строка для поиска. |
| 2 | строка (string) | Да | n/a | Строка для замены. |

<code smarty>
{$articleTitle}
{$articleTitle|replace:"Garden":"Vineyard"}
{$articleTitle|replace:" ":"   "}
</code>

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

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

<code smarty>
{$number}
{$number|string_format:"%.2f"}
{$number|string_format:"%d"}
</code>

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

<note tip>
Если вы хотите сделать аналогичную операцию над частью текста шаблона, то используйте [[smarty:smarty4#strip|функцию strip]]. 
</note>

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

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

^ Позиция параметра ^ Тип ^ Обязателен ^ По умолчанию ^ Описание ^
| 1 | целое (integer) | Нет | 80 | Количество символов для обрезания. |
| 2 | строка (string) | Нет | ... | Текст, который добавляется, если произошло обрезание. |
| 3 | логический (boolean) | Нет | false | Указывает, надо ли обрезать по границе слова (false) или по символу (true). |

<code smarty>
{$articleTitle}
{$articleTitle|truncate}
{$articleTitle|truncate:30}
{$articleTitle|truncate:30:""}
{$articleTitle|truncate:30:"---"}
{$articleTitle|truncate:30:"":true}
{$articleTitle|truncate:30:"...":true}
</code>

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

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

^ Позиция параметра ^ Тип ^ Обязателен ^ По умолчанию ^ Описание ^
| 1 | целое (integer) | Нет | 80 | Количество столбцов для переноса. |
| 2 | строка (string) | Нет | \n | Строка, которая вставляется на месте переноса. |
| 3 | логический (boolean) | Нет | false | Указывает, переносить по солвам (false) или нет (true). |

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

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

<code smarty>
{$articleTitle}
{$articleTitle|upper|spacify}
{$articleTitle|lower|spacify|truncate}
{$articleTitle|lower|truncate:30|spacify}
{$articleTitle|lower|spacify|truncate:30:". . ."}
</code>

[[smarty:smarty4|Следующая глава]]