Vadim-Karpenko/wagtail_comments_xtd

This module allows you to manage django-comments-xtd comments into the Wagtail admin UI. Tested on Wagtail 1.7+ Forked from adrihein

Wagtail Comments

This module allows you to manage django-comments-xtd comments into the Wagtail admin UI. Tested on Wagtail 1.7+.

This Project is a fork of wagtailcomments_xtd from adrihein. The only reason at th is moment is to create a working pip package, since the original is broken, and author does not seem to be maintaining the package anymore.

Instructions

Install

pip install wagtail_comments_xtd

Add 'wagtail_comments_xtd' to your INSTALLED_APPS

Add 'wagtailfontawesome' to INSTALLED_APPS if it's not there already

Settings

1. Enable the "sites" framework <enabling-the-sites-framework> by adding 'django.contrib.sites' to INSTALLED_APPS and defining SITE_ID. Visit the admin site and be sure that the domain field of the Site instance points to the correct domain (localhost:8000 when running the default development server), as it will be used to create comment verification URLs, follow-up cancellations, etc.

2. Add 'django_comments_xtd' and 'django_comments', in that order, to INSTALLED_APPS.

3. Set the COMMENTS_APP setting to 'django_comments_xtd'.

4. Set the COMMENTS_XTD_MAX_THREAD_LEVEL to N, being N the maximum level of threading up to which comments will be nested in your project.

   # 0: No nested comments:
   #  Comment (level 0)
   # 1: Nested up to level one:
   #  Comment (level 0)
   #   |-- Comment (level 1)
   # 2: Nested up to level two:
   #  Comment (level 0)
   #   |-- Comment (level 1)
   #        |-- Comment (level 2)
   COMMENTS_XTD_MAX_THREAD_LEVEL = 2
   

   The thread level can also be established on a per <app>.<model> basis by using the COMMENTS_XTD_MAX_THREAD_LEVEL_BY_APP_MODEL setting. Use it to establish different maximum threading levels for each model. ie: no nested comments for quotes, up to thread level 2 for blog stories, etc.

5. Set the COMMENTS_XTD_CONFIRM_EMAIL to True to require comment confirmation by email for no logged-in users.

6. Run manage.py migrate to create the tables.

7. Add the URLs of the comments-xtd app to your project’s urls.py:

   urlpatterns = [
       ...
       url(r'^comments/', include('django_comments_xtd.urls')),
       ...
   ]
   

8. Customize your project’s email settings:

   EMAIL_HOST = "smtp.mail.com"
   EMAIL_PORT = "587"
   EMAIL_HOST_USER = "alias@mail.com"
   EMAIL_HOST_PASSWORD = "yourpassword"
   DEFAULT_FROM_EMAIL = "Helpdesk <helpdesk@yourdomain>"
   
   

Now what

When you successfully have installed wagtail_comments_xtd, you have to carefully read the documentation for django_comments_xtd to configure the frontend for the commenting system