FastComments.com
Menu Icon

Język 🇵🇱 Polski
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇺🇸 English (US) 🇨🇦 Français (Canada) 🇫🇷 Français (France) 🇩🇪 Deutsch 🇨🇾 Ελληνικά (Κύπρος) 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇺🇦 Русский (Украина) 🇧🇦 Српски (БиХ) 🇷🇸 Srpski (Latinica) 🇲🇪 Српски (Црна Гора) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

Pierwsze kroki

Instalacja

Konfiguracja

Konfiguracja

Dokumentacja

Bloki widżetów
Wielojęzyczność
Uprawnienia
Jak to działa
Wymagania

Add Comments to Your Drupal Site

To jest oficjalny moduł Drupala dla FastComments.

Moduł Drupala integrujący FastComments z Drupalem 10/11, zapewniający bloki widgetów, integrację pól encji, SSO oraz szczegółowe uprawnienia.

Repozytorium

Zobacz na GitHub

Instalacja Internal Link

  1. Umieść ten moduł w katalogu swojej strony Drupal modules/custom/fastcomments/ (lub zainstaluj przez Composer: composer require drupal/fcom).
  2. Włącz moduł:
    drush en fastcomments
    Lub włącz przez interfejs administracyjny w Rozszerzenia (/admin/modules).

Konfiguracja Internal Link

Przejdź do Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Ustawienia

  • Tenant ID (required) - Your FastComments Tenant ID. Find this under Settings > API/SSO (EU).
  • API Secret - Required for Secure SSO, webhook verification, and page sync. Found under Settings > API/SSO (EU).
  • SSO Mode - Single Sign-On integration:
    • None - No SSO, users comment as guests or create FastComments accounts.
    • Simple - Passes Drupal user info (name, email, avatar) to FastComments without server-side verification.
    • Secure - Uses HMAC-SHA256 verification to securely authenticate Drupal users with FastComments (recommended).
  • Commenting Style - The type of widget to display:
    • Live Comments - Real-time threaded comments.
    • Streaming Chat - Live chat interface.
    • Collab Chat - Collaborative text-selection annotation on the main content area.
    • Collab Chat + Comments - Both collab chat and standard comments.
  • CDN URL - FastComments CDN URL (default: https://cdn.fastcomments.com).
  • Site URL - FastComments site URL (default: https://fastcomments.com).
  • Email notifications - Send an email to content authors when a new comment is posted on their content.

Adding Comments to Content Types

Add the FastComments field to your content types via Structure > Content types > [type] > Manage fields. The field has a status toggle and an optional custom identifier per entity.

EU Data Residency

For EU data residency, update:

  • CDN URL to https://cdn-eu.fastcomments.com
  • Site URL to https://eu.fastcomments.com

Bloki widżetów Internal Link

Kilka bloków jest dostępnych w Structure > Block layout (/admin/structure/block):

  • FastComments Widget - Główny widżet komentarzy. Automatycznie wykrywa bieżącą encję. Pomija encje, które mają już pole FastComments (aby zapobiec duplikatom).
  • FastComments Live Chat - Czat strumieniowy w czasie rzeczywistym. Może być umieszczony obok pola komentarzy na tej samej stronie.
  • FastComments Collab Chat - Adnotacje oparte na zaznaczaniu tekstu i dyskusja.
  • FastComments Image Chat - Adnotacje na obrazach oparte na współrzędnych.
  • FastComments Recent Comments - Wyświetla najnowsze komentarze w całym serwisie. Liczba wyświetlanych komentarzy jest konfigurowalna.
  • FastComments Top Pages - Wyświetla strony z największą liczbą komentarzy.

Bloki skoncentrowane na treści (Live Chat, Collab Chat, Image Chat) automatycznie wykrywają bieżącą encję i w przypadku stron niebędących encjami używają identyfikatora opartego na ścieżce.

Wielojęzyczność Internal Link

Moduł automatycznie przekazuje aktualny język witryny Drupal do wszystkich widżetów.

Uprawnienia Internal Link

  • Administer FastComments - Dostęp do formularza ustawień FastComments.
  • View FastComments - Wymagane, aby zobaczyć widżet komentowania.
  • Toggle FastComments - Pozwala użytkownikom włączać/wyłączać komentarze dla każdej encji za pomocą widżetu pola.

Jak to działa Internal Link

Gdy użytkownik odwiedza encję z włączonym polem FastComments:

  1. Widget JavaScript FastComments jest ładowany z CDN.
  2. Jeśli SSO jest skonfigurowane, tożsamość użytkownika Drupala jest przekazywana do FastComments.
  3. Zapasowe rozwiązanie <noscript> zapewnia serwerowo renderowane komentarze dla użytkowników bez JavaScript (tylko w trybach Live Comments i Streaming Chat).

Wymagania Internal Link

Potrzebujesz pomocy?

Jeśli napotkasz jakiekolwiek problemy lub masz pytania dotyczące modułu Drupal, prosimy:

Wkład

Wkłady są mile widziane! Odwiedź repozytorium GitHub w celu zapoznania się z wytycznymi dotyczącymi kontrybucji.

Współtwórz ten przewodnik