{insert}

Тэг {insert} очень похож на тэг {include}, за исключением того, что {insert} НЕ кэшируется, когда кэширование включено. Он будет выполнен при каждом обращении к шаблону.

Допустим, вы имеете шаблон с баннером вверху страницы. Баннер может содержать любую смесь HTML, изображений, flash и т.д., то есть нельзя использовать просто статическую ссылку, и мы не хотим, чтобы код баннера кэшировался с остальной страницей. Тогда используем тэг {insert}: шаблон знает значения #banner_location_id# и #site_id# (взяты из конфигурационного файла) и должен вызвать функцию, чтобы получить код баннера.

{* пример вставки баннера *}
{insert name="getBanner" lid=#banner_location_id# sid=#site_id#}

В этом примере мы используем имя "getBanner" и передаем параметры #banner_location_id# и #site_id#. Smarty попробует вызвать функцию insert_getBanner() в вашей PHP программе, передав значения #banner_location_id# и #site_id# первым параметром в виде ассоциативного массива. Все имена функций вставки должны начинаться с "insert_" для предотвращения возможных конфликтов имен. Функция insert_getBanner() должна обработать переданные переменные и вернуть результат. Он будет отображен в шаблоне вместо тэга {insert}. В данном случае Smarty вызовет функцию insert_getBanner(array("lid" => "12345","sid" => "67890")); и выведет результат на месте тэга {insert}.

Если указан атрибут "assign", то вывод функции вставки будет присвоен указанной переменной вместо отображения. ЗАМЕЧАНИЕ: присвоение вывода тэга {insert} переменной шаблона не очень полезно, когда кеширование включено.

Если указан атрибут "script", то указанный PHP-файл будет подключен (только однажды) перед вызовом функции вставки. Это удобно, когда функция может не сущетсвовать, и должен быть подключен PHP-файл, чтобы определить функцию. Путь к файлу должен быть либо абсолтным, либо относительным относительно $trusted_dir. Когда security активирована, то PHP-файл должен быть в папке $trusted_dir.

Обьект Smarty передается в функцию как второй параметр. Так вы можете использовать и модифицировать информацию из объекта Smarty в функциях вставки.