{include}

{include} tags are used for including other templates in the current template. Any variables available in the current template are also available within the included template.

Attributes:

Attribute Name Type Required Default Description
file string Yes n/a The name of the template file to include
assign string No n/a The name of the variable that the output of include will be assigned to
cache_lifetime integer No n/a Enable caching of this subtemplate with an individual cache lifetime
compile_id string/integer No n/a Compile this subtemplate with an individual compile_id
cache_id string/integer No n/a Enable caching of this subtemplate with an individual cache_id
scope string No n/a Define the scope of all in the subtemplate assigned variables: 'parent','root' or 'global'
[var ...] [var type] No n/a variable to pass local to template

Option Flags:

Name Description
nocache Disables caching of this subtemplate
caching Enable caching of this subtemplate
inline If set merge the compile code of the subtemplate into the compiled calling template

Example 7.46. Simple {include} example

<html>
<head>
  <title>{$title}</title>
</head>
<body>
{include file='page_header.tpl'}

{* body of template goes here, the $tpl_name variable
   is replaced with a value eg 'contact.tpl'
*}
{include file="$tpl_name.tpl"}

{* using shortform file attribute *}
{include 'page_footer.tpl'}
</body>
</html>

  

Example 7.47. {include} passing variables

{include 'links.tpl' title='Newest links' links=$link_array}
{* body of template goes here *}
{include 'footer.tpl' foo='bar'}

  

The template above includes the example links.tpl below

<div id="box">
<h3>{$title}{/h3>
<ul>
{foreach from=$links item=l}
.. do stuff  ...
</foreach}
</ul>
</div>


Example 7.48. {include} using parent scope

Variables assigned in the included template will be seen in the including template.

{include 'sub_template.tpl' scope=parent}
...
{* display variables assigned in sub_template *}
{$foo}<br>
{$bar}<br>
...

  

The template above includes the example sub_template.tpl below

...
{assign var=foo value='something'}
{assign var=bar value='value'}
...


Example 7.49. {include} with disabled caching

The included template will not be cached.

{include 'sub_template.tpl' nocache}
...

  

Example 7.50. {include} with individual cache lifetime

In this example included template will be cached with an individual cache lifetime of 500 seconds.

{include 'sub_template.tpl' cache_lifteime=500}
...

  

Example 7.51. {include} with forced caching

In this example included template will be cached independent of the global cahing setting.

{include 'sub_template.tpl' caching}
...

  

Example 7.52. {include} and assign to variable

This example assigns the contents of nav.tpl to the $navbar variable, which is then output at both the top and bottom of the page.

 
<body>
  {include 'nav.tpl' assign=navbar}
  {include 'header.tpl' title='Smarty is cool'}
    {$navbar}
    {* body of template goes here *}
    {$navbar}
  {include 'footer.tpl'}
</body>

   

Example 7.53. {include} with relative paths

This example includes another template relative to the directory of the current template.

   {include 'template-in-a-template_dir-directory.tpl'}
   {include './template-in-same-directory.tpl'}
   {include '../template-in-parent-directory.tpl'}

    

Example 7.54. Various {include} resource examples

{* absolute filepath *}
{include file='/usr/local/include/templates/header.tpl'}

{* absolute filepath (same thing) *}
{include file='file:/usr/local/include/templates/header.tpl'}

{* windows absolute filepath (MUST use "file:" prefix) *}
{include file='file:C:/www/pub/templates/header.tpl'}

{* include from template resource named "db" *}
{include file='db:header.tpl'}

{* include a $variable template - eg $module = 'contacts' *}
{include file="$module.tpl"}

{* wont work as its single quotes ie no variable substitution *}
{include file='$module.tpl'}

{* include a multi $variable template - eg amber/links.view.tpl *}
{include file="$style_dir/$module.$view.tpl"}

  

See also {include_php}, {insert}, {php}, template resources and componentized templates.