Smarty - a ferramenta para compilar templates para PHP
Anterior Capítulo 7. Funções internas Próxima

include

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.

Exemplo 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.

Exemplo 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.

Exemplo 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"}
Anterior Principal Próxima
foreach,foreachelse Acima include_php