"File Loader" plugin

"ARI Smart Content - File Loader" plugin embed files into Joomla! content. The plugin can be enabled/disabled and configured on "Extensions → Plugin Manager" page on Joomla! backend. Common information how to use "ARI Smart Content" applications plugins is here. {file} plugin tag is used for the plugin. The following code  embeds <joomla_directory>/template/license.txt file into content:

{file path="template/license.txt"}{/file}

It is possible to use variables in files. Files can be used as simple templates with this feature. For example a template for news can be created:

<h3 class="news-title">{$title}</h3>

<div class="box">

       <div class="box-in news-content">

               {$content}

       </div>

</div>

{$title} and {$content} variables are used in the sample content above. The following plugin code will embed the file and replace {$title} with Sample news value and {$content} with Just a sample content value:

{file path="templates/news.txt"}

       {var name="title"}Sample news{/var}

       {var name="content"}Just a sample content{/var}

{/file}

Plugin code syntax

The following attributes can be used for {file} tag:

• path is required attribute to specify a path to file which will be embedded into content. If you want to load data from a file which is located in Joomla! root directory or sub-directory of Joomla! root folder then enter a relative path based on Joomla! root directory. For example if the path to the file is <joomla_directory>/data/report.txt then populate the parameter with data/report.txt value. Don't use any additional / symbols in this way (for example /data/report.txt because it will be another file path, / is used on Unix system as path to root directory and it is usually differs from Joomla! root directory). If the file is located outside Joomla! root directory then enter full path to the file (for example /home/data/report.txt).

• encoding is used to specify encoding which is used in the file. Populate this parameter only if non-UTF8 encoding is used in the file. Possible values: ISO-8859-1 and etc.

• useVars is used to disable using variables in files. If the parameter is set to 0 value then variables in files will not replaced with values which are defined in plugin code. Default value is 1. Possible values: 1 or 0.

Possible to use {var} tag inside {file} tag to define values for variables from embedded files. Value of the variable are placed between {var} and {/var} tags. The following attributes can be used for {var} tag:

• name is a name of variable. The plugin will replace all variables which have defined name with value which are entered between {var} and {/var} tags.