Nucleus RSS/Atom Reader 0.10
Thursday, 28 October 2004
My second Nucleus plugin, a complete RSS/Atom parser that reads the headlines from the feeds you want to feature on your blog. It can handle RSS0.9, RSS1.0, RSS2.0 and Atom feeds, even when combined with RDF and complex namespaces.
It outputs the contents of the feed as regular list containing links. It is, of course, possible to completely customize it and style it using CSS. There are also options to show a header, either from the feed itself, or one that you provided yourself and to set a maximum number of entries that should be shown. As of version 0.9.4 it is also possible to cut the title off after a preset number of characters and to start displaying items after an offset. For example, it is possible to show only 5 items, starting with item number 10.
The feeds that are parsed are cached, to ensure the website providing the feed isn’t sending unnecessary data evertime somebody visits your site. It is also possible to change the maximum age of a cached feed. In addition to this, RSS/Atom Reader 0.9.5 now also provides support for ETag headers, which will lead to a reduction in bandwidth usage when the cache is expired, but the feed does not contain any new items.
How to install it
Download the file
XMLPlugins.zip, extract the files and place them into the plugins folder of your nucleus installation. Go to the management console and the plugin section. First of all, install
XMLSupport and finally install
The two plugins should appear in the list of currently installed plugins. In this list you can also edit the options of these plugin.
To actually use the plugin you must edit the skin of your blog. Simply include, in a convenient place the skin var
<%RSSAtom(feedurl)%>. Nucleus will then replace this with the contents of the feed.
Optional other parameters are:
The startat parameter is used to specify at which item the box will start to display entries. For example, if it is set to 0 it will start at the top, if it is set at 10 it will skip the first 10 items. The items parameter must be a number and it will determine the maximum number of items that are shown for this particular feed. The title parameter can contain any string and will be used as the title of this particular feed, if no one is provided in the feed. The usetitle parameter must be either yes or no and will determine if the supplied title will always be used, even if one is provided in the feed.