django-threadedcomments 1.2

django threadedcomments

threadedcomments是一个django应用程序，它允许简单地创建一个线程注释系统。 评论者既可以回复原始项目，也可以回复其他评论者。

应用程序（从0.9开始）构建在django_comments（或django.contrib.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（或django.contrib.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.contrib.comments）框架之上， 它支持各种信号和模板重写以自定义注释。

若要自定义django threadedcomments，请重写适当的模板，或包含提供缺少功能的应用程序。 例如，前端编辑支持是故意省略的。它属于适度和政策的范畴 知道“谁能做什么”。它应该放在一个单独的应用程序中，而不应该放在这个应用程序中，因为它专注于线程。 这同样适用于社交媒体登录、评论订阅、垃圾邮件保护和ajax发布。

请注意，标准框架还支持适度、标记和rss提要。更多文档请访问：

• Django’s comments framework
• Customizing the comments framework
• Example of using the in-built comments app

一些值得一看的模块是：

• django-comments-spamfighter
• django-myrecaptcha
• django-fluent-comments

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