You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@portals.apache.org by wo...@apache.org on 2014/11/17 14:19:09 UTC

svn commit: r1640158 - in /portals/site/applications/src/site: ./ argouml/ resources/images/ xdoc/ xdoc/webcontent2/

Author: woonsan
Date: Mon Nov 17 13:19:09 2014
New Revision: 1640158

URL: http://svn.apache.org/r1640158
Log:
APA-67: Adding skeletal apa-webcontent-2 site documentation

Added:
    portals/site/applications/src/site/argouml/
    portals/site/applications/src/site/argouml/apa-webcontent-2.zargo   (with props)
    portals/site/applications/src/site/resources/images/webcontent2-modules-view.png   (with props)
    portals/site/applications/src/site/xdoc/webcontent2/
    portals/site/applications/src/site/xdoc/webcontent2/content-rewriter-module.xml
    portals/site/applications/src/site/xdoc/webcontent2/index.xml
    portals/site/applications/src/site/xdoc/webcontent2/modules-overview.xml
    portals/site/applications/src/site/xdoc/webcontent2/portlets-module.xml
    portals/site/applications/src/site/xdoc/webcontent2/reverse-proxy-module.xml
    portals/site/applications/src/site/xdoc/webcontent2/war-module.xml
Modified:
    portals/site/applications/src/site/site.xml
    portals/site/applications/src/site/xdoc/download.xml
    portals/site/applications/src/site/xdoc/index.xml

Added: portals/site/applications/src/site/argouml/apa-webcontent-2.zargo
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/argouml/apa-webcontent-2.zargo?rev=1640158&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/site/applications/src/site/argouml/apa-webcontent-2.zargo
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: portals/site/applications/src/site/resources/images/webcontent2-modules-view.png
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/webcontent2-modules-view.png?rev=1640158&view=auto
==============================================================================
Binary file - no diff available.

Propchange: portals/site/applications/src/site/resources/images/webcontent2-modules-view.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Modified: portals/site/applications/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/site.xml?rev=1640158&r1=1640157&r2=1640158&view=diff
==============================================================================
--- portals/site/applications/src/site/site.xml (original)
+++ portals/site/applications/src/site/site.xml Mon Nov 17 13:19:09 2014
@@ -43,7 +43,14 @@
         <item name="Gems" href="./portals-gems/index.html" />
         <item name="Demo" href="./demo/index.html" />  
         <item name="RSS" href="./rss-main/index.html" />
-        <item name='WebContent' href='./webcontent/index.html'/>          
+        <item name="WebContent-2" href="./webcontent2/index.html">
+          <item name="Modules Overview" href="./webcontent2/modules-overview.html" />
+          <item name="Content Rewriter Module" href="./webcontent2/content-rewriter-module.html" />
+          <item name="Reverse Proxy Module" href="./webcontent2/reverse-proxy-module.html" />
+          <item name="Portlets Module" href="./webcontent2/portlets-module.html" />
+          <item name="WAR Module" href="./webcontent2/war-module.html" />
+        </item>
+        <item name='WebContent-1' href='./webcontent/index.html'/>          
         <item name='DB Browser' href='./dbbrowser/index.html'/>
         <item name="Logging" href="./logging/index.html"/>          
     </menu>

Modified: portals/site/applications/src/site/xdoc/download.xml
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/download.xml?rev=1640158&r1=1640157&r2=1640158&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/download.xml (original)
+++ portals/site/applications/src/site/xdoc/download.xml Mon Nov 17 13:19:09 2014
@@ -21,6 +21,7 @@
 		<subtitle>Documentation on How to Download Portals Applications</subtitle>
 		<authors>
 			<person name="David Sean Taylor" email="taylor@apache.org" />
+            <person name="Woonsan Ko" email="woonsan@apache.org" />
 		</authors>
 	</properties>
 	<body>
