Namespaces allow separation of variables with the same name. This is useful for functions that create variables on the fly (e.g. section).

When you are editing a template there are always three namespace locators defined which you can utilize to address your variables. These three are:

When a new template is created all three namespace variables are set to the global namespace. New namespaces can then be opened using the name attribute present in many template functions. These are:

If the name attribute is omitted when using any of these functions no new namespace is created. The namespace is closed together with the closing tag of the function. Each time a namespace is created it is created within the current namespace. This means that you can have nested namespaces.

Example

This is an initial template file which starts out in the global namespace.

{let varglobal='Hello world'}

{* We did not open a namespace in the let and we are still in the global namespace *}

{* This means we can print var in the following way using all of the namespace accessing methods *} 

{$#varglobal}

{$varglobal}

{$:varglobal}

 

 {* Let's open the namespace foo and create the var varlocal using let *}

 {* This will change the current namespace but not the global and root namespace *}

 {let varlocal='Hello world in foo namespace' name='foo'}

   {* To print varlocal using the three accessing methods *}

   {$#foo:varlocal}

   {$foo:varlocal}

   {$:varlocal}

 

   {* If we want to print varglobal inside this namespace *}

   {$#varglobal}

   {$varglobal}

   {* Not accessible from the local scope *}

 

   {* Let's include another template here and open the scope bar *}

   {include uri='include.tpl' name='bar'}

 {/let}

 

{/let}

The contents of include.tpl:

{* Let's create another varlocal *}

{let varlocal='Hello world in include.tpl'}

{* Let's access the new varlocal we just defined *}

 {$#foo:bar:varlocal}

 {$varlocal}

 {$:varlocal}

 

{* To access the varlocal variable in the foo scope *}

 {$#foo:varlocal}

 {* Not possible to access using root and current scope *}

{/let}

Note that if you do not create any namespaces using the "name" attribute, the global, root and current namespaces always stay the same.