跳转到主要内容

Django应用程序,扩展内置评论框架以实现AJAX风格的评论。

项目描述

Django Richcomments

Django应用程序,扩展内置评论框架以实现AJAX风格的评论。

django-richcomments 将Django的评论框架现有的 render_comment_listrender_comment_form 模板标签包装起来,使它们表现得像AJAX。

安装

  1. 安装或添加 django-richcomments 到您的Python路径。

  2. 此处所述配置Django的评论框架。

  3. 将richcomments url include添加到项目的 urls.py 文件

    (r'^richcomments/', include('richcomments.urls')),
  4. 确保 django-richcomments 静态媒体可访问,请参阅 管理静态文件

使用

django-richcomments 简单地封装了现有的 render_comment_listrender_comment_form 模板标签,使它们表现得像 AJAX。因此,当提交评论时,它通过 JavaScript 完成,并且现有的评论列表无需重新加载页面即可更新。您可以根据常规方式自定义评论列表和表单的 HTML。从代码的角度来看,评论的行为与正常行为完全相同,只是在由 render_comment_form 标签生成的表单将通过 AJAX 提交,而由 render_comment_list 生成的评论列表将在提交后通过 AJAX 更新。

为了让 richcomments 在页面中生效,需要加载 jQueryjQuery 表单插件 JavaScript 库。这两个库都包含在 django-richcomments 静态媒体中,并提供了一个快捷模板标签以方便使用,即

{% load richcomments %}

{% richcomments_static %}

它渲染以下内容(使用在您的设置中配置的静态路径)

<script type="text/javascript" src="/static/richcomments/includes/jquery.min.js"></script>
<script type="text/javascript" src="/static/richcomments/includes/jquery.form.js"></script>

为了回顾,以下是一个简单示例,说明您如何显示评论列表以及用于提交和通过 AJAX 更新的对象评论表单

{% load comments richcomments %}

<html>
    <head>
        {% richcomments_static %}
    </head>
    <body>
        {% render_comment_list for object %}
        {% render_comment_form for object %}
    </body>
</html>

作者

Praekelt 基金会

  • Shaun Sephton

变更日志

0.0.2 (2011-09-15)

  1. 文档,静态媒体标签。

0.0.1 (2010-08-03)

  1. 初始发布

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面