collective.syndication

Table of Contents

• Life, the Universe, and Everything
• Mostly Harmless
  • Known Issues
• Don't Panic
  • Installation
  • Feeds
    • Atom
    • iTunes
    • NewsML 1
    • RSS 1.0 (RDF Site Summary)
    • RSS 2.0
  • Migrating to Plone 4.3

Life, the Universe, and Everything

collective.syndication improves standard syndication on Plone sites by providing 5 feed types: Atom, iTunes, NewsML 1, RSS 1.0 and RSS 2.0.

This package is a backport for Plone 4.1 and 4.2 of Nathan Van Gheem's Improved Syndication PLIP implementation made for Plone 4.3.

Mostly Harmless

Got an idea? Found a bug? Let us know by opening a support ticket.

Known Issues

If you migrated your site from Plone 4.2 to Plone 4.3, odds are you are facing the following error:

PicklingError: Can't pickle <class 'collective.syndication.interfaces.ISyndicatable'>: import of module collective.syndication.interfaces failed

To fix this, you should add the following code to your policy package:

# BBB: avoid PicklingError in Plone 4.3
import sys
from Products.CMFPlone.interfaces import syndication
sys.modules['collective.syndication.interfaces'] = sys.modules[syndication.__name__]

Don't Panic

Installation

To enable this product in a buildout-based installation:

1. Edit your buildout.cfg and add collective.syndication to the list of eggs to install:

[buildout]
...
eggs =
    collective.syndication

After updating the configuration you need to run ''bin/buildout'', which will take care of updating your system.

Go to the 'Site Setup' page in a Plone site and click on the 'Add-ons' link.

Check the box next to collective.syndication and click the 'Activate' button.

Feeds

Atom

Atom is an XML-based document format that describes lists of related information known as "feeds". Feeds are composed of a number of items, known as "entries", each with an extensible set of attached metadata. For example, each entry has a title.

The primary use case that Atom addresses is the syndication of Web content such as weblogs and news headlines to Web sites as well as directly to user agents.

Atom feeds have multiple advantages over RSS feeds.

iTunes

TBD.

NewsML 1

NewsML 1 is an XML standard designed to provide a media-independent, structural framework for multi-media news.

In this package, we implement part of the standard, to be usable by MSN. There's no online reference on how MSN expects data, just a PDF included in the docs folder of this package.

RSS 1.0 (RDF Site Summary)

RDF Site Summary is a lightweight multipurpose extensible metadata description and syndication format. RSS is an XML application, conforms to the W3C's RDF Specification and is extensible via XML-namespace and/or RDF based modularization.

RSS 2.0

TBD.

Migrating to Plone 4.3

Before migrating a site to Plone 4.3 you should uninstall and remove this package from your buildout configuration.