plone.app.discussion 1.0b6

Enhanced discussion support for Plone

Introduction

plone.app.discussion aims to be the new commenting system for Plone. It was initially developed as part of the Google Summer of Code 2009 by Timo Stollenwerk (student) and Martin Aspeli (mentor).

For the roadmap of the project see our Pivotal Tracker.

Please report bugs to the Plone bug tracker.

Requirements

Plone 3.3 or later.

Plone 3.x Buildout Installation

To install plone.app.discussion, add the following code to your buildout.cfg:

[buildout]
...
extends =
    ...
    http://good-py.appspot.com/release/plone.app.discussion/1.0b6

...

[instance]
...
eggs =
    ...
    plone.app.discussion

...

Plone 4.x Buildout Installation

To install plone.app.discussion, add the following code to your buildout.cfg:

[buildout]

...

versions = versions

[versions]
zope.schema = 3.6.0

...

[instance]
...
eggs =
    ...
    plone.app.discussion

...

Add-on Products

• collective.autoresizetextarea (for auto-resizing the comment textarea while typing)

• plone.formwidget.captcha (for Captcha spam protection)

• plone.formwidget.recaptcha (for ReCaptcha spam protection)

• collective.akismet (for Akismet spam protection)

Documentation

• For developer documentation see http://packages.python.org/plone.app.discussion.

• For integrator/end-user documentation see http://plone.org/products/plone.app.discussion/documentation.

Credits

• Timo Stollenwerk

• Martin Aspeli

Many thanks to:

• Jon Stahl (for acting as “the customer” during GSoC)

• David Glick (for technical expertise and advice during GSoC)

• Lennart Regebro (for writing the portal_discussion tool and initial unit tests)

• Carsten Senger (for fixing the comment z3c.form form and pizza)

• Hanno Schlichting (for making p.a.d work with Zope 2.12)

• Alan Hoey (for providing fixes)

• Maik Roeder (for providing and setting up a buildbot)

Changelog

1.0b6 (2010-08-24)

• Fixed the case where a folder has allow_discussion=False and conversation.enabled() on a document in this folder returned False instead of True because of allow_discussion acquisition. [vincentfretin]

• Redirect to the comment form action instead of the absolute URL when a comment is posted. This fixes the accidentally triggered file upload when a comment is posted on a file content object. [timo]

• We need five:registerPackage to register the i18n folder. [vincentfretin]

• Added Traditional Chinese (zh_TW) translation. [TsungWei Hu]

• Added French translation. [vincentfretin]

• Renamed legend_add_comment to label_add_comment to have the translation from plone domain. [vincentfretin]

• label_comment_by and label_commented_at are not in Plone 4 translation anymore, so these two messages moved to plone.app.discussions i18n domain. [vincentfretin]

• Translate “Warning” shown in @@moderate-comments in the plone domain. [vincentfretin]

• Fixed i18n markup of message_moderation_disabled. [vincentfretin]

• Catch Type errors in indexers if object can not be adapted to IDiscussion [do3cc]

• Call the CaptchaValidator even when no captcha data was submitted. This is necessary to ensure that the collective.akismet validator is called when installed. [timo]

• Spanish translation added. Thanks to Judith Sanleandro. [timo]

1.0b5 (2010-07-16)

• Use self.form instead of CommentForm for the CommentsViewlet update method so integrators don’t have to override the viewlet’s update method. [matous]

• Make sure the form fields in the reply form are always placed under the field labels. [timo]

• Fix CSS overflow bug that occurs with the new Plone 4.0b5 comment styles. [timo]

• Unnecessary imports and variables removed. [timo]

• Added norwegian translation. [ggozad]

• Protect against missing canonical in conversationCanonicalAdapterFactory. [hannosch]

• Documentation for Captcha plugin architecture and email notification added. See http://packages.python.org/plone.app.discussion. [timo]

• Use sphinx.plonetheme for plone.app.discussion documentation. [timo]

• Avoid deprecation warning for the Globals package. [hannosch]

• Remove the hard coded check for title and text when the comment form is submitted. This allows integrators to write schema extenders that remove the title from the comment form. [timo]

• Move captcha registration to its own captcha.zcml file. [timo]

• Akismet (http://akismet.com/) spam protection plugin (collective.akismet) support added. [timo]

• Simplify the CaptchaValidator class by dynamically adapting a view with the name of the captcha plugin (e.g. recaptcha, captcha, akismet) for the validator. [timo]

• Dutch translation added. [kcleong]

• Enable caching and merging for comments.js to save some requests. [pelle]

• Design notes for the Captcha plugin architecture added. [timo]

• Make IDiscussionLayer inherit from Interface again. Remove IDefaultPloneLayer, since Plone 4.0b1 and plone.theme 2.0b1 are out now. [timo]

• Clean up Javascript code. [timo]

• Fix encoding error in migration procedure, otherwise migration procedure breaks on joining output list in case we have there any non-ascii characters. [piv]

• plone.z3cform 0.6.0 compatibility (fix maximum recursion depth error which appears with plone.z3cform higher than 0.5.10). [piv]

• Removed moderation.js from js registry and include it only in moderation.pt as that is the only place where it is used. [ggozad]

1.0b4 (2010-04-04)

• New feature: As a moderator, I am notified when new comments require my attention. [timo]

• Sphinx-based developer documentation added. See http://packages.python.org/plone.app.discussion. [timo]

• Rename “Single State Workflow” to “Comment Single State Workflow”. [timo]

• Rename ‘publish comment’ to ‘approve comment’. This fixes #1608470. [timo]

• Show a warning in the moderation view if the moderation workflow is disabled. [timo]

• Move ‘Moderate comments’ link from site actions to user actions. [timo]

• Fix #662654: As an administrator, I can configure a Collection to show recent comments. Comment.Type() now correctly returns the FTI title (‘Comment’) [chaoflow]

• German translation updated. [juh]

• Fix #2419342: Fix untranslated published/deleted status messages. [timo]

• Remove fixed width of the actions column of the moderation view. The translated button titles can differ in size from the English titles. [timo]

• Fix #2494228: Remove comments as well when a content object is deleted. [timo]

• Fix unicode error when non-ASCII characters are typed into the name field of a comment by anonymous users. [regebro]

• Make p.a.d. work with the recent version of plone.z3cform (0.5.10) [timo]

• Make p.a.d. styles less generic. This fixes #10253. [timo]

• Added greek translation. [ggozad]

• A bug in the moderator panel meant you couldn’t delete items in a virtual host, if your portal was named “plone”. [regebro]

1.0b3 (2010-01-28)

• Added an i18n directory for messages in the plone domain and updated scripts to rebuild and sync it. [hannosch]

• Added an optional conversationCanonicalAdapterFactory showing how to share comments across all translations with LinguaPlone, by storing and retrieving the conversation from the canonical object. [hannosch]

• Play by the Plone 3.3+ rules and use the INavigationRoot as a base for the moderation view. [hannosch]

• Added a commentTitle CSS class to the comment titles. [hannosch]

• Update message ids to match their real text. [hannosch]

• Set CSS classes for the comment form in the updateActions method. [timo]

• Respect the allow_comments field on an object and avoid calculations if no comments should be shown. [hannosch]

• Automatically load the ZCML files of the captcha widgets if they are installed. [hannosch]

• Fixed i18n domain in GenericSetup profiles to be plone. Other values aren’t supported for GS profiles. [hannosch]

• Provide our own copy of the default one state workflow. Not all Plone sites have this workflow installed. [hannosch]

• Register the event subscribers for the correct interfaces in Plone 3. [hannosch]

• Factored out subscriber declarations into its own ZCML file. [hannosch]

• Bugfix for #2281226: Moderation View: Comments disappear when hitting the ‘Apply’ button without choosing a bulk action. [timo]

• Allow to show the full text of a comment in the moderation view. [timo]

• German translation added. [timo]

• Italian translation added. [keul]

1.0b2 (2010-01-22)

• Bugfix for #2010181: The name of a commenter who commented while not logged in should not appear as a link. [timo]

• Bugfix for #2010078: Comments that await moderation are visually distinguished from published comments. [timo]

• Bugfix for #2010085: Use object_provides instead of portal_type to query the catalog for comment. [timo]

• Bugfix for #2010071: p.a.d. works with plone.z3cform 0.5.7 and plone.app.z3cform 0.4.9 now. [timo]

• Bugfix for #1513398: Show “anonymous” when name field is empty in comment form. [timo]

• Migration view: Dry run option added, abort transaction when something goes wrong during migration, be more verbose about errors. [timo]

1.0b1 (2009-12-08)

• Fix redirect after a adding a comment [timo]

• Replace yes/no widgets with check boxes in the discussion control panel [timo]

• Make comments viewlet show up in Plone 4 [timo]

• Apply Plone 4 styles to comment form [timo]

• Simplify moderation view by removing the filters [timo]

1.0a2 (2009-10-18)

• Plone 4 / Zope 2.12 support [timo]

• Comment migration script added [timo]

• Pluggable plone.z3cform comment forms [timo]

• Captcha and ReCaptcha support added [timo]

1.0a1 (2009-06-07)

• Basic commenting functionality and batch moderation. [timo]