@@ -58,6 +59,12 @@
 					<td><a href="http://www.apache.org/dist/portals/applications/binaries/apa-rss-war-1.2.war.md5">here</a></td>
 					<td><a href="http://www.apache.org/dist/portals/applications/binaries/apa-rss-war-1.2.war.asc">here</a></td>
 				</tr>
+                <tr>
+                    <td>Web Content 2.0 Servlet/Portlet Application</td>
+                    <td><a href="http://www.apache.org/dyn/closer.cgi/portals/applications/binaries/apa-webcontent-war-2.0.war">apa-webcontent-war-2.0.war</a></td>
+                    <td><a href="http://www.apache.org/dist/portals/applications/binaries/apa-webcontent-war-2.0.war.md5">here</a></td>
+                    <td><a href="http://www.apache.org/dist/portals/applications/binaries/apa-webcontent-war-2.0.war.asc">here</a></td>
+                </tr>
 				<tr>
 					<td>Web Content 1.3 Portlet Application</td>
 					<td><a href="http://www.apache.org/dyn/closer.cgi/portals/applications/binaries/apa-webcontent-war-1.3.war">apa-webcontent-war-1.3.war</a></td>
@@ -96,6 +103,13 @@
 						<td><a href="http://www.apache.org/dist/portals/applications/sources/apa-rss-1.2-source-release.zip.asc">here</a></td>
                         <td><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310870&amp;version=12314955">here</a></td>
 					</tr>
+                    <tr>
+                        <td>Web Content 2.0 Servlet/Portlet Application</td>
+                        <td><a href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-webcontent-2.0-source-release.zip">apa-webcontent-2.0-source-release.zip</a></td>
+                        <td><a href="http://www.apache.org/dist/portals/applications/sources/apa-webcontent-2.0-source-release.zip.md5">here</a></td>
+                        <td><a href="http://www.apache.org/dist/portals/applications/sources/apa-webcontent-2.0-source-release.zip.asc">here</a></td>
+                        <td><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310870&amp;version=12319483">here</a></td>
+                    </tr>
 					<tr>
 						<td>Web Content 1.3 Portlet Application</td>
 						<td><a href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-webcontent-1.3-source-release.zip">apa-webcontent-1.3-source-release.zip</a></td>

Modified: portals/site/applications/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/index.xml?rev=1640158&r1=1640157&r2=1640158&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/index.xml (original)
+++ portals/site/applications/src/site/xdoc/index.xml Mon Nov 17 13:19:09 2014
@@ -109,6 +109,11 @@ under the Apache license developed at th
 <td>application</td>
 </tr>
 <tr>
+<td><a href="./webcontent2/index.html">Web Content 2</a></td>
+<td>A servlet/portlet application framework dedicated to the development of Reverse Proxying, Web Content rewriting and IFrame based web content.</td>
+<td>archive, application, servlets, portlets</td>
+</tr>
+<tr>
 <td><a href="./webcontent/index.html">Web Content</a></td>
 <td>A portlet application dedicated to the development of Web Content rewriting and IFrame based web content.</td>
 <td>application</td>

