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 的評論和線上聊天