The RSS Publisher Widget

The RSS Publisher widget displays RSS feeds. If you’re looking for a web-based RSS reader, look no further: just add the RSS Publisher widget to one your personal Site’s private pages, and voila! You have your own personal RSS reader. You can select the RSS feeds the widget displays and how it displays them. The RSS Publisher widget can also be placed on Sites’ public or private pages to make feeds available to guests or Site members, respectively. In these cases, make sure that only Site administrators have permission to customize the RSS widget and select feeds to be displayed.

Figure 1: The RSS Publisher widget lets you display RSS feeds of your choosing.

Figure 1: The RSS Publisher widget lets you display RSS feeds of your choosing.

Note that the RSS Publisher widget is deprecated. In Liferay CE Portal 7.1 GA2+, and Liferay DXP 7.1 FP4+, the widget is available from the Add (Add) → WidgetsNews menu. However, the widget is hidden in earlier releases of Liferay CE Portal 7.1 and Liferay DXP 7.1. In these releases, you must therefore make the widget visible via a configuration file. The next section shows you how to do this.

Ensuring that the RSS Publisher Widget is Visible

The RSS Publisher widget is hidden in Liferay CE Portal 7.1 GA1 and versions of Liferay DXP 7.1 prior to Fix Pack 4. If you’re running one of these versions, follow these steps to ensure that the widget is visible:

  1. Shut down your portal instance, if it’s running.

  2. In [Liferay Home]/osgi/configs, create the file com.liferay.rss.web.internal.configuration.RSSWebCacheConfiguration.config. Note that the Liferay Home folder is usually the application server’s parent folder.

  3. Add the following configuration to the file you created in the first step:

    com.liferay.portlet.display-category="category.news"
    
  4. Start Liferay DXP.

The RSS Publisher widget is now available in the Add (Add) → WidgetsNews menu.

Using the RSS Publisher Widget

You can add the RSS Publisher widget to a page from the Add (Add) → WidgetsNews menu. Once you’ve done so, open the widget’s Configuration menu by clicking on the Options icon (Options) at the top-right corner of the widget and selecting Configuration.

Figure 2: The RSS Publisher widgets configuration lets you customize how the widget displays RSS feeds.

Figure 2: The RSS Publisher widget's configuration lets you customize how the widget displays RSS feeds.

Figure 3: You can also use the RSS Publisher widgets configuration to specify which feeds to display.

Figure 3: You can also use the RSS Publisher widget's configuration to specify which feeds to display.

By default, the RSS Publisher widget displays one feed. In the Feeds section, add or remove a feed via the plus or minus buttons, respectively. To add a feed, enter its URL and title in the respective fields. If you leave the Title field blank, the feed’s default title is used (the Title field is for custom titles).

In the top section, use the following toggles to enable/disable the display of the feed’s details:

  • Show Feed Title
  • Show Feed Published Date
  • Show Feed Description
  • Show Feed Image
  • Show Feed Item Author

You can also select the number of entries and expanded entries that should be displayed per feed. Expanded entries show more of an article’s actual content than regular entries. By default, each feed shows four entries per feed and eight expanded entries per feed. You can set the feed image alignment to control whether feed images appear to the right or left of the text. By default, the feed image alignment is set to Right.

« Configuring RSS FeedsConfiguring Widgets »
この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています