Go to file
Vincent Fretin fd6a8e0fd8 * Renamed legend_add_comment to label_add_comment to have the translation from
plone domain.
* 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.

svn path=/plone.app.discussion/trunk/; revision=38574
2010-08-06 15:33:34 +00:00
dev plone.formwidget.recaptcha added to dev buildout. 2010-02-07 07:51:43 +00:00
docs whitespace 2010-07-19 08:01:25 +00:00
plone * Renamed legend_add_comment to label_add_comment to have the translation from 2010-08-06 15:33:34 +00:00
pydev-plone4 update pydev plone4 buildout to 4.0a4. 2010-02-15 11:27:11 +00:00
.gitignore gitignore mr.developer checkouts in /src/*, p.a.d code is in /plone/... 2010-03-17 16:54:33 +00:00
bootstrap.py Added a buildout to the package itself, for both Plone 3.x and 4.x. 2010-02-06 14:25:07 +00:00
buildout.cfg use plone 4 as default buildout. 2010-05-20 07:41:42 +00:00
CHANGES.txt * Renamed legend_add_comment to label_add_comment to have the translation from 2010-08-06 15:33:34 +00:00
dev-plone3.cfg collective.akismet added to dev plone3 buildout. 2010-06-21 09:13:19 +00:00
dev-plone4.cfg Upgrade dev buildout to Plone 4.0b5; Use PloneTestCase trunk for now until 0.9.10 is out. Thanks MJ! 2010-07-13 13:19:53 +00:00
README.txt collective.akismet added to plugin section. 2010-07-19 09:42:08 +00:00
setup.cfg Sphinx-based developer documentation added. 2010-03-24 07:56:53 +00:00
setup.py version => 1.0b6 2010-07-19 08:01:53 +00:00
test-plone-3.3.x.cfg Use the correct PTC version to unbreak tests 2010-02-06 14:38:36 +00:00
test-plone-4.0.x.cfg Current trunk works with plone.z3cform = 0.5.7 but throws an error with later version of that package. The monkeypatcher version pin is part of Plone's KGS now 2010-03-03 13:32:32 +00:00
versions.plone3.cfg plone3 dump-picked-versions file added. 2010-04-04 17:30:14 +00:00
versions.plone4.cfg Always use zope.component getUtility instead of queryUtility. 2010-07-12 13:34:02 +00:00

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`_.

.. _`Pivotal Tracker`: http://www.pivotaltracker.com/projects/15135

Please report bugs to the `Plone bug tracker`_.

.. _`Plone bug tracker`: http://dev.plone.org/plone/


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.0b5

    ...

    [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
  <http://pypi.python.org/pypi/collective.autoresizetextarea/>`_
  (for auto-resizing the comment textarea while typing)

- `plone.formwidget.captcha
  <http://pypi.python.org/pypi/plone.formwidget.captcha/>`_
  (for Captcha spam protection)

- `plone.formwidget.recaptcha
  <http://pypi.python.org/pypi/plone.formwidget.recaptcha/>`_
  (for ReCaptcha spam protection)

- `collective.akismet
  <http://pypi.python.org/pypi/collective.akismet/>`_
  (for Akismet spam protection)


Documentation
=============

- For developer documentation see  
  `http://packages.python.org/plone.app.discussion 
  <http://packages.python.org/plone.app.discussion>`_.

- For integrator/end-user documentation see 
  `http://plone.org/products/plone.app.discussion/documentation
  <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)