Introduction

The <ISFILEBUNDLE> tag allows you to bundle multiple smaller source files into one big file and to configure processors for the bundled files. <ISFILEBUNDLE> has the two supporting tags <ISFILE> and <ISRENDER> .
Each file bundle must have one <ISRENDER> tag. <ISRENDER> provides a render method for all resulting files of this file bundle. The variable File:Name (see example below) is the name of the bundle or the name of one of the configured files.
A file bundle must have one or more <ISFILE> tags. <ISFILE> is used to declare files to be processed via its name attribute.

Configuration

The behavior of the <ISFILEBUNDLE> tag depends on the following properties listed in <IS.INSTANCE.SHARE>/system/config/cluster/appserver.properties:

Syntax

<isfilebundle
name = "{relative target path}"
processors = "{comma separated default processor list}"
>
<isrender>
... some HTML and ISML code ...
</isrender>
[ <isfile
name = "{relative source path}"
[ processors = "{comma separated processor list}" ] />
]
</isfilebundle>

Example

<isfilebundle name="/css/bundles/BundledCSSFile.css" processors="CSSCompressor">
  <isrender>
    <link type="text/css" rel="stylesheet" href="#webRoot().'/'.File:Name#" media="all">
  </isrender>
  <isfile name="/css/CSS_File1.css"/>
  <isfile name="/css/CSS_File2.css"/>
  <isfile name="/css/CSS_File3.css"/>
  <isfile name="/css/CSS_File4.css"/>
</isfilebundle>
<isfilebundle name="/js/bundles/BundledJSFile.js" processors="JSCompressor, SemicolonAppender">
  <isrender>
    <script src="#webRoot().'/'.File:Name#"></script>
  </isrender>
  <isfile name="/js/JS_File1.js"/>
  <isfile name="/js/JS_File2.js"/>
  <isfile name="/js/JS_File3.js"/>
  <isfile name="/js/JS_File4.js"/>
</isfilebundle>

Attributes

name

This attribute is required.
name = relative target path

It specifies the relative path to the bundled file.

processors

This attribute is required.
processors = comma separated default processor list

It specifies the components that should process the declared files. The values must be a comma-separated list of valid processor names. The processors are executed in reverse order (from last to first).

The following three processors are available:

• CSSCompressor
  Minimizes a CSS file.
• JSCompressor
  Minimizes a JavaScript file.
• SemicolonAppender
  Appends a semicolon (";") to the end of each file. Normally there is no need to do this. However, for the bundling of some JavaScript files it is necessary to add a ";" at the end of the file. It is recommended to fix this issue directly in the files instead of using this SemicolonAppender.