Displaying external feeds in Quickr services for Domino 8.2
This article shows you how to display external un-authenticated feeds in a Quickr place in 3 easy steps. Authenticated feeds based on MSSO in a configuration will work as well - but will require a small bit of work in the attachments provided.
Requires - Quickr services for Domino 8.2
Prior to Quickr 8.2
Displaying external feeds has always been possible in Quickr services for Domino. But, it required either writing an agent or a servlet - that would run on the server to workaround the cross-domain limitations (security) of the browsers - in a nut shell, a browser serving up a page from http://somedomain/xyz
can only make XHR requests to the same domain - in this case 'somedomain'. To get around this, a proxy needs to be placed on the server in 'somedomain' which can field the request for the feed and deliver that to the client.
End-result we want to achieve
The goal here is to be able to provide end-users with a form where they can input a feed url, a title and the number of entries to display - and the form when visited in 'read' mode will display the feed that was requested.
CNN Top stories feed - displayed on a page in a Quickr place (figure 1).
Quickr Wiki feed - displayed in a Quickr place (figure 2)
If you already have Quickr Domino 8.2 installed, we will be using the xsp proxy to address the need of the cross-domain requirement I alluded to above. For the purposes of this article (un-authenticated external feeds) we are going to define the following in the proxy-config.properties file, located in /properties directory.
The number after policy
. The number after the policy increases with each policy being defined, hence, you should scan the properties file and add the next number after the one that is already active in that file. Also note that we do not
want to send cookies to external sites.
Test the change:
To test the change, simply save the file you modified above and restart the server. Then issue the following url in a browser - http:yourserver.com/xsp/proxy/BasicProxy/httrss.cnn.com/rss/cnn_topstories.rss
the result in Firefox should be the feed from the CNN top stories being displayed.
Assuming the above test worked. Go to a place and import the attached FeedPage.html using IE into a Quickr place as a imported html form.
Launch IE, visit a place as a manager, go to Customize, Forms, and select Imported HTML form, give the form a title and select the FeedPage.html file to upload as the form.
While you can now start using the new form (via 'New page or folder...') and publish it anywhere, I find it best to create a headline
folder and put these feed pages on that type of folder (this of course is NOT necessary, just a suggestion).
When you click on New page or folder...' and pick the Feed form ( or the titl e you provided), you should see the following:
The image above shows a twitter feed on the word quickr
, but you can enter any feed url you want (external and un-authenticated only). Publish the page and what you should see your feed - similar for figure 1 or 2.
The code is provided as-is
! If you have problems getting the code running please leave comments and I hope the community (along with myself) can assist.
Thanks also goes to Xavier Defossez @ IBM
, for getting the base of this started via an agent for Quickr services for Domino 8.0!