Tiles 3 Plugin

• Features
• Usage
• Example
• Settings
• Installation

This plugin was dropped in Struts 2.5, instead please use Tiles Plugin which was extended and upgraded to Tiles 3.

Tiles is a templating framework designed to easily allow the creation of web application pages with a consistent look and feel. It can be used for both page decorating and componentization. This is the first release of the plugin!

The Tiles 3 plugin allows actions to return Tiles 3 pages.

Features

• Supports Tiles in Freemarker, JSP, and Velocity - more testing is needed.

Usage

The following steps must be taken in order to enable Tiles 3 support within your Struts2 application:

1. Include the struts-tiles3-plugin as a dependency in your web application, do not include the old struts2-tiles-plugin! If you are using maven3, the dependency configuration will be similar to:

<dependency>
  <groupId>org.apache.struts</groupId>
  <artifactId>struts2-tiles3-plugin</artifactId>
  <version>${version.tiles}</version>
  <scope>compile</scope>
</dependency>

2. Register the tiles listener.

<listener>
    <listener-class>org.apache.tiles.extras.complete.CompleteAutoloadTilesListener</listener-class>
</listener>

3. All package definitions which require tiles support must either extend the tiles-default package or must register the Tiles 3 Result type definition.

<result-types>
  <result-type name="tiles" class="org.apache.struts2.views.tiles.TilesResult"/>
</result-types>

4. Configure your actions to utilize a tiles definition:

<action name="sample" class="org.apache.struts2.tiles.example.SampleAction" >
  <result name="success" type="tiles">tilesWorks</result>
</action>

Example

TBD

Settings

This plugin does inherits settings from Tiles configuration.

Installation

This plugin can be installed by copying the plugin jar into your application’s /WEB-INF/lib directory. No other files need to be copied or created.