Пользовательские функции в языке шаблонов Smarty

Smarty содержит несколько пользовательский функциий, которые вы можете использовать в шаблонах.

assign используется для установки значения переменной в процессе выполнения шаблона.

counter используется для управления счетчиком. counter запоминает количество итераций. Можно регулировать начало, интервал и направление отсчета, а также указать, выводить ил значение счетчика или нет. Можно запустить несколько счетчиков одновременно, указав уникальное имя для каждого. Если имя счетчика не указано, будет использовано по умолчанию 'default'. Если указан аттрибут «assign», то вывод тэга counter будет присвоен переменной шаблона, вместо отображения.

{* инициализируем счетчик *}
{counter start=0 skip=2 print=false}
 
{counter}<br>
{counter}<br>
{counter}<br>
{counter}<br>

Cycle используется для прохода через множество значений. С его помощью можно легко реализовать переключение между двумя и более цветами в таблице, или пройти цикл через массив. Можно проходить через несколько множеств значений одновременно, указав аттрибут name. Имена должны быть уникальными. Можно не отображать данный элемент, установив аттрибут print в ложь (false). Удобно для пропуска значения, без его вывода. Аттрибут advance используется для повтора значения. Если установлен в истина (true), то при следующем вызове cycle будет выведено то же значение. Если указан специальный аттрибут «assign», то вывод cycle присваивается переменной, вместо отображения.

{section name=rows loop=$data}
    <tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}">
       <td>{$data[rows]}</td>
    </tr>
{/section}

eval используется для обработки переменной, как шаблона. Можно использовать для таких вещей, как хранение шаблонных тэгов/переменных в переменной или в файлах конфигруации. Если указан специальный аттрибут «assign», то вывод тэга eval присваивается переменной, вместо отображения.

Пользовательская функция html_checkboxes генерирует группу HTML фложков по указанной информации. Также заботится об флажках, которые выбраны по умолчанию. параметры vslues и output обязательны, если не указан аттрибут options. Весь вывод совместим с XHTML. Все параметры, которые не указаны в списке выводятся в виде пар name/value в каждом созданном тэге <input>.

Пользовательская функция html_options генерирует группу html тэгов option по указанной информации. Также заботится о выбранных по умолчанию элементах. Аттрибуты values и output обязательны, если не указан аттрибут options. Если данное значение - массив, то оно будет представлено в виде html OPTGROUP. Рекурсия с OPTGROUP поддерживается. Весь вывод совместим с XHTML. Если указан необязательный аттрибут name , то группа опций заключится в тэг <select name=«groupname»> и </select>, иначе сгенерируется только группа опций. Все параметры, которые не указаны выше, выводятся в виде пары name/value внутри тэга <select>-tag. Они игнорируются, если аттрибут name не указан.

<select name=customer_id>
    {html_options options=$cust_options selected=$customer_id}
</select>

Пользовательсякая функция html_radios генерирует HMTL код группы элементов выбора (radio button group). Автоматически устанавливает выбранное значение, если оно укзано. Требует наличия аттрибутов values и output или аттрибута options. Сгенерированный HMTL код совместим с XHTML. Все параметры, которые не указаны в таблице выше, передаются и выводятся внутри каждого созданного тэга <input>.

Пользовательская функция html_select_date генерирует поля выбора даты.

Пользовательская функция html_select_time генерирует HTML поля выбора времени.

Пользовательская функция html_table выводит массив в виде HTML таблицы. Аттрибут cols указывает количество колонок. Аттрибуты table_attr , tr_attr и td_attr указывают дополнительные аттрибуты тэго table, tr и td. Если значение tr_attr или td_attr - массив, то кго значения циклический повторяются. Атрибут trailpad устанавливает значения для остаточных ячеек на последней строке таблицы.

{html_table loop=$data}
{html_table loop=$data cols=4 table_attr='border="0"'}
{html_table loop=$data cols=4 tr_attr=$tr}

Пользовательская функция math позволяет дизайнерам шаблонов вычислять математические выражения в шаблоне. Любая численная переменная шаблона может быть использована в выражении. Переменные, используемые в выражении, передаються в качестве параметров, которые могут быть как и переменные шаблона, так и статические щначения. Допустимые операторы: +, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, srans и tan. Ознакомтесь с php документацией под данным функциям. Если указан аттрибут «assign», то вывод будет присвоен переменной, вместо отображения.

{* $height=4, $width=5 *}
{math equation="x + y" x=$height y=$width}

Пользовательская функция mailto автоматизирует создание ссылок на e-mail адреса с возможностью кодирования их. Кодирование усложняет работу web-пауков, которые собирают e-mail адреса с вашего сайта.

{mailto address="me@domain.com"}
{mailto address="me@domain.com" text="send me some mail"}
{mailto address="me@domain.com" encode="javascript"}
{mailto address="me@domain.com" encode="hex"}
{mailto address="me@domain.com" subject="Hello to you!"}
{mailto address="me@domain.com" cc="you@domain.com,they@domain.com"}
{mailto address="me@domain.com" extra='class="email"'}

Функция textformat используеться для форматирования текст, заключенного внтури ее. В основном убирает лишние пробелы и специальные символы, а так же форматирует абзацы, делает отступы, переносит слова.

{textformat wrap=40 indent=4 indent_first=4}
 
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
 
This is bar.
 
bar foo bar foo     foo.
bar foo bar foo     foo.
bar foo bar foo     foo.
bar foo bar foo     foo.
bar foo bar foo     foo.
bar foo bar foo     foo.
bar foo bar foo     foo.
 
{/textformat}

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