@@ -4,7 +4,7 @@ django-threadedcomments
4
4
*threadedcomments * is a Django application which allows for the simple creation of a threaded commenting system.
5
5
Commenters can reply both to the original item, and reply to other comments as well.
6
6
7
- The application is (as of 0.9) built on top of django_comments _ (or django.contrib.comments _) ,
7
+ The application is built on top of django_comments _,
8
8
which allows it to be easily extended by other modules.
9
9
10
10
@@ -33,16 +33,12 @@ Add the following to ``settings.py``::
33
33
By placing the ``threadedcomments `` app above the ``django.contrib.comments `` application,
34
34
the placeholder ``comments/list.html `` template will already be replaced by a threaded view.
35
35
36
- Make sure django.contrib.comments _ is configured in ``urls.py ``::
36
+ Make sure django_comments _ is configured in ``urls.py ``::
37
37
38
38
urlpatterns += patterns('',
39
39
url(r'^articles/comments/', include('django_comments.urls')),
40
40
)
41
41
42
- .. note ::
43
- For older Django versions (up till 1.6), you can also use django.contrib.comments _ in the ``INSTALLED_APPS ``.
44
- This packages uses either one of those packages, depending on what is installed.
45
-
46
42
Provide a template that displays the comments for the ``object `` (e.g. article or blog entry)::
47
43
48
44
{% load threadedcomments_tags %}
@@ -61,8 +57,8 @@ Template design
61
57
Naturally, it's desirable to write your own version of ``comments/list.html `` in your project,
62
58
or use one of the ``comments/app/list.html `` or ``comments/app/model/list.html `` overrides.
63
59
64
- Make sure to override ``comments/base.html `` as well, so the other views of django.contrib.comments _
65
- are displayed using your web site design. The other templates of django.contrib.comments _ are
60
+ Make sure to override ``comments/base.html `` as well, so the other views of django_comments _
61
+ are displayed using your web site design. The other templates of django_comments _ are
66
62
very plain as well on purpose (for example ``comments/posted.html ``),
67
63
since these pages depend on the custom design of the web site.
68
64
@@ -75,7 +71,7 @@ Template tags
75
71
76
72
The ``threadedcomments_tags `` library is a drop-in replacement for the ``comments `` library
77
73
that is required for the plain comments. The tags are forwards compatible;
78
- they support the same syntax as django_comments _ (or django.contrib.comments _) provides,
74
+ they support the same syntax as django_comments _ provides,
79
75
and they add a few extra parameters.
80
76
81
77
Fetching comment counts::
@@ -134,7 +130,7 @@ The ``annotate_tree`` filter adds the ``open`` and ``close`` properties to the c
134
130
Extending the module
135
131
====================
136
132
137
- The application is built on top of the standard django_comments _ (or django.contrib.comments _) framework,
133
+ The application is built on top of the standard django_comments _ framework,
138
134
which supports various signals, and template overrides to customize the comments.
139
135
140
136
To customize django-threadedcomments, override the proper templates, or include the apps that provide the missing features.
@@ -144,9 +140,9 @@ The same applies to social media logins, comment subscriptions, spam protection
144
140
145
141
Note that the standard framework also supports moderation, flagging, and RSS feeds too. More documentation can be found at:
146
142
147
- * `Django's comments framework <https://django-contrib-comments.readthedocs.org / >`_
148
- * `Customizing the comments framework <https://django-contrib-comments.readthedocs.org /en/latest/custom.html >`_
149
- * `Example of using the in-built comments app <https://django-contrib-comments.readthedocs.org /en/latest/example.html >`_
143
+ * `Django's comments framework <https://django-contrib-comments.readthedocs.io / >`_
144
+ * `Customizing the comments framework <https://django-contrib-comments.readthedocs.io /en/latest/custom.html >`_
145
+ * `Example of using the in-built comments app <https://django-contrib-comments.readthedocs.io /en/latest/example.html >`_
150
146
151
147
Some of the modules worth looking at are:
152
148
@@ -158,7 +154,6 @@ These modules can enhance the comments system even further.
158
154
159
155
160
156
.. _django_comments : https://github.com/django/django-contrib-comments
161
- .. _django.contrib.comments : https://docs.djangoproject.com/en/1.7/ref/contrib/comments/
162
157
.. _django-fluent-comments : https://github.com/edoburu/django-fluent-comments/
163
158
.. _django-myrecaptcha : https://bitbucket.org/pelletier/django-myrecaptcha/
164
159
.. _django-comments-spamfighter : https://github.com/bartTC/django-comments-spamfighter/
0 commit comments