Metadata-Version: 1.0
Name: collective.discussionplus
Version: 1.0b2
Summary: Augments the standard Plone discussion tool to add basic approvals workflow, and ibetter indexing of comment metadata (number of comments, who has commented?)
Home-page: http://pypi.python.org/pypi/collective.discussionplus
Author: Martin Aspeli
Author-email: optilude@gmail.com
License: GPL
Description: Introduction
        ============
        
        This package provides some enhancements to Plone's standard commenting
        functionality. It attempts to keep as much of the existing commenting
        machinery as possible, but adds the following features:
        
        Events:
        
        * An `IObjectAddedEvent` is fired when a discussion item (described by the
        interface `Products.CMFCore.interfaces.IDiscussionResponse`) is created.
        * Similarly, an `IObjectRemovedEvent` is fired when a discussion item is
        deleted.
        
        Indexing:
        
        * Content items gain two additional catalogue indexes: `number_of_comments`,
        which contains the number of comments left on a content item, and
        `commentators`, which contains a list of unique usernames of those who
        have left one or more comments on the content item. `number_of_comments`
        is also available as catalogue metadata.
        * Collections are configured so that it is possible to search by these
        indexes. For example, the 'Current author' criterion can be used to list
        all content items upon which the current user has left a comment.
        * Discussion items gain an additional catalogue metadata column,
        `comment_subject`, which contains the title of the content item that was
        commented upon (note that this is not updated if the content item changes
        title).
        
        Workflow:
        
        * Discussion items will respect the workflow set in portal_workflow. By
        default, the `one_state_workflow` is used, which means a comment is
        always published. An additional `comment_review_workflow` is installed,
        which has two states: `pending` and `published`. Comments may either be
        published or deleted.
        * A new view, @@review-comments, is available for any folder or the portal
        root. This allows site-wide (or folder-wide) moderation of comments, with
        quick publish/delete operations.
        
        Note that the @@review-comments view makes a few assumptions:
        
        * Comments pending review are always in the `pending` state. You can add
        a `review_state` request parameter to specify a different state to search
        for, however.
        * There is a transition called `publish` to move a comment from `pending` to
        `published`. You can request a different transition by providing a
        request parameter `publish_transition`.
        
        Furthermore:
        
        * The `number_of_comments` index will only include comments in the
        `published` state.
        * Neither the `portal_catalog` `Clear and rebuild`, nor the
        `portal_workflow` `Update security settings` operation will correctly
        find and update comments, due to the way that comments are stored.
        
        Requirements
        ============
        
        This product requires Plone 3.3+ (and will likely not work with Plone 4). In
        particular, it relies on `plone.indexer`, which is part of Plone 3.3+.
        
        
        Changelog
        =========
        
        1.0b2 - 2009-04-17
        ------------------
        
        * Catch up to Plone 3.3
        
        
        
Keywords: plone discussion commenting
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
