django-threadedcomments 2.0

django-threadedcomments

threadedcomments 是一个 Django 应用，允许简单地创建一个线程式评论系统。评论者可以对原始条目进行回复，也可以对其他评论进行回复。

该应用基于 django_comments 构建，这使得它可以通过其他模块轻松扩展。

安装

通过 pip 安装此包

pip install django-threadedcomments

建议在虚拟环境中安装模块。

INSTALLED_APPS += (
    'threadedcomments',
    'django_comments',
    'django.contrib.sites',
)

COMMENTS_APP = 'threadedcomments'

urlpatterns += patterns('',
    url(r'^articles/comments/', include('django_comments.urls')),
)

{% load threadedcomments_tags %}

...

<h2>Comments for {{ object.title }}:</h2>

{% render_comment_list for object %}
{% render_comment_form for object %}

模板标签

threadedcomments_tags 库是 comments 库的替换品，后者用于纯评论。标签是向前兼容的；它们支持与 django_comments 提供的相同的语法，并添加了一些额外的参数。

获取评论数

{% get_comment_count for [object] as [varname] %}
{% get_comment_count for [object] as [varname] root_only %}

{% get_comment_count for [app].[model] [id] as [varname] %}
{% get_comment_count for [app].[model] [id] as [varname] root_only %}

获取评论列表

{% get_comment_list for [object] as [varname] %}
{% get_comment_list for [object] as [varname] flat %}
{% get_comment_list for [object] as [varname] root_only %}

渲染评论列表

{% render_comment_list for [object] %}
{% render_comment_list for [object] root_only %}

{% render_comment_list for [app].[model] [id] %}
{% render_comment_list for [app].[model] [id] root_only %}

获取评论表单

{% get_comment_form for [object] as [varname] %}
{% get_comment_form for [object] as [varname] with [parent_id] %}
{% get_comment_form for [app].[model] [id] as [varname] %}
{% get_comment_form for [app].[model] [id] as [varname] with [parent_id] %}

渲染评论表单

{% render_comment_form for [object] %}
{% render_comment_form for [object] with [parent_id] %}
{% render_comment_form for [app].[model] [id] %}
{% render_comment_form for [app].[model] [id] with [parent_id] %}

渲染整个树

{% for comment in comment_list|fill_tree|annotate_tree %}
    {% ifchanged comment.parent_id %}{% else %}</li>{% endifchanged %}
    {% if not comment.open and not comment.close %}</li>{% endif %}
    {% if comment.open %}<ul>{% endif %}

    <li id="c{{ comment.id }}">
        ...
    {% for close in comment.close %}</li></ul>{% endfor %}
{% endfor %}

对于分页，需要 fill_tree 过滤器，它确保包含第一个评论的父级。

annotate_tree 过滤器将 open 和 close 属性添加到评论中。

扩展模块

该应用基于标准的 django_comments 框架，该框架支持各种信号和模板覆盖以自定义评论。

要自定义 django-threadedcomments，请覆盖适当的模板或包含提供缺失功能的应用程序。例如，前端编辑支持是有意为之的。它属于监管领域，需要知道“谁可以做什么”的政策。这应该是一个独立的应用程序，而不应该在这个应用程序中，因为它专注于线程。同样适用于社交媒体登录、评论订阅、垃圾邮件保护和 Ajax 发布。

请注意，标准框架也支持监管、标记和 RSS 源。更多文档可以在以下位置找到：

• Django 的评论框架

• 自定义评论框架

• 内置评论应用程序的示例

一些值得关注的模块包括：

• django-comments-spamfighter

• django-myrecaptcha

• django-fluent-comments

这些模块可以进一步增强评论系统。