Plonelicious

Plonelicious is a Plone tool that integrates del.icio.us social bookmarks functionality into your Plone site.

Project Description

Plonelicious

Plonelicious is a Plone tool that integrates del.icio.us social bookmarks functionality into your Plone site with the following three features:

• A del.ico.us logo action icon on your content to facilitate tagging the pages on your site for users of del.ico.us
• Generation of linked del.icio.us tags based on the Plone "keywords" you assign to your content.
• An optional del.icio.us portlet that will randomly select a keyword related to the current page and retrieve a del.icio.us RSS feed using that keyword as the tag. IMPORTANT: This feature is disabled by default. Querying a single del.icio.us RSS feed more than once per 30 minutes is considered an abuse of the system (see http://del.icio.us/doc/about). Do not use it unless you have an appropriate caching scheme in place. For information about caching and Plone, see the following tutorial or my own treatment" of the subject.

A configlet is provided a few configuration options.

Requirements

• Plone 2.1 or 2.0. (2.1 recommended)

Installation

Unpack the package into your Zope instance's Products folder and restart your Zope instance. Go to "Add/Remove Products" in Site Setup, select Plonelicious, and install it.

To use the del.icio.us portlet feature, in the root properties of your Plone object, add the following line to either left_slots or right_slots depending on where you want it to appear: here/portlet_plonelicious/macros/portletImportant: Do not use this feature unless you have an appropriate caching scheme in place. (See above.)

Plone 2.0 users can use it by changing the name of the file document_byline_PLONE2_0COMPAT.pt to document_byline.pt.

Usage

Plonelicious is mostly self-explanatory for users of del.icio.us. Details about configuration options can be found in the add-on product configuration "configlet".

Technical Details

While a plonelicious_tool product is created as an action provider, properties are actually stored in the portal_properties tool.

The package uses the same rssparser.py file used by CMFSin, unmodified.

The ZPT that generates the tag list is located in document_relateditems.pt, which overrides the stock CMFPlone template of the same name when the the Plonelicous skin is installed. If you already have a heavily customized skin that interferes with this, you may simply extract the relevant ZPT code from lines 5-25 of this file and put it in some other template.

Copyright/License

GPL. The package should contain a text file called LICENSE explaining the terms.

Credits

Developed by Matt Dorn (matt_dorn AT yahoo DOT com)

Thanks to Shane Graber (http://liquid.homelinux.org/) for the action icon idea.

Thanks to Mark Pilgrim for the original RSS Parser, and to Ben Saller for the "hacked-up version" lifted from CMFSin and used here.

History

1. Oct 2005 - v0.1.0: Initial release