Package README (CVS ver. 1.6)

CMFSin Overview

 This is a simple syndication client for CMF. It uses rssparser and
shares many things in common with CMFNewsFeed but has a different
model for handling channels. It is designed to map _n_ channels or
feeds to sets of composite virtual channels which can then be called
in in a timely fashion. Most of the remaining work has to happen in UI
land.

 <b>Step-by-step instructions</b>

 1. Install either using the CMFQuickInstaller or using an external
    method.

    Using CMFQuickInstaller:

    In the ZMI, add a CMFQuickInstaller Tool to your CMF/Plone Site.
    Click on portal_quickinstaller.  Check CMFSin and click "Install".

    Using External Method:

    Add an External Method to your CMF/Plone site and specify the
    following:

      ID: install_cmfsin

      Module Name: CMFSin.Install

      Function Name: install

    Click "Test" to install CMFSin.

 2. In the ZMI, go to the new sin_tool object of your CMF/Plone site.
    Add RSS or RDF channels to the "channels" section:

      syntax: <channelname>=<url>

      ex: freshmeat=http://freshmeat.net/backend/fm-releases-software.rdf

 3. Add syndication mappings to the "map" section.

      syntax: <mapname>=<channelname> [,<channelname>]*

      ex: geek=freshmeat,slashdot

 4. Click "Set Config".

 5. Finally, go to the Properties tab of your CMF/Plone site then
    add the mappings you defined to your left_slots or right_slots.

      syntax: here/sin_tool/macros/<mapname>

      ex: here/sin_tool/macros/geeknews

Credits:

 * Ben <bcsaller@yahoo.com>

 * Thanks to Mark Pilgrim for the rssparser that I use (a hacked up version of)

 * Andy McKay, Richard Amerman and Jon Lim and Sprint Victoria for 0.6

 * Sidnei da Silva (dreamcatcher) for house cleaning and beer drinking.