django-mptt-comments icon indicating copy to clipboard operation
django-mptt-comments copied to clipboard

A restful comment system using modified preordered tree traversal ala. slashdot

==================== Django Mptt Comments

Django Mptt Comments is a simple way to display threaded comments instead of the django contrib comments.

Installation

#. Get the required third party modules ::

svn checkout http://django-mptt.googlecode.com/svn/trunk/mptt

svn checkout http://django-template-utils.googlecode.com/svn/trunk/template_utils

#. Get Mptt Comments

git clone git://github.com/thoas/django-mptt-comments.git

#. Add the mptt_comments directory to your Python path.

#. Add the needed apps to INSTALLED_APPS ::

'django.contrib.comments',
'django.contrib.markup',
'template_utils',
'mptt',
'mptt_comments'

#. Add mptt_comments.urls to your projects urlconf ::

(r'^comments/', include('mptt_comments.urls')),

#. Add the required code to the objects detail page (see Usage)

#. Copy the templates to adapt them for your site

#. Style the forms using css

Usage

In any detail template that wants to use mptt_comments ::

    {% block extrahead %}
    
    {% load mptt_comments_tags %}
    {% mptt_comments_media %}
    
    {% endblock extrahead %}

To display the toplevel tree in templates: ::

    {% load mptt_comments_tags %}    

    {% display_comment_toplevel_for object %}
    

SETTINGS

MPTT_COMMENTS_OFFSET

Number of comments displayed before 'read more' link appears

MPTT_COMMENTS_CUTOFF

Depth of comments to be shown

MPTT_COMMENTS_SELECT_RELATED

Additional related objects to be used in select_related call
for example ['user__designer', 'user__designer__level']

Use patch from ticket #7270 if you need reverse OneToOne lookups like in example above

TODO

  • Make the more link work without javascript

Contributors

Михаил Сычёв (Mike) Florent Messa (thoas)