Author: taylor
Date: Thu May 28 07:28:18 2009
New Revision: 779461
URL: http://svn.apache.org/viewvc?rev=779461&view=rev
Log:
completed and published APA docs for the 1.0 release
Added:
portals/site/applications/src/site/resources/images/countries.png (with
props)
portals/site/applications/src/site/resources/images/events.png (with
props)
portals/site/applications/src/site/resources/images/file.png (with props)
portals/site/applications/src/site/resources/images/flash.png (with props)
portals/site/applications/src/site/resources/images/iframe.png (with
props)
portals/site/applications/src/site/resources/images/map.png (with props)
portals/site/applications/src/site/resources/images/rss1.png (with props)
portals/site/applications/src/site/resources/images/rss2.png (with props)
portals/site/applications/src/site/resources/images/wc.png (with props)
Modified:
portals/site/applications/src/site/site.xml
portals/site/applications/src/site/xdoc/dbbrowser/index.xml
portals/site/applications/src/site/xdoc/demo/index.xml
portals/site/applications/src/site/xdoc/download.xml
portals/site/applications/src/site/xdoc/getting-started.xml
portals/site/applications/src/site/xdoc/index.xml
portals/site/applications/src/site/xdoc/portals-gems/index.xml
portals/site/applications/src/site/xdoc/rpad.xml
portals/site/applications/src/site/xdoc/rss-main/index.xml
portals/site/applications/src/site/xdoc/webcontent/index.xml
Added: portals/site/applications/src/site/resources/images/countries.png
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/countries.png?rev=779461&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site/applications/src/site/resources/images/countries.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site/applications/src/site/resources/images/events.png
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/events.png?rev=779461&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site/applications/src/site/resources/images/events.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site/applications/src/site/resources/images/file.png
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/file.png?rev=779461&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site/applications/src/site/resources/images/file.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site/applications/src/site/resources/images/flash.png
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/flash.png?rev=779461&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site/applications/src/site/resources/images/flash.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site/applications/src/site/resources/images/iframe.png
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/iframe.png?rev=779461&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site/applications/src/site/resources/images/iframe.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site/applications/src/site/resources/images/map.png
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/map.png?rev=779461&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site/applications/src/site/resources/images/map.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site/applications/src/site/resources/images/rss1.png
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/rss1.png?rev=779461&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site/applications/src/site/resources/images/rss1.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site/applications/src/site/resources/images/rss2.png
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/rss2.png?rev=779461&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site/applications/src/site/resources/images/rss2.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site/applications/src/site/resources/images/wc.png
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/resources/images/wc.png?rev=779461&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site/applications/src/site/resources/images/wc.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Modified: portals/site/applications/src/site/site.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/site.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/site.xml (original)
+++ portals/site/applications/src/site/site.xml Thu May 28 07:28:18 2009
@@ -45,6 +45,7 @@
-->
</links>
<menu name="Essentials">
+ <item name="Welcome" href="index.html"/>
<item name="Download" href="download.html" />
<item name="Getting Started" href="getting-started.html" />
<item name="Remote Deployment" href="rpad.html" />
Modified: portals/site/applications/src/site/xdoc/dbbrowser/index.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/dbbrowser/index.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/dbbrowser/index.xml (original)
+++ portals/site/applications/src/site/xdoc/dbbrowser/index.xml Thu May 28
07:28:18 2009
@@ -29,12 +29,11 @@
<h5>Get Portals Database Browser App</h5>
<p>
<a href="../download.html">
- <img valign="top"
src="images/folder-open.gif"
+ <img valign="top"
src="../images/folder-open.gif"
border="0" alt=""
title="download" />
Download
</a>
Portals Applications 2.2 Downloads
- <small>(MB)</small>
</p>
<ul>
<li>
@@ -45,7 +44,103 @@
</ul>
</div>
<p>
-A portlet application dedicated to the development and database portlet
development including scrollable lists and data entry forms
</p>
+A portlet application dedicated to the development and database portlet
development including scrollable lists and data entry forms. The 1.0 release
+contains one portlet, the Database Browser Portlet:</p>
+<source>
+<![CDATA[
+
<portlet-class>org.apache.portals.applications.dbBrowser.DatabaseBrowserPortlet</portlet-class>
+]]>
+</source>
+<p>
+The portlet is configured with several init parameters for the view. You can
just use the supplied templates:
+</p>
+<source>
+<![CDATA[
+ <init-param>
+ <name>ViewPage</name>
+ <value>/WEB-INF/view/database-view.vm</value>
+ </init-param>
+ <init-param>
+ <name>EditPage</name>
+ <value>/WEB-INF/view/database-edit.vm</value>
+ </init-param>
+ <init-param>
+ <name>HelpPage</name>
+ <value>/WEB-INF/view/database-help.vm</value>
+ </init-param>
+]]>
+</source>
+<p>
+Portlet Preferences configure the database connection:</p>
+<table>
+ <tr>
+ <th>Name</th>
+ <th>Example Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>DatasourceType</td>
+ <td>dbcp | jndi</td>
+ <td>The type of data source to connect to. Valid values are
dbcp (a pooled database connection configured locally), or a jndi data source
configured by the application server</td>
+ </tr>
+ <tr>
+ <td>JndiDatasource</td>
+ <td>jdbc/jetspeed</td>
+ <td>The name of the JNDI data source. Only valid when
DatasourceType is jndi</td>
+ </tr>
+ <tr>
+ <td>JdbcDriver</td>
+ <td>org.apache.derby.jdbc.EmbeddedDriver</td>
+ <td>The JDBC Driver qualified Java package and class name. Only
valid with DatasourceType = dbcp</td>
+ </tr>
+ <tr>
+ <td>JdbcConnection</td>
+ <td>jdbc:derby:JETSPEED-DEMO</td>
+ <td>The JDBC connection string. Only valid with DatasourceType
= dbcp</td>
+ </tr>
+ <tr>
+ <td>JdbcUsername</td>
+ <td></td>
+ <td>The JDBC database user name. Only valid with DatasourceType
= dbcp</td>
+ </tr>
+ <tr>
+ <td>JdbcPassword</td>
+ <td></td>
+ <td>The JDBC database password. Only valid with DatasourceType
= dbcp</td>
+ </tr>
+ <tr>
+ <td>WindowSize</td>
+ <td>15</td>
+ <td>The size of the browser window page</td>
+ </tr>
+ <tr>
+ <td>tableName</td>
+ <td>CITY</td>
+ <td>The name of database table to be viewed</td>
+ </tr>
+ <tr>
+ <td>conditions</td>
+ <td>where POPULATION > 500000</td>
+ <td>The WHERE clause condition when retrieving database
rows</td>
+ </tr>
+ <tr>
+ <td>columnNames</td>
+ <td>ID,NAME,COUNTRYCODE,DISTRICT,POPULATION</td>
+ <td>The columns to be selected and displayed in the list. If
none specified, all columns are selected.</td>
+ </tr>
+ <tr>
+ <td>columnTitles</td>
+ <td>ID,City,Country Code,District,Population</td>
+ <td>The titles to display for selected columns, count must
match columnNames preference</td>
+ </tr>
+ <tr>
+ <td>orderByColumns</td>
+ <td>COUNTRYCODE,DISTRICT</td>
+ <td>The columns to sort by</td>
+ </tr>
+ </table>
+ <p>Here is an example database browser from the Jetspeed 2.2 demo
distribution:</p>
+ <img src='../images/countries.png'/>
</section>
</body>
</document>
Modified: portals/site/applications/src/site/xdoc/demo/index.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/demo/index.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/demo/index.xml (original)
+++ portals/site/applications/src/site/xdoc/demo/index.xml Thu May 28 07:28:18
2009
@@ -29,12 +29,11 @@
<h5>Get Portals Demo App</h5>
<p>
<a href="../download.html">
- <img valign="top"
src="images/folder-open.gif"
+ <img valign="top"
src="../images/folder-open.gif"
border="0" alt=""
title="download" />
Download
</a>
Portals Applications 2.2 Downloads
- <small>(MB)</small>
</p>
<ul>
<li>
@@ -45,7 +44,8 @@
</ul>
</div>
<p>
-A portlet application dedicated to demonstrating different portal technologies
like <a href='http://portals.apache.org/bridges/'>Portals Bridges</a>
+A portlet application dedicated to learning Java and Groovy portlet
programming and tutorials, as well as some helpful weather and bookmark
portlets
+as well different portal technologies like <a
href='http://portals.apache.org/bridges/'>Portals Bridges</a>.
</p>
</section>
</body>
Modified: portals/site/applications/src/site/xdoc/download.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/download.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/download.xml (original)
+++ portals/site/applications/src/site/xdoc/download.xml Thu May 28 07:28:18
2009
@@ -33,8 +33,7 @@
</a>
.
</p>
- <subsection name="Apache Portals Applications
Distributions">
- <p>Coming soon...</p>
+ <subsection name="Apache Portals Applications 1.0 WAR
Distributions">
<table>
<tr>
<th>Distribution</th>
@@ -43,13 +42,122 @@
<th>Signature</th>
</tr>
<tr>
- <td></td>
- <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/jetspeed-2/binaries/jetspeed-2.1.3-installer.jar"></a></td>
- <td><a
href="http://www.apache.org/dist/portals/jetspeed-2/binaries/jetspeed-2.1.3-installer.jar.md5">here</a></td>
- <td><a
href="http://www.apache.org/dist/portals/jetspeed-2/binaries/jetspeed-2.1.3-installer.jar.asc">here</a></td>
+ <td>Database Browser 1.0 Portlet
Application</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/binaries/apa-dbbrowser-war-1.0.war"></a>apa-dbbrowser-war-1.0.war</td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/binaries/apa-dbbrowser-war-1.0.war.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/binaries/apa-dbbrowser-war-1.0.war.asc">here</a></td>
+ </tr>
+ <tr>
+ <td>Portlet Programming Demo 1.0
Portlet Application</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/binaries/apa-demo-1.0.war"></a>apa-demo-1.0.war</td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/binaries/apa-demo-1.0.war.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/binaries/apa-demo-1.0.war.asc">here</a></td>
+ </tr>
+ <tr>
+ <td>RSS 1.0 Portlet Application</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/binaries/apa-rss-war-1.0.war"></a>apa-rss-war-1.0.war</td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/binaries/apa-dbbrowser-war-1.0.war.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/binaries/apa-dbbrowser-war-1.0.war.asc">here</a></td>
+ </tr>
+ <tr>
+ <td>Web Content 1.0 Portlet
Application</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/binaries/apa-webcontent-war-1.0.war"></a>apa-webcontent-war-1.0.war</td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/binaries/apa-webcontent-war-1.0.war.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/binaries/apa-webcontent-war-1.0.war.asc">here</a></td>
</tr>
</table>
</subsection>
+ <subsection name="Apache Portals Applications 1.0
Source Distributions">
+ <table>
+ <tr>
+ <th/>
+ <th>Mirrors</th>
+ <th>Checksum</th>
+ <th>Signature</th>
+ <th>Mirrors</th>
+ <th>Checksum</th>
+ <th>Signature</th>
+ <th>Mirrors</th>
+ <th>Checksum</th>
+ <th>Signature</th>
+ </tr>
+ <tr>
+ <td>Database Browser 1.0
Portlet Application</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-dbbrowser-1.0-project.tar.bz2">apa-dbbrowser-1.0-project.tar.bz2</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-dbbrowser-1.0-project.tar.bz2.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-dbbrowser-1.0-project.tar.bz2.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-dbbrowser-1.0-project.tar.gz">apa-dbbrowser-1.0-project.tar.gz</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-dbbrowser-1.0-project.tar.gz.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-dbbrowser-1.0-project.tar.gz.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-dbbrowser-1.0-project.zip">apa-dbbrowser-1.0-project.zip</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-dbbrowser-1.0-project.zip.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-dbbrowser-1.0-project.zip.asc">here</a></td>
+ </tr>
+ <tr>
+ <td>Portlet Programming Demo
1.0 Portlet Application</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-demo-1.0-project.tar.bz2">apa-demo-1.0-project.tar.bz2</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-demo-1.0-project.tar.bz2.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-demo-1.0-project.tar.bz2.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-demo-1.0-project.tar.gz">apa-demo-1.0-project.tar.gz</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-demo-1.0-project.tar.gz.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-demo-1.0-project.tar.gz.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-demo-1.0-project.zip">apa-demo-1.0-project.zip</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-demo-1.0-project.zip.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-demo-1.0-project.zip.asc">here</a></td>
+
+ </tr>
+ <tr>
+ <td>RSS 1.0 Portlet
Application</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-rss-1.0-project.tar.bz2">apa-rss-1.0-project.tar.bz2</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-rss-1.0-project.tar.bz2.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-rss-1.0-project.tar.bz2.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-rss-1.0-project.tar.gz">apa-rss-1.0-project.tar.gz</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-rss-1.0-project.tar.gz.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-rss-1.0-project.tar.gz.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-rss-1.0-project.zip">apa-rss-1.0-project.zip</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-rss-1.0-project.zip.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-rss-1.0-project.zip.asc">here</a></td>
+ </tr>
+ <tr>
+ <td>Web Content 1.0 Portlet
Application</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-webcontent-1.0-project.tar.bz2">apa-webcontent-1.0-project.tar.bz2</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-webcontent-1.0-project.tar.bz2.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-webcontent-1.0-project.tar.bz2.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-webcontent-1.0-project.tar.gz">apa-webcontent-1.0-project.tar.gz</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-webcontent-1.0-project.tar.gz.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-webcontent-1.0-project.tar.gz.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-webcontent-1.0-project.zip">apa-webcontent-1.0-project.zip</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-webcontent-1.0-project.zip.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-webcontent-1.0-project.zip.asc">here</a></td>
+ </tr>
+ <tr>
+ <td>Gems 1.0 Portlets</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-gems-1.0-project.tar.bz2">apa-gems-1.0-project.tar.bz2</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-gems-1.0-project.tar.bz2.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-gems-1.0-project.tar.bz2.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-gems-1.0-project.tar.gz">apa-gems-1.0-project.tar.gz</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-gems-1.0-project.tar.gz.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-gems-1.0-project.tar.gz.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-gems-1.0-project.zip">apa-gems-1.0-project.zip</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-gems-1.0-project.zip.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-gems-1.0-project.zip.asc">here</a></td>
+ </tr>
+ <tr>
+ <td>APA Logging 1.0</td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-logging-1.0-project.tar.bz2">apa-logging-1.0-project.tar.bz2</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-logging-1.0-project.tar.bz2.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-logging-1.0-project.tar.bz2.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-logging-1.0-project.tar.gz">apa-logging-1.0-project.tar.gz</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-logging-1.0-project.tar.gz.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-logging-1.0-project.tar.gz.asc">here</a></td>
+ <td><a
href="http://www.apache.org/dyn/closer.cgi/portals/applications/sources/apa-logging-1.0-project.zip">apa-logging-1.0-project.zip</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-logging-1.0-project.zip.md5">here</a></td>
+ <td><a
href="http://www.apache.org/dist/portals/applications/sources/apa-logging-1.0-project.zip.asc">here</a></td>
+ </tr>
+
+ </table>
+ </subsection>
+
</section>
</body>
Modified: portals/site/applications/src/site/xdoc/getting-started.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/getting-started.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/getting-started.xml (original)
+++ portals/site/applications/src/site/xdoc/getting-started.xml Thu May 28
07:28:18 2009
@@ -28,11 +28,13 @@
<section name="Supported Portals">
<p>
Since all portlet applications housed at APA are required to be
fully-compliant to the Portlet API spec,
-the portlet applications should run on any Portlet API (1.0 or 2.0) complaint
portal.
+the portlet applications should run on any Portlet API (1.0 or 2.0) complaint
portal. To get started, simply go to the <a href='download.html'>download</a>
page and download
+the portlet application you would like to try, and deploy it to your favorite
portal. If you have a portal that uses <a href='rpad.html'>Remote Portlet
Deployment</a> you can
+also deploy portlets using a portal such as <a
href='http://portals.apache.org/jetspeed-2'>Jetspeed</a> and its Remote Portlet
Deployment feature.
</p>
</section>
<section name="Java compatibility">
- Version 1.5 or greater
+ Portlet API 2.0 and Version 1.5 or greater
</section>
</body>
</document>
Modified: portals/site/applications/src/site/xdoc/index.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/index.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/index.xml (original)
+++ portals/site/applications/src/site/xdoc/index.xml Thu May 28 07:28:18 2009
@@ -106,6 +106,16 @@
<td>application</td>
</tr>
<tr>
+<td><a href="./dbbrowser/index.html">Database Browser</a></td>
+<td>A portlet application dedicated to the development and database portlet
development including scrollable lists and data entry forms</td>
+<td>application</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>
+</tr>
+<tr>
<td><a href="./logging/index.html">Logging</a></td>
<td>Utilities used to setup and deploy logging for portlet and simple web
applications.</td>
<td>archive</td>
@@ -188,8 +198,11 @@
</subsection>
<subsection name="APA Status">
<p>
- First release coming soon....
- </p>
+ <b>27 May 2009 - Apache Portals Applications
1.0</b>
+ <p>
+ The Apache Portals team is pleased to announce the
General Availability of Portals Applications 1.0.
+ This 1.0 version introduces several new portlet
applications to the Portals community including Demo, Web Content, RSS,
Database Browser portlet applications, and the Gems portlets.
+ </p> </p>
</subsection>
</section>
</body>
Modified: portals/site/applications/src/site/xdoc/portals-gems/index.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/portals-gems/index.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/portals-gems/index.xml (original)
+++ portals/site/applications/src/site/xdoc/portals-gems/index.xml Thu May 28
07:28:18 2009
@@ -29,12 +29,11 @@
<h5>Get Portals Gems</h5>
<p>
<a href="../download.html">
- <img valign="top"
src="images/folder-open.gif"
+ <img valign="top"
src="../images/folder-open.gif"
border="0" alt=""
title="download" />
Download
</a>
Portals Applications 2.2 Downloads
- <small>(MB)</small>
</p>
<ul>
<li>
@@ -49,6 +48,244 @@
Gems is a subproject of the Apache Portals Applications project. You can
download the jar file, or download individual portlet packages containing Java
code, JSPs, and portlet.xml.
</p>
</section>
+ <section name="Gems Catalog">
+ <p>As of version 1.0, here is the collection of Gems
portlets available in our portlet catalog</p>
+ <subsection name='Browser Portlet'>
+ <table>
+ <tr>
+ <th>Portlet</th>
+ <th>Class</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>Browser Portlet</td>
+
<td>org.apache.portals.applications.gems.browser.BrowserPortlet</td>
+ <td>A generic browser portlet that displays tabular
rows of data in a table with paging controls. The <a
href='../dbbrowser/index.html'>Database Browser Portlet</a> extends this
class.</td>
+ </tr>
+ </table>
+ <p><b>Preferences</b></p>
+ <table>
+ <tr>
+ <th>Name</th>
+ <th>Example Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>WindowSize</td>
+ <td>15</td>
+ <td>The size of the browser window page</td>
+ </tr>
+ </table>
+ <p><b>Example</b></p>
+ <img src='../images/countries.png'/>
+ </subsection>
+
+ <subsection name='Address Event Portlet'>
+ <table>
+ <tr>
+ <th>Portlet</th>
+ <th>Class</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>Address Event Portlet</td>
+
<td>org.apache.portals.gems.address.AddressEventPortlet</td>
+ <td>Leverages Portlet 2.0 Event API for inter-portlet
communication. Publishes an event for an address typed in. The Google Map
portlet subscribes to Address events and displays the address on a map in a
portlet.</td>
+ </tr>
+ </table>
+ <p><b>Preferences</b></p>
+ <p>none</p>
+ <p><b>Example</b></p>
+ <img src='../images/events.png'/>
+ </subsection>
+
+ <subsection name='File Portlet'>
+ <table>
+ <tr>
+ <th>Portlet</th>
+ <th>Class</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>File Portlet</td>
+ <td> org.apache.portals.gems.file.FilePortlet</td>
+ <td>Displays the content of a file in a portlet.
Usually the file is of the HTML content type.</td>
+ </tr>
+ </table>
+ <p><b>Preferences</b></p>
+ <table>
+ <tr>
+ <th>Name</th>
+ <th>Example Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>file</td>
+ <td>/WEB-INF/view/info/welcome.html</td>
+ <td>The name of the file to display, web-app
relative or file system relative depending on useFilesystem Init Parameter, see
below</td>
+ </tr>
+ </table>
+ <p><b>Init Parameters</b></p>
+ <table>
+ <tr>
+ <th>Name</th>
+ <th>Example Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>useLanguage</td>
+ <td>true | false</td>
+ <td>boolean, should this portlet use a language
fallback algorithm to locate files, defaults to false</td>
+ </tr>
+ <tr>
+ <td>useFilesystem</td>
+ <td>true | false</td>
+ <td>boolean, should we look in the file system
or in a webapp relative path, defaults to false</td>
+ </tr>
+ <tr>
+ <td>folder</td>
+ <td></td>
+ <td>string, base location of the folder to
start searching in, applies to webapp and filesystem mounts</td>
+ </tr>
+
+ </table>
+ <p><b>Example</b></p>
+ <img src='../images/file.png'/>
+ </subsection>
+
+ <subsection name='Flash Portlet'>
+ <table>
+ <tr>
+ <th>Portlet</th>
+ <th>Class</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>Flash Portlet</td>
+ <td>org.apache.portals.gems.flash.FlashPortlet</td>
+ <td>.</td>
+ </tr>
+ </table>
+ <p><b>Preferences</b></p>
+ <table>
+ <tr>
+ <th>Name</th>
+ <th>Example Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>SRC</td>
+ <td>/demo/SWF/Clock.swf</td>
+ <td>The URL of the Flash or Flex resource file to display in
Normal Window State</td>
+ </tr>
+ <tr>
+ <td>HEIGHT</td>
+ <td>300</td>
+ <td>The height of the Flash or Flex window when in Normal
Window State</td>
+ </tr>
+ <tr>
+ <td>WIDTH</td>
+ <td>100%</td>
+ <td>The width of the Flash or Flex 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-SRC</td>
+ <td>/demo/SWF/Clock.swf</td>
+ <td>The URL of the Flash or Flex resource file to display in
Maximized Window State</td>
+ </tr>
+ <tr>
+ <td>MAX-HEIGHT</td>
+ <td>800</td>
+ <td>The height of the Flash or Flex window when in Maximized
Window State</td>
+ </tr>
+ <tr>
+ <td>MAX-WIDTH</td>
+ <td>100%</td>
+ <td>The width of the Flash or Flex window when in Maximized
Window State. Can be a percentage of available space to the portlet, or a
constant value</td>
+ </tr>
+ </table>
+ <p><b>Init Parameters</b></p>
+ <table>
+ <tr>
+ <th>Name</th>
+ <th>Example Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>object-params</td>
+ <td></td>
+ <td>use semicolon to separate each pair and equals to separate
name and value
+ for object-params (url-encoding should not be used except for
+ non-delimiter occurrences of ';' and '=' chars)</td>
+ </tr>
+ <tr>
+ <td>object-attributes</td>
+ <td></td>
+ <td>use semicolon to separate each pair and equals to separate
name and value
+ for object-attributes (url-encoding should not be used except for
+ non-delimiter occurrences of ';' and '=' chars)</td>
+ </tr>
+ <tr>
+ <td>flashvars</td>
+ <td></td>
+ <td>use semicolon to separate each pair and equals to separate
name and value
+ for flashvars (url-encoding should not be used except for non-delimiter
+ occurrences of ';' and '=' chars)</td>
+ </tr>
+ <tr>
+ <td>SwfObjectsLibUrl</td>
+ <td>/jetspeed/javascript/swfobject/swfobject.js</td>
+ <td>Change the swbobject.js url link below. This link will be
used to generate
+ html tags. The following is just an example with default deployment of
+ Jetspeed</td>
+ </tr>
+ </table>
+ <p><b>Example</b></p>
+ <img src='../images/flash.png'/>
+ </subsection>
+
+ <subsection name='Google Maps Portlet'>
+ <table>
+ <tr>
+ <th>Portlet</th>
+ <th>Class</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>Google Maps Portlet</td>
+
<td>org.apache.portals.gems.googlemaps.GoogleMapsPortlet</td>
+ <td>Displays a Google Map in a portlet. Requires a key
to be registered with Google for your website. Works fine with localhost out of
box.</td>
+ </tr>
+ </table>
+ <p><b>Preferences</b></p>
+ <table>
+ <tr>
+ <th>Name</th>
+ <th>Example Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>Location</td>
+ <td>Portland, Oregon</td>
+ <td>Any address or city in the world</td>
+ </tr>
+ <tr>
+ <td>MapHeight</td>
+ <td>400px</td>
+ <td>The size of the map area in the portlet</td>
+ </tr>
+ <tr>
+ <td>APIKey</td>
+ <td>(Your API Key from Google)</td>
+ <td>A Google Maps API Key acquired from Google.
This is a required portlet preference.</td>
+ </tr>
+
+ </table>
+ <p><b>Example</b></p>
+ <img src='../images/map.png'/>
+ </subsection>
+
+ </section>
</body>
</document>
Modified: portals/site/applications/src/site/xdoc/rpad.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/rpad.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/rpad.xml (original)
+++ portals/site/applications/src/site/xdoc/rpad.xml Thu May 28 07:28:18 2009
@@ -36,11 +36,15 @@
<th>Location</th>
</tr>
<tr>
-<td>PALab</td>
+<td>Apache Portals for Portlet API 2.0 (Jetspeed 2.2.x)</td>
+<td><a
href="http://www.bluesunrise.com/rpa/portlet-repository.xml">http://www.bluesunrise.com/rpa/portlet-repository-2.2.xml</a></td>
+</tr>
+<tr>
+<td>PALab for Portlet API 1.0 (Jetspeed 2.1.x)</td>
<td><a
href="http://pal.sourceforge.jp/portlet-repository.xml">http://pal.sourceforge.jp/portlet-repository.xml</a></td>
</tr>
<tr>
-<td>Apache Portals</td>
+<td>Apache Portals for Portlet API 1.0 (Jetspeed 2.1.x)</td>
<td><a
href="http://www.bluesunrise.com/rpa/portlet-repository.xml">http://www.bluesunrise.com/rpa/portlet-repository.xml</a></td>
</tr>
</table>
Modified: portals/site/applications/src/site/xdoc/rss-main/index.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/rss-main/index.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/rss-main/index.xml (original)
+++ portals/site/applications/src/site/xdoc/rss-main/index.xml Thu May 28
07:28:18 2009
@@ -34,7 +34,6 @@
Download
</a>
Portals Applications 2.2 Downloads
- <small>(MB)</small>
</p>
<ul>
<li>
@@ -45,8 +44,117 @@
</ul>
</div>
<p>
-A portlet application dedicated to RSS-based portlet development.
+A portlet application dedicated to RSS-based portlet development. RSS (most
commonly translated as "Really Simple Syndication")
+ is a family of web feed formats used to publish frequently updated
worksâsuch as blog entries, news headlines, audio, and videoâin a
standardized format
</p>
+ <p>The RSS portet application consists of two portlets
that both have the same functionality. The first RSS portlet is implemented
using XSLT, the second
+ RSS portlet is configured with <a
href='https://rome.dev.java.net/'>Rome RSS</a>, a programmatic API for
displaying RSS. Here are the portlet classes
+ that need to be declared in your portlet.xml:
+ </p>
+<source>
+<![CDATA[
+
<portlet-class>org.apache.portals.applications.rss.RSSPortlet</portlet-class>
+]]>
+</source>
+<p>or</p>
+<source>
+<![CDATA[
+
<portlet-class>org.apache.portals.applications.rss.RomeRSSPortlet</portlet-class>
+]]>
+</source>
+<subsection name='Init Parameters'>
+<p>The XSLT RSS portlet requires the following init parameters. Notice that
the portlet supports different templates per media type. A velocity template is
+actually used for Edit Mode. This template can generically display any set of
preferences in a table entry form</p>
+<source>
+<![CDATA[
+ <init-param>
+ <name>EditPage</name>
+ <value>/WEB-INF/view/edit-prefs.vm</value>
+ </init-param>
+ <init-param>
+ <description>Default RSS Transform XSLT</description>
+ <name>stylesheet</name>
+ <value>/WEB-INF/xsl/rss.xsl</value>
+ </init-param>
+ <init-param>
+ <description>HTML RSS Transform XSLT</description>
+ <name>stylesheet.text/html</name>
+ <value>/WEB-INF/xsl/rss.xsl</value>
+ </init-param>
+ <init-param>
+ <description>WML RSS Transform XSLT</description>
+ <name>stylesheet.text/vnd.wap.wml</name>
+ <value>/WEB-INF/xsl/rss-wml.xsl</value>
+ </init-param>
+]]>
+</source>
+<p>The Rome RSS portlet requires the following init parameters. A velocity
template is
+actually used for View and Edit Mode. This template can generically display
any set of preferences in a table entry form</p>
+<source>
+<![CDATA[
+ <init-param>
+ <name>AllowPreferences</name>
+ <value>true</value>
+ </init-param>
+ <init-param>
+ <name>ViewPage</name>
+ <value>/WEB-INF/view/view.vm</value>
+ </init-param>
+ <init-param>
+ <name>HelpPage</name>
+ <value>/WEB-INF/view/rss-help.html</value>
+ </init-param>
+ <init-param>
+ <name>EditPage</name>
+ <value>/WEB-INF/view/edit-prefs.vm</value>
+ </init-param>
+]]>
+</source>
+</subsection>
+<subsection name='Preferences'>
+<p>Both portlets use the same preferences to configure the RSS connection and
display preferences</p>
+<table>
+ <tr>
+ <th>Name</th>
+ <th>Example Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>url</td>
+ <td>http://www.npr.org/rss/rss.php?topicId=2</td>
+ <td>The URL location of the RSS feed providing the RSS content
to be transformed into portal acceptable format</td>
+ </tr>
+ <tr>
+ <td>itemdisplayed</td>
+ <td>15</td>
+ <td>Number of items to display in the portlet view mode
window</td>
+ </tr>
+ <tr>
+ <td>openinpopup</td>
+ <td>true | false</td>
+ <td>Indicate whether you want the details view of the RSS feed
selected to open in a popup window or the same window</td>
+ </tr>
+ <tr>
+ <td>showdescription</td>
+ <td>true | false</td>
+ <td>Indicate whether you want to display descriptions of the
RSS feed in the summary area for each detail line</td>
+ </tr>
+ <tr>
+ <td>showtitle</td>
+ <td>true | false</td>
+ <td>Indicate whether you want to display titles of the RSS feed
in the summary area for each detail line</td>
+ </tr>
+ <tr>
+ <td>showtextinput</td>
+ <td>true | false</td>
+ <td>Indicate whether you want to display text inputs of the RSS
feed in the summary area for each detail line</td>
+ </tr>
+ </table>
+ </subsection>
+ <p>
+ Here are two examples of RSS Portlets:</p>
+ <img src='../images/rss1.png'/>
+ <img src='../images/rss2.png'/>
</section>
</body>
</document>
Modified: portals/site/applications/src/site/xdoc/webcontent/index.xml
URL:
http://svn.apache.org/viewvc/portals/site/applications/src/site/xdoc/webcontent/index.xml?rev=779461&r1=779460&r2=779461&view=diff
==============================================================================
--- portals/site/applications/src/site/xdoc/webcontent/index.xml (original)
+++ portals/site/applications/src/site/xdoc/webcontent/index.xml Thu May 28
07:28:18 2009
@@ -29,12 +29,11 @@
<h5>Get Portals Web Content App</h5>
<p>
<a href="../download.html">
- <img valign="top"
src="images/folder-open.gif"
+ <img valign="top"
src="../images/folder-open.gif"
border="0" alt=""
title="download" />
Download
</a>
Portals Applications 2.2 Downloads
- <small>(MB)</small>
</p>
<ul>
<li>
@@ -45,8 +44,93 @@
</ul>
</div>
<p>
-A portlet application dedicated to the development of Web Content rewriting
and IFrame based web content.
+A portlet application dedicated to the development of Web Content rewriting
and IFrame based web content. The portlet applications here are designed to
host content
+from another web site or local servlet inside of a portlet window.
</p>
+<p>The Web Content portet application consists of two portlets that have
similiar functionality, but different approaches:
+<ul>
+<li>IFrame Portlet</li>
+<li>Web Content Portlet</li>
+</ul>
+ Both portlets host content from a different website or local servlet inside a
portlet window. The IFrame Portet achieves this by embedding an HTML <a
href='http://www.w3schools.com/TAGS/tag_iframe.asp'>iframe</a> within a
portlet.
+ 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 second 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 both the IFrame and WebContent portlets found at
the <a
href='http://portals.apache.org/jetspeed-2/applications/j2-admin.html'>Jetspeed
J2-Admin</a> website.
+ The SSOIFrame 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>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>
+</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://www.apache.org</td>
+ <td>The URL of the remote or local site to be hosted.</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>
+
+
+ <p>Here are examples of the Web Content and IFrame Portlets:</p>
+ <img src='../images/wc.png'/>
+ <img src='../images/iframe.png'/>
+
</section>
</body>
</document>