Author: cbrisson
Date: Tue Jun 26 10:21:05 2018
New Revision: 1834413
URL: http://svn.apache.org/viewvc?rev=1834413&view=rev
Log:
[site/tools] Update VelocityLayoutServlet doc
Modified:
velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext
Modified: velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext
URL:
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext?rev=1834413&r1=1834412&r2=1834413&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext
(original)
+++ velocity/site/cms/trunk/content/tools/devel/view-layoutservlet.mdtext Tue
Jun 26 10:21:05 2018
@@ -52,13 +52,24 @@ This saves you the trouble of doing the
## Alternative Layouts
-VLS provides two ways to specify an alternate template for a requested page:
+VLS provides several ways to specify an alternate template for a requested
page:
-1. **Specify the layout in the request parameters**
-
-Just add the query string "layout=MyOtherLayout.vm" to any request params and
the VLS will find it and render your screen within that layout instead of the
default layout. It don't matter how you get the layout param into the query
data, only that it's there.
+1. **Specify the layout in the request attribute**
-2. **Specify the layout in the requested screen.**
+ :::java
+ request.setAttribute("layout", "MyOtherLayout.vm");
+
+2. **Specify the layout by overloading the
`VelocityLayoutServlet.findLayout(HttpServletRequest)` function**
+
+ :::java
+ @Override
+ public String findLayout(HttpServletRequest request)
+ {
+ if (request.getParameter("change_layout") != null) return
"MyOtherLayout.vm";
+ else return super.findLayout(request)
+ }
+
+3. **Specify the layout in the requested screen.**
In the requested screen, put a line like this:
