wheelcms_comments 0.2

WheelCMS comments package

WheelCMS comments
=================


This package provides support for simple (local) comments on WheelCMS content.
It's similar to the
[wheelcms_disqus package](https://github.com/wheelcms/wheelcms_disqus/), but does
not require an external service.

Installation
------------

Add wheelcms_comments to your INSTALLED_APPS *before* the wheelcms_axle package, e.g.

INSTALLED_APPS = (
"wheelcms_comments",
...
"wheelcms_axle",
)


if your base definition of INSTALLED_APPS is out of your direct control
(e.g. when using
[wheelcms_project](https://github.com/wheelcms/wheelcms_project)), try
something like this:

INSTALLED_APPS = (
"wheelcms_comments",
) + INSTALLED_APPS


wheelcms_comments uses [django-simple-captcha](https://django-simple-captcha.readthedocs.org/en/latest/usage.html), so you will need to include this
as well:

Add

from django.conf.urls.defaults import *

urlpatterns += patterns('',
url(r'^captcha/', include('captcha.urls')),
)

to your urls.py. Like with the INSTALLED_APPS, make sure the captcha
pattern matches *before* the base patterns or else the WheelCMS patterns
will intercept the /captcha requests.

django-simple-captcha depends on the PIL library. You may need to install "python-imaging" or Pillow depending on your OS/Distribution. You will also need FreeType support with your PIL.

Lastly, add 'captcha' to your INSTALLED_APPS

Using comments
--------------

Now you should be able to enable commenting in your site's settings (save
the settings the first time, it may show incorrectly that comments are
already enabled).

You can also enable/disable comments on a per-content basis.

New contents will be created as WheelCMS content (content type Comment)
with an initial state 'pending'. You can use the workflow dropup in the
toolbar to moderate pending comments.

Upgrade notes
-------------

pre 0.2 users should fake migrate the first migration:

manage.py migrate wheelcms_comments 0001 --fake