RSS
Class Name : org.apache.jetspeed.portal.portlets.NewRSSPortlet

Present a RSS new feed in a portlet.

Rich Site Summary (RSS) is an XML-based format developed by Netscape to drive channels for Netscape Netcenter. The goal of RSS is to propagate change on a site, including your Jetspeed site, to increase traffic. Using an RSS file, all you need to do is change one file, and all the external sites your channels are registered with will automatically reflect those changes.

The formatting of the RSS into a portlet is controlled by the stylesheet. If formatting changes are desired, create a new stylesheet and do not edit the one distributed with Jetspeed. This will insure your changes are preserved across updates.

General information on RSS can be found in the Open Directory.

RSS format information can be found in the http://my.netscape.com/publish/formats/rss-spec-0.91.html.

Supported Media Types

Description of Media Types. html wml

Portlet title and description. By default the title is the name of the portlet and their is no description.

This element is optional, but it's use is suggested.

General information about of meta-info.

Parameter that control the how the web page is converted into a portlet.

These elements are optional.

Parameters common to many portlets.

Parameter Name	Description
itemdisplayed	The number of items from the RSS file to display on screen. If not present, Default 15 for HTML, 5 for WML
openinpopup	Should links be opened in a new browser window? This parameter was added in version 1.3a3. If not present, Default: false Value Description true Links will be opened in a new browser window false Links will be opened in the current browser window
showdescription	Should the portlet show the item descriptions and icons? If not present, Default: true for HTML, false for WML Value Description true Item Description is displayed false Item Description is NOT displayed
showtitle	Should the portlet show the channel description and icon. If not present, Default: true for HTML, false for WML Value Description true Channel Description is displayed false Channel Description is NOT displayed
showtextinput	Should the portlet show the text input. If not present, Default: true for HTML, false for WML Value Description true Text Input is displayed, when present. false Text Input is NOT displayed
stylesheet[.<mime type>]	The stylesheet URL. If a mime-type is specified, the stylesheet is only used for this mime-type File name, including path relative to <jetspeed_home>

Contains the URL of the RSS news feed. The returned page should be a RSS formatted XML file.

This element is required.

General information about of URL.

Good URLs:

<url>http://jakata.apache.org/jetspeed</url>

Basic URL

<url>http://search.yahoo.com/bin/search?p=jetspeed</url>

1 Parameter passed

<url>http://search.yahoo.com/search?p=jetspeed&amp;n=100</url>

2 Parameter passed

Bad URLs:

<url>index.html</url>

No protocol, http:// or hostname

<url>http://search.yahoo.com/search?p=jetspeed&n=100</url>

Contains & instead of &amp;.

	<portlet-entry name="Apacheweek" hidden="false" type="ref" parent="RSS" application="false"> <meta-info> <title>Apacheweek</title> </meta-info> <url>http://www.apacheweek.com/issues/apacheweek-headlines.xml</url> </portlet-entry>

• <textinput> not correctly implemented. Fixed in 1.3a2