Added: portals/site/applications/src/site/xdoc/webcontent2/content-rewriter-module.xml
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/webcontent2/content-rewriter-module.xml?rev=1640158&view=auto
==============================================================================
--- portals/site/applications/src/site/xdoc/webcontent2/content-rewriter-module.xml (added)
+++ portals/site/applications/src/site/xdoc/webcontent2/content-rewriter-module.xml Mon Nov 17 13:19:09 2014
@@ -0,0 +1,34 @@
+<?xml version="1.0"?>
+  <!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements. See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version
+    2.0 (the "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0 Unless required by
+    applicable law or agreed to in writing, software distributed under
+    the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
+    OR CONDITIONS OF ANY KIND, either express or implied. See the
+    License for the specific language governing permissions and
+    limitations under the License.
+  -->
+<document>
+  <properties>
+    <title>Apache Portals Web Content Application 2 - Content Rewriter Module</title>
+    <subtitle>Welcome to Apache Portals Web Content Application 2 - Content Rewriter Module</subtitle>
+    <authors>
+      <person name="Woonsan Ko" email="woonsan@apache.org" />
+    </authors>
+  </properties>
+  <body>
+
+    <section name="Content Rewriter Module">
+      <p>TODO</p>
+    </section>
+
+  </body>
+
+</document>
+

Added: portals/site/applications/src/site/xdoc/webcontent2/index.xml
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/webcontent2/index.xml?rev=1640158&view=auto
==============================================================================
--- portals/site/applications/src/site/xdoc/webcontent2/index.xml (added)
+++ portals/site/applications/src/site/xdoc/webcontent2/index.xml Mon Nov 17 13:19:09 2014
@@ -0,0 +1,54 @@
+<?xml version="1.0"?>
+  <!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements. See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version
+    2.0 (the "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0 Unless required by
+    applicable law or agreed to in writing, software distributed under
+    the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
+    OR CONDITIONS OF ANY KIND, either express or implied. See the
+    License for the specific language governing permissions and
+    limitations under the License.
+  -->
+<document>
+  <properties>
+    <title>Apache Portals Web Content Application 2</title>
+    <subtitle>Welcome to Apache Portals Web Content Application 2</subtitle>
+    <authors>
+      <person name="Woonsan Ko" email="woonsan@apache.org" />
+    </authors>
+  </properties>
+  <body>
+    <section name="Welcome to Apache Portals Web Content Application 2">
+      <div id="downloadbox">
+        <h5>Get Portals Web Content App</h5>
+        <p>
+          <a href="../download.html">
+            <img valign="top" src="../images/folder-open.gif" border="0" alt="" title="download" />
+            Download
+          </a>
+          Portals Applications WebContent 2.0
+        </p>
+        <ul>
+          <li>
+            <a href="../getting-started.html">System Requirements</a>
+          </li>
+        </ul>
+      </div>
+      <p>
+        A servlet/portlet application framework dedicated to the development of reverse proxying,
+        web content rewriting and IFrame based web content rendering.
+        The servlet/filter modules are designed to serve remote web content based on path mappings,
+        and the portlet modules are designed to serve web content inside portlet windows.
+      </p>
+
+    </section>
+
+  </body>
+
+</document>
+

Added: portals/site/applications/src/site/xdoc/webcontent2/modules-overview.xml
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/webcontent2/modules-overview.xml?rev=1640158&view=auto
==============================================================================
--- portals/site/applications/src/site/xdoc/webcontent2/modules-overview.xml (added)
+++ portals/site/applications/src/site/xdoc/webcontent2/modules-overview.xml Mon Nov 17 13:19:09 2014
@@ -0,0 +1,39 @@
+<?xml version="1.0"?>
+  <!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements. See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version
+    2.0 (the "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0 Unless required by
+    applicable law or agreed to in writing, software distributed under
+    the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
+    OR CONDITIONS OF ANY KIND, either express or implied. See the
+    License for the specific language governing permissions and
+    limitations under the License.
+  -->
+<document>
+  <properties>
+    <title>Apache Portals Web Content Application 2 - Modules Overview</title>
+    <subtitle>Welcome to Apache Portals Web Content Application 2 - Modules Overview</subtitle>
+    <authors>
+      <person name="Woonsan Ko" email="woonsan@apache.org" />
+    </authors>
+  </properties>
+  <body>
+
+    <section name="Modules Overview">
+
+      <p>
+        The Web Content Application 2 consists of four modules:
+      </p>
+      <img src="../images/webcontent2-modules-view.png" alt="Modules View" />
+
+    </section>
+
+  </body>
+
+</document>
+

Added: portals/site/applications/src/site/xdoc/webcontent2/portlets-module.xml
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/webcontent2/portlets-module.xml?rev=1640158&view=auto
==============================================================================
--- portals/site/applications/src/site/xdoc/webcontent2/portlets-module.xml (added)
+++ portals/site/applications/src/site/xdoc/webcontent2/portlets-module.xml Mon Nov 17 13:19:09 2014
@@ -0,0 +1,341 @@
+<?xml version="1.0"?>
+  <!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements. See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version
+    2.0 (the "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0 Unless required by
+    applicable law or agreed to in writing, software distributed under
+    the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
+    OR CONDITIONS OF ANY KIND, either express or implied. See the
+    License for the specific language governing permissions and
+    limitations under the License.
+  -->
+<document>
+  <properties>
+    <title>Apache Portals Web Content Application 2 - Portlets Module</title>
+    <subtitle>Welcome to Apache Portals Web Content Application 2 - Portlets Module</subtitle>
+    <authors>
+      <person name="Woonsan Ko" email="woonsan@apache.org" />
+    </authors>
+  </properties>
+  <body>
+
+    <section name="Portlets Module">
+
+      <p>
+        The Web Content Application 2 consists of three portlets
+        that have similiar functionality, but different approaches:
+        <ul>
+          <li>IFrame Portlet</li>
+          <li>
+            ReverseProxy IFrame Portlet
+            <ul>
+              <li><a href="rproxy.html">Reverse Proxy Service</a></li>
+            </ul>
+          </li>
+          <li>Web Content Portlet</li>
+        </ul>
+        All the portlets host content from a different website or local
+        servlet inside a portlet window. 
+      </p>
+      <p>
+        The IFrame Portet achieves this
+        by embedding an HTML
+        <a href='http://www.w3schools.com/TAGS/tag_iframe.asp'>iframe</a>
+        within a portlet.
+      </p>
+      <p>
+        The ReverseProxy IFrame Portlet behaves in the same way as IFrame Portlet does,
+        except that it uses <a href="rproxy.html">Reverse Proxy Service</a> URLs
+        instead of the original SRC URLs.
+        By using Reverse Proxy service component, more sophisticated content can be
+        served by setting content rewriting configurations or Cross-Domain Scripting can be enabled. 
+        The Web Content Application includes Reverse Proxy Service servlet and component.
+      </p>
+      <p>
+        The Web Content portlet takes a more complicated approach: it actually
+        embeds the content of the remote website inside the HTML payload
+        delivered by the portal, without the help of the browser.
+        This approach is more complicated since it may require rewriting
+        all links within the hosted website, that is, if you want to
+        keep the website navigation inside the portlet window.
+        While a noble cause, this approach is far from perfect and does not
+        always work correctly.
+      </p>
+      <p>
+        If you are interested in secure versions of these portlets, see
+        the Jetspeed-specific versions of the IFrame, ReverseProxyIFrame, or WebContent
+        portlets found at the
+        <a href='http://portals.apache.org/jetspeed-2/applications/j2-admin.html'>Jetspeed J2-Admin</a>
+        website.
+        The SSOIFrame, SSOReverseProxyIFrame and SSOWebContent portlets leverage the Jetspeed SSO
+        Services, and are not portable to other portal servers.
+      </p>
+      <p>Here are the classes to declare when using the portlets:</p>
+      <source><![CDATA[
+<portlet-class>org.apache.portals.applications.webcontent.portlet.IFrameGenericPortlet</portlet-class>        
+      ]]></source>
+      <p>
+        <em>Note: The ReverseProxyIFramePortlet uses the same class, but has different preferences configurations.</em>
+      </p>
+      <p>or</p>
+      <source><![CDATA[
+<portlet-class>org.apache.portals.applications.webcontent.portlet.WebContentPortlet</portlet-class>        
+      ]]></source>
+      <subsection name='Web Content Portlet Preferences'>
+        <table>
+          <tr>
+            <th>Name</th>
+            <th>Example Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>SRC</td>
+            <td>http://www.google.com</td>
+            <td>The URL of the remote or local site to be hosted.
+            </td>
+          </tr>
+          <tr>
+            <td>PROXYHOST</td>
+            <td>proxyserver1.mycompany.com</td>
+            <td>The proxy server host name.</td>
+          </tr>
+          <tr>
+            <td>PROXYPORT</td>
+            <td>8000</td>
+            <td>The proxy server port.</td>
+          </tr>
+        </table>
+      </subsection>
+      <subsection name='IFrame Portlet Preferences'>
+        <table>
+          <tr>
+            <th>Name</th>
+            <th>Example Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>SRC</td>
+            <td>
+              http://portals.apache.org/index.html<br/>
+            </td>
+            <td>
+              The URL of the remote or local site to be hosted.
+              <br/>
+              <p>
+                You can use predefined variables, ${serverName}, ${serverPort} or ${contextPath}, to set local URLs.<br/>
+                So, if the requested server name is 'localhost', the requested server port is '8080' and the request context path is '/webcontent', then
+                the following configurations are equivalent:<br/>
+                <ul>
+                  <li>http://localhost:8080/webcontent/index.html</li>
+                  <li>http://localhost:${serverPort}/webcontent/index.html</li>
+                  <li>http://${serverName}:${serverPort}/webcontent/index.html</li>
+                  <li>http://${serverName}:${serverPort}/${contextPath}/index.html</li>
+                </ul>
+              </p>
+            </td>
+          </tr>
+          <tr>
+            <td>AUTORESIZE</td>
+            <td>true</td>
+            <td>
+              If this preference value is set to true, then
+              this portlet tries to resize the height of the IFRAME tag based on the rendered content.
+              However, this option is applied only when the 'SRC' url is in the same domain of the portal URL.
+            </td>
+          </tr>
+          <tr>
+            <td>VISITLASTPAGE</td>
+            <td>true</td>
+            <td>
+              If this preference value is set to true, then
+              this last visited page in this portlet is stored in the session and the page will be revisited
+              when the portlet is rendered again.
+              However, this option is applied only when the 'SRC' url is in the same domain of the portal URL.
+            </td>
+          </tr>
+          <tr>
+            <td>HEIGHT</td>
+            <td>300</td>
+            <td>The height of the IFrame window when in Normal Window State</td>
+          </tr>
+          <tr>
+            <td>WIDTH</td>
+            <td>100%</td>
+            <td>The width of the IFrame window when in Normal Window State. Can be a percentage of available space to the portlet, or a constant value</td>
+          </tr>
+          <tr>
+            <td>MAX-HEIGHT</td>
+            <td>800</td>
+            <td>The height of the IFrame window when in Maximized Window State</td>
+          </tr>
+          <tr>
+            <td>MAX-WIDTH</td>
+            <td>100%</td>
+            <td>The width of the IFrame window when in Maximized Window State. Can be a percentage of available space to the portlet, or a constant value</td>
+          </tr>
+          <tr>
+            <td>SCROLLING</td>
+            <td>AUTO | YES | NO</td>
+            <td>Specifies whether or not to display scrollbars in an iframe</td>
+          </tr>
+        </table>
+      </subsection>
+      <subsection name='ReverseProxyIFrame Portlet Preferences'>
+        <p>
+          <em>
+            Note: The ReverseProxyService should be able to access application level session attribute
+                  shared by a portlet of IFrameGenericPortlet or its descendant, which is conforming
+                  with the Portlet Specification.
+                  If you are using Tomcat, then be sure to set the following in the server.xml to enable
+                  this proper Portlet API session management requirements.
+                  Modify the Connector element (default on port 8080) by adding the folowing attribute:
+            <source><![CDATA[emptySessionPath="true"]]></source>
+          </em>
+        </p>
+        <table>
+          <tr>
+            <th>Name</th>
+            <th>Example Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>SRC</td>
+            <td>http://portals.apache.org/index.html</td>
+            <td>
+              The URL of the remote or local site to be hosted.
+              <br/>
+              <p>
+                You can use predefined variables, ${serverName}, ${serverPort} or ${contextPath}, to set local URLs.<br/>
+                So, if the requested server name is 'localhost', the requested server port is '8080' and the request context path is '/webcontent', then
+                the following configurations are equivalent:<br/>
+                <ul>
+                  <li>http://localhost:8080/webcontent/index.html</li>
+                  <li>http://localhost:${serverPort}/webcontent/index.html</li>
+                  <li>http://${serverName}:${serverPort}/webcontent/index.html</li>
+                  <li>http://${serverName}:${serverPort}/${contextPath}/index.html</li>
+                </ul>
+              </p>
+            </td>
+          </tr>
+          <tr>
+            <td>PROXYREMOTEURL</td>
+            <td>http://portals.apache.org/</td>
+            <td>
+              The base URL of the remote site.
+              If 'PROXYREMOTEURL' and 'PROXYLOCALPATH' are set,
+              then this portlet translates the 'SRC' url into a reverse proxy url
+              by replacing the value of 'PROXYREMOTEURL' by the value of 'PROXYLOCALPATH'.
+              If you use the default reverse proxy component, then you should configure
+              the path mappings in the configuration file. (e.g., /WEB-INF/conf/reverseproxy.properties)
+              <br/>
+              <p>
+                You can use predefined variables, ${serverName}, ${serverPort} or ${contextPath}, to set local URLs.<br/>
+                So, if the requested server name is 'localhost', the requested server port is '8080' and the request context path is '/webcontent', then
+                the following configurations are equivalent:<br/>
+                <ul>
+                  <li>http://localhost:8080/webcontent/index.html</li>
+                  <li>http://localhost:${serverPort}/webcontent/index.html</li>
+                  <li>http://${serverName}:${serverPort}/webcontent/index.html</li>
+                  <li>http://${serverName}:${serverPort}/${contextPath}/index.html</li>
+                </ul>
+              </p>
+            </td>
+          </tr>
+          <tr>
+            <td>PROXYLOCALPATH</td>
+            <td>${contextPath}/rproxy/portals/</td>
+            <td>
+              The base URL of the local proxy URL.
+              If the value of 'PROXYLOCALPATH' doesn't starts with '/', then
+              this portlet prepends the context path of the local servlet application.
+              By default, this web application contains reverse proxy servlet mapped by '/rproxy' path.
+              For some cases, you can use other external proxy server by setting a context relative path
+              or absolute url such as '/apache' or 'http://www.localhost.com/apache'.
+              If you use the default reverse proxy component, then you should configure
+              the path mappings in the configuration file. (e.g., /WEB-INF/conf/reverseproxy.properties)
+              <br/>
+              <p>
+                You can use the predefined variable, ${contextPath}, to set local paths.<br/>
+                So, if the request context path is '/webcontent', then
+                the following configurations are equivalent:<br/>
+                <ul>
+                  <li>/webcontent/rproxy/portals</li>
+                  <li>${contextPath}/rproxy/portals</li>
+                </ul>
+              </p>
+            </td>
+          </tr>
+          <tr>
+            <td>AUTORESIZE</td>
+            <td>true</td>
+            <td>
+              If this preference value is set to true, then
+              this portlet tries to resize the height of the IFRAME tag based on the rendered content.
+              However, this option is applied only when the 'SRC' url is in the same domain of the portal URL.
+              Also, if 'PROXYREMOTEURL' and 'PROXYLOCALPATH' are set to use a proxy url in the same domain,
+              then this option can be applied as well.
+            </td>
+          </tr>
+          <tr>
+            <td>VISITLASTPAGE</td>
+            <td>true</td>
+            <td>
+              If this preference value is set to true, then
+              this last visited page in this portlet is stored in the session and the page will be revisited
+              when the portlet is rendered again.
+              However, this option is applied only when the 'SRC' url is in the same domain of the portal URL.
+              Also, if 'PROXYREMOTEURL' and 'PROXYLOCALPATH' are set to use a proxy url in the same domain,
+              then this option can be applied as well.
+            </td>
+          </tr>
+          <tr>
+            <td>HEIGHT</td>
+            <td>300</td>
+            <td>The height of the IFrame window when in Normal Window State</td>
+          </tr>
+          <tr>
+            <td>WIDTH</td>
+            <td>100%</td>
+            <td>The width of the IFrame window when in Normal Window State. Can be a percentage of available space to the portlet, or a constant value</td>
+          </tr>
+          <tr>
+            <td>MAX-HEIGHT</td>
+            <td>800</td>
+            <td>The height of the IFrame window when in Maximized Window State</td>
+          </tr>
+          <tr>
+            <td>MAX-WIDTH</td>
+            <td>100%</td>
+            <td>The width of the IFrame window when in Maximized Window State. Can be a percentage of available space to the portlet, or a constant value</td>
+          </tr>
+          <tr>
+            <td>SCROLLING</td>
+            <td>AUTO | YES | NO</td>
+            <td>Specifies whether or not to display scrollbars in an iframe</td>
+          </tr>
+        </table>
+        <p>
+          For details on how to configure the Reverse Proxy Service, please refer to <a href="rproxy.html">Introduction to Reverse Proxy Service</a>.
+        </p>
+        
+      </subsection>
+
+      <p>Here are examples of the Web Content, IFrame and ReverseProxyIFrame Portlets:</p>
+      <br/>
+      <img src='../images/wc.png'/>
+      <br/>
+      <img src='../images/iframe.png'/>
+      <br/>
+      <img src='../images/rproxyif.png'/>
+
+    </section>
+
+  </body>
+
+</document>
+

Added: portals/site/applications/src/site/xdoc/webcontent2/reverse-proxy-module.xml
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/webcontent2/reverse-proxy-module.xml?rev=1640158&view=auto
==============================================================================
--- portals/site/applications/src/site/xdoc/webcontent2/reverse-proxy-module.xml (added)
+++ portals/site/applications/src/site/xdoc/webcontent2/reverse-proxy-module.xml Mon Nov 17 13:19:09 2014
@@ -0,0 +1,34 @@
+<?xml version="1.0"?>
+  <!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements. See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version
+    2.0 (the "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0 Unless required by
+    applicable law or agreed to in writing, software distributed under
+    the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
+    OR CONDITIONS OF ANY KIND, either express or implied. See the
+    License for the specific language governing permissions and
+    limitations under the License.
+  -->
+<document>
+  <properties>
+    <title>Apache Portals Web Content Application 2 - Reverse Proxy Module</title>
+    <subtitle>Welcome to Apache Portals Web Content Application 2 - Reverse Proxy Module</subtitle>
+    <authors>
+      <person name="Woonsan Ko" email="woonsan@apache.org" />
+    </authors>
+  </properties>
+  <body>
+
+    <section name="Reverse Proxy Module">
+      <p>TODO</p>
+    </section>
+
+  </body>
+
+</document>
+

Added: portals/site/applications/src/site/xdoc/webcontent2/war-module.xml
URL: http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/webcontent2/war-module.xml?rev=1640158&view=auto
==============================================================================
--- portals/site/applications/src/site/xdoc/webcontent2/war-module.xml (added)
+++ portals/site/applications/src/site/xdoc/webcontent2/war-module.xml Mon Nov 17 13:19:09 2014
@@ -0,0 +1,34 @@
+<?xml version="1.0"?>
+  <!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements. See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version
+    2.0 (the "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0 Unless required by
+    applicable law or agreed to in writing, software distributed under
+    the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
+    OR CONDITIONS OF ANY KIND, either express or implied. See the
+    License for the specific language governing permissions and
+    limitations under the License.
+  -->
+<document>
+  <properties>
+    <title>Apache Portals Web Content Application 2 - WAR Module</title>
+    <subtitle>Welcome to Apache Portals Web Content Application 2 - WAR Module</subtitle>
+    <authors>
+      <person name="Woonsan Ko" email="woonsan@apache.org" />
+    </authors>
+  </properties>
+  <body>
+
+    <section name="WAR Module">
+      <p>TODO</p>
+    </section>
+
+  </body>
+
+</document>
+