Django 评论和在线聊天软件包

十一个模板标签，零复杂度

只需加载一次标签库，设置您的租户 ID，即可使用单个标签嵌入任何小部件。功能包括评论、实时聊天、评论计数、协作聊天和图片聊天、最新活动动态、评价、热门页面和用户活动。

主题评论

在任何页面上添加功能齐全的嵌套评论组件。回复、@提及、投票、富文本和实时更新等功能开箱即用。

{% load fastcomments %}
{% fastcomments url_id=post.slug url=post.get_absolute_url %}

在线聊天

在任何页面或资源中嵌入实时聊天室。专为直播活动、支持渠道和带有在线状态指示器的社区中心而设计。

{% fastcomments_live_chat url_id=channel.slug %}

评论数

在任何页面上直接显示评论数。非常适合文章列表、仪表盘和导航徽章。使用批量加载器，只需一次请求即可填充列表页面上的所有计数。

Comments: {% fastcomments_comment_count url_id=post.slug number_only=True %}

灵活的 SSO 选项

选择适合您应用程序需求的身份验证模式。

受到推崇的

安全 SSO

使用 Django 身份验证用户进行服务器端 HMAC-SHA256 令牌签名，以实现最高安全性。

加密代币签名
自动读取 request.user
头像和显示名称同步
使用 USER_MAP 或自定义映射器映射字段

简易单点登录

客户端单点登录，无需服务器签名即可快速设置。

无需 API 密钥
用户名和电子邮件映射
自动登录

无单点登录

允许用户独立创建自己的 FastComments 帐户。

零配置
基于电子邮件的帐户
可选择匿名评论

几分钟内即可启动运行

三步即可在 Django 应用中实现实时评论。

使用 pip 安装

使用 pip 从 GitHub 安装该软件包。如果需要服务器端 REST 访问，请添加 api 附加组件。

bash

$pip install "git+https://github.com/fastcomments/fastcomments-django.git@v0.1.0"

添加应用和 API 密钥

将“fastcomments_django”添加到 INSTALLED_APPS，然后使用您的 TENANT_ID 和 API_KEY 设置 FASTCOMMENTS 字典。

settings.py

INSTALLED_APPS = [
    # ...
    "fastcomments_django",
]

FASTCOMMENTS = {
    "TENANT_ID": "your-tenant-id",
    "API_KEY": "your-api-key",
}

插入式模板标签

在任何模板中加载标签库，然后将评论小部件拖放到您希望显示讨论串的任何位置。

templates/post_detail.html

{% load fastcomments %}

{% fastcomments url_id=post.slug %}

常见问题解答

我们整理了一些最常见问题的答案，以帮助您入门。

有免费试用吗？

是的。FastComments 提供 30 天免费试用，期间可完全访问所有功能，包括单点登录、在线聊天和富文本编辑器。无需信用卡即可开始使用。

SSO 如何与 Django 身份验证协同工作？

启用安全单点登录 (Secure SSO) 后，该软件包会从请求中读取已验证用户，并在服务器上对 HMAC-SHA256 令牌进行签名。这将使用用户的姓名、电子邮件地址和头像创建或更新其 FastComments 帐户，从而实现用户无需额外注册即可登录。您可以使用 USER_MAP、用户模型中的 to_fastcomments_user_data() 方法或全局 USER_MAPPER 来映射字段。请谨慎选择 SSO ID：它是用户评论历史记录的永久句柄，因此请将其映射到稳定且不透明的值（例如 UUID），而不是顺序主键。

支持哪些Django和Python版本？

FastComments Django 包支持 Django 4.2、5.0、5.1 和 5.2 版本，需要 Python 3.10 或更高版本。它以标准 Django 应用的形式安装，在 INSTALLED_APPS 中添加一个条目。

FastComments是否符合GDPR要求？

是的。FastComments 完全符合 GDPR 要求，并提供可选的欧盟 CDN，确保所有数据都保留在欧洲境内。在 FASTCOMMENTS 设置中将 REGION 设置为“eu”，即可将组件和 API 调用路由到欧盟地区。我们支持数据导出请求、删除权，并可根据要求提供数据处理协议 (DPA)。

我可以自定义小部件标记吗？

是的。您可以通过将自定义的 fastcomments/widget.html 模板副本放置在模板搜索路径的更靠前位置来覆盖默认模板。每个标签都接受标准的 FastComments 配置选项作为关键字参数，让您无需编辑软件包即可完全控制其外观和行为。

我可以从 Django 访问 FastComments API 吗？

是的。安装 API 扩展包后，该软件包将公开 FastComments Python SDK：`admin()` 用于已认证的调用，`public_api()` 用于公共调用，`get_manager()` 用于签署 SSO 令牌。您可以使用它们在视图或后台作业中创建、更新或删除评论、管理用户、获取分析数据等等。

Django 的评论和在线聊天