quintagroup.plonecomments 4.1.1

Features

Plone Comments alows to:

• Notify admin about comment posted

• Notify commentator about his comment aproval

• Notify author of parent comment about new follow up added

• Moderation of comments, approval of comments

• Anonymous commenting

• Added Name field to comment form, it is required for anonymous comments

• Article author can be notified about new comment after the approval by reviewer

• List of recent comments for more comfortable moderation

Plone Comments Configlet allows:

• Turning on/off Moderation

• Turning on/off Manager notification

• Turning on/off Editor notification

• Turning on/off Anonymous Commenting

• Configure admin e-mail for notifications

• Configure notification subject

Plone Comments can be integrated with Plone Captchas (requires quintagroup.plonecaptchas to be installed)

Notes

Comments moderation is implemented with involvement of two stage workflow. Comments are created in “private” state and visible only to DiscussionManager group of users.

To differentiate between logged-in (registered) commentors and Anonymous commentors that pretend to be one person or other one, we use Boldness of name. The Comment author is in bold when posted by logged in member. The names provided when posting Anonymously are in plain text.

Notification subject control allows to enter custom prefix to disctinct notifications comming from different sites.

Usage

One of possible UseCases:

Moderation is enabled and authors notification is turned on.

• New comment posted in private state.

• Notification is sent to the emails entered in Plone Comments configlet.

• Moderator User with DiscussionManager role see the comment.

• The comment can be deleted or published on modaration stage.

• When comment is published notification is sent to Article Editor.

Links

• Get latest development version from “SVN”: http://svn.quintagroup.com/products/quintagroup.plonecomments/trunk

• Watch Plone Comments Screencast (http://quintagroup.com/cms/screencasts/plone-comments) to learn how to install and set up Plone Comments on your buildout-based Plone instance for Plone 3.2 or above. You will also find one of the possible use cases of using Plone Comments Plone add-on included.

• Watch Plone Comments Use Cases Screencast (http://quintagroup.com/cms/screencasts/plone-comments/use-cases) to learn about integration of Plone Comments with Plone Captchas, see 2 examples of possible use cases: anonymous and registered users commenting.

Requirements

• Plone 3.x

• plone.browserlayer is required for Plone 3.0.x

License

Please find license in LICENSE.GPL.

Authors

The product is developed and maintained by http://quintagroup.com team.

• Volodymyr Cherepanyak

• Andriy Mylenkyy

• Mykola Kharechko

• Vitaliy Stepanov

Contributors

• Gerry Kirk: product translations improvement and proofreading

• Dorneles Tremea: code cleanup and generic setup porting

Installation

To install quintagroup.plonecomments into the global Python environment (or a workingenv), using a traditional Zope 2 instance, you can do this:

• Copy quintagroup folder to the /path/to/instance/lib/python directory.

• Creare a file called quintagroup.plonecomments-configure.zcml in the /path/to/instance/etc/package-includes directory. The file should only contain this:

  <include package="quintagroup.plonecomments" file="configure.zcml" />

• Create a file called quintagroup.plonecomments-overrides.zcml into the /path/to/instance/etc/package-includes directory. The file should only contain this:

  <include package="quintagroup.plonecomments" file="overrides.zcml" />

• Restart the Zope server, for example, with the following command in the terminal:

  $ ./bin/zopectl restart

Alternatively, if you are using zc.buildout and the plone.recipe.zope2instance recipe to manage your project, you can do this:

• Add quintagroup.plonecomments to the list of eggs to install, e.g.:

  [buildout]
  ...
  eggs =
      ...
      quintagroup.plonecomments

• Tell the plone.recipe.zope2instance recipe to install a ZCML slug:

  [instance]
  recipe = plone.recipe.zope2instance
  ...
  zcml =
      quintagroup.plonecomments
      quintagroup.plonecomments-overrides

• Re-run buildout, e.g. with:

  $ ./bin/buildout

• Restart the Zope server, for example, with the following command in the terminal:

  $ ./bin/instance restart

• Install quintagroup.plonecomments via ZMI portal_setup. Select quintagroup.plonecomments from the list of available profiles and press Import all steps.

  Atention: If you are using a Plone version before 3.1 you need to install “plone.browserlayer”:http://pypi.python.org/pypi/plone.browserlayer (which also requires a “GenericSetup”:http://pypi.python.org/pypi/Products.GenericSetup version greater than 1.4) in your Plone site. It shows up as Local browser layer support in the Plone Add-on Products Control Panel.

Uninstallation

• To uninstall quintagroup.plonecomments - select quintagroup.plonecomments uninstall profile from the list of available profiles and press Import all steps.