Overview

The feeds plugin allows users to subscribe to and receive notifications from RSS and Atom feeds via a Openfire component using any IM client. The plugin can receive update notifications from services that support the XML-RPC ping notification system and supports REST based web services for managing users subscriptions to feeds.

Installation

Copy the instantFeeds.jar into the plugins directory of your Openfire installation. The plugin will then be automatically deployed. To upgrade to a new version, copy the new instantFeeds.jar file over the existing file.

Configuration

The following properties can be set to customize the instantFeeds installation:

Working With Firewalls

Because the instantFeeds plugin runs within the Openfire admin console web container, users behind firewalls may have problems accessing the HTTP services it provides. For example, if the Openfire admin console runs on the default port of 9090 and a user is only allowed to receive HTTP traffic on port 80, then a web request like the following won't work:

One solution for Apache users is to use mod_rewrite, mod_proxy and mod_proxy_http to serve traffic for the plugin on port 80. Sample Apache configuration entries for performing this mapping are below. Essentially, we make Apache intercept all requests for the presence plugin on port 80 and then proxy a real connection to the HTTP server on port 9090.

1
2
3
4
5
6
7
8
9
      <virtualhost *:80>
      servername example.com
      ....
      ProxyVia On
      RewriteEngine On
      RewriteCond %{REQUEST_URI} ^/api/
      RewriteRule ^/(.*) http://example.com:9090/plugins/instantFeeds/$1 [P]
      </virtualhost>

Using the plugin

The plugin can be accesed by end users by sending instant messages to 'feeds.$yourserver$' or 'feeds@$yourserver$' where $yourserver$ is the Server Name of your Openfire installation. The component supports the following commands: