smarty-php/smarty
1
0
Fork 0
mirror of https://github.com/smarty-php/smarty.git synced 2025-08-05 19:04:27 +02:00
Code Issues Packages Projects Releases Wiki Activity

added explanation of variables' scope within {include}

Browse Source
This commit is contained in:
messju
2005-12-09 15:30:13 +00:00
parent 09785da22a
commit fe19f13ca5
1 changed files with 18 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
docs/en/designers/language-builtin-functions/language-function-include.xml
View File

@@ -2,19 +2,25 @@
<!-- $Revision$ --> <!-- $Revision$ -->
<sect1 id="language.function.include"> <sect1 id="language.function.include">
<title>{include}</title> <title>{include}</title>
<para> <para>
{include} tags are used for including other templates in the current {include} tags are used for including other templates in the current
template. Any variables available in the current template are also template. Any variables available in the current template are also
available within the included template. The {include} tag must have available within the included template. The {include} tag must have
the attribute "file", which contains the template resource path. the attribute "file", which contains the template resource path.
</para> </para>
<para> <para>
You can optionally pass the <emphasis>'assign'</emphasis> attribute, You can optionally pass the <emphasis>'assign'</emphasis> attribute,
which will specify a template variable name that the output of which will specify a template variable name that the output of
{include} will be assigned to instead of {include} will be assigned to instead of
displayed. displayed.
</para>
<para>
All assigned variables' values are restored after the scope of the
included template is left. This means you can use all variables from
the including template inside the included template. But changes to
variables inside the included template are not visible inside the
including template after the {include} statement.
</para> </para>
<informaltable frame="all"> <informaltable frame="all">
<tgroup cols="5"> <tgroup cols="5">
<colspec colname="param" align="center" /> <colspec colname="param" align="center" />