include

Имя аттрибута Тип Обязателен По умолчанию Описание
file строка (string) Да n/a Имя файла шаблона для включения
assign строка (string) Нет n/a Имя переменной, которой присвоится вывод шаблона
[var ...] [var type] Нет n/a Переменные, переданные в локальную область включаемого шаблона

Тэги include используются для включения других шаблонов в текущий. Любые переменные, доступные в текущем шаблоне, доступны и во включаемом. Тэг include должен иметь аттрибут "file", который указывает имя ресурса шаблона.

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

Пример 7-6. функция include

{include file="header.tpl"}

{* тело шаблона *}

{include file="footer.tpl"}

Вы также можете передать переменные в подключаемый шаблон в виде атрибутов. Любая переменная, переданная в подключаемый шаблон, доступны только в области видимости подключаемого файла. Переданные переменные имеют преимущество перед существующими переменными с аналогичными именами.

Пример 7-7. функция include: передача переменных

{include file="header.tpl" title="Main Menu" table_bgcolor="#c0c0c0"}

{* тело шаблона *}

{include file="footer.tpl" logo="http://my.domain.com/logo.gif"}

Для подключения файлов вне папки $template_dir можно указывать файл с помощью ресурсов.

Пример 7-8. функция include: пример использвоания ресурсов

{* абсолютный путь к файлу *}
{include file="/usr/local/include/templates/header.tpl"}

{* абсолютный путь к файлу (аналогично) *}
{include file="file:/usr/local/include/templates/header.tpl"}

{* абсолютный путь к файлу в стиле windows (НЕОБХОДИМО использовать префикс "file:") *}
{include file="file:C:/www/pub/templates/header.tpl"}

{* подключить шаблон из ресурса "db" *}
{include file="db:header.tpl"}