collective.syndication 1.0b3

Improved syndication for Plone sites providing Atom, iTunes, NewsML 1, RSS 1.0 and RSS 2.0 feeds.

Table of Contents

• Life, the Universe, and Everything

• Mostly Harmless

• Don’t Panic

  • Installation

  • Feeds

    • Atom

    • iTunes

    • NewsML 1

    • RSS 1.0 (RDF Site Summary)

    • RSS 2.0

• Share and Enjoy

• There’s a frood who really knows where his towel is

  • 1.0b3 (2014-02-04)

  • 1.0b2 (2014-01-23)

  • 1.0b1 (2013-09-03)

  • 1.0a4 (2013-03-27)

  • 1.0a3 (2013-03-21)

  • 1.0a2 (2013-01-15)

  • 1.0a1 (2013-01-10)

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.

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.

Note

You may have to empty your browser cache and save your resource registries in order to see the effects of the product installation.

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.

Share and Enjoy

collective.syndication would not have been possible without the contribution of the following people:

• Nathan Van Gheem

• Gonzalo Almeida

• Franco Pellegrini

• Héctor Velarde

• Juan Pablo Giménez

You can find an updated list of package contributors on GitHub.

Development sponsored by Open Multimedia.

There’s a frood who really knows where his towel is

1.0b3 (2014-02-04)

• Fix a problem with ViewPageTemplateFile overriding the Content-Type header, now we set the header after rendering the body, this way third party products can’t break the feeds Content-Type. [jpgimenez]

1.0b2 (2014-01-23)

• Obey limit parameter on feeds (fixes #17). [jpgimenez]

• Fix a typo in URLs pointing to files (closes #19). [jpgimenez]

• Implement rendering of body in Atom feeds (closes #18). [jpgimenez]

• Change ‘Render Body’ future to render the content-core macro, not just the body field. [jpgimenez]

1.0b1 (2013-09-03)

• Replace beautifulsoup4 with lxml. [jpgimenez]

• Fix a bug with body text coming from dexterity content. [jpgimenez]

1.0a4 (2013-03-27)

• (Bugfix) Return proper headers with the feeds. [frapell]

1.0a3 (2013-03-21)

• Don’t use an interface as filtering mechanism to get NewsML items. [frapell]

1.0a2 (2013-01-15)

• Implement NewsML 1 syndication. [frapell]

1.0a1 (2013-01-10)

• Initial release.