| Nome do Atributo | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| file | string | Sim | n/d | O nome do arquivo de template a incluir |
| assign | string | Não | n/d | O nome de uma variável que irá conter toda a saída do template |
| [var ...] | [var type] | Não | n/d | Variável para passar localmente para o template |
Tags include são usadas para incluir outros templates no template atual. Quaisquer variáveis disponíveis no template atual também estarão disponíveis junto com template incluído. A tag include deve ter o atributo "file", o qual contém o caminho do arquivo a incluir.
Você pode opcionalmente passar o atributo assign, o qual irá especificar o nome de uma variável de template para a qual conterá todo o conteúdo do include ao invés de mostrá-lo.
Example 7.6. function include
{include file="cabecalho.tpl"}
{* O conteúdo do template vem aqui *}
{include file="rodape.tpl"}
Você pode também passar variáveis para o template incluído como atributos. Quaisquer variáveis passadas para um template incluído como atributos estão disponíveis somente dentro do escopo do template incluído. As variáveis passadas como atributos sobrescrevem as variáveis de template atuais, no caso de ambas terem o mesmo nome.
Example 7.7. Função include passando variáveis
{include file="cabecalho.tpl" title="Menu Principal" table_bgcolor="#c0c0c0"}
{* O conteúdo de template vem aqui *}
{include file="rodape.tpl" logo="http://meu.dominio.com/logo.gif"}
Use a sintaxe de template resources para incluir arquivos fora do diretório $template_dir.
Example 7.8. Exemplos de recursos para a função include
{* caminho absoluto *}
{include file="/usr/local/include/templates/cabecalho.tpl"}
{* caminho absoluto (idem) *}
{include file="file:/usr/local/include/templates/cabecalho.tpl"}
{* caminho absoluto do windows (DEVE usar o prefixo "file:") *}
{include file="file:C:/www/pub/templates/cabecalho.tpl"}
{* incluir a partir do recurso de template chamado "db" *}
{include file="db:header.tpl"}