FastComments.com
Menu Icon

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

TLDR

Szybki start

Instalacja Drupal

Instalacja
Konfiguracja
Bloki widgetów
Pola typów treści
Jednokrotne logowanie (SSO)
Uprawnienia
Wielojęzyczność
Miejsce przechowywania danych UE
Dostosowanie
Wymagania

Ankiety

Dodaj ankiety do swojej witryny Drupal

Dodaj komentarze na żywo do stron Drupal

Szybki start Internal Link

To jest wersja „TL;DR” instrukcji dla Drupala.

  1. Zainstaluj moduł za pomocą composer require drupal/fcom, lub umieść go w modules/custom/fastcomments/.
  2. Włącz go za pomocą drush en fastcomments, lub z poziomu interfejsu administracyjnego pod adresem /admin/modules.
  3. Przejdź do Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Wprowadź swój Tenant ID i API Secret z Ustawienia > API/SSO (UE).
  5. Dodaj pole FastComments do dowolnego typu treści za pomocą Structure > Content types > [type] > Manage fields.

Moduł jest opublikowany na drupal.org/project/fcom.

Instalacja Internal Link

Moduł FastComments dla Drupala zastępuje wbudowany system komentarzy Drupala szybkim, działającym w czasie rzeczywistym systemem komentarzy. Moduł jest opublikowany na drupal.org i działa z Drupalem 10 i 11.

Istnieją dwa sposoby instalacji.

Instalacja za pomocą Composera

composer require drupal/fcom
drush en fastcomments

Instalacja ręczna

Pobierz moduł z drupal.org/project/fcom i umieść go w katalogu modules/custom/fastcomments/ swojej witryny. Następnie włącz go za pomocą drush en fastcomments, lub z poziomu interfejsu administracyjnego w Extend (/admin/modules).

Note! Moduł zależy tylko od rdzenia Drupala (user i field). Nie są wymagane żadne inne moduły Drupala ani biblioteki.

Po włączeniu modułu przejdź do sekcji Configuration, aby skonfigurować swój Tenant ID i API Secret.

Konfiguracja Internal Link

All settings live under Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Wymagane

  • Tenant ID - Twój FastComments Tenant ID. Znajdź go pod Settings > API/SSO (EU).
  • API Secret - Wymagany dla Secure SSO, weryfikacji webhooków i synchronizacji stron. Znajduje się pod Settings > API/SSO (EU).

Przechowywanie sekretu API

Moduł odczytuje sekret API z pierwszego z tych źródeł, które ma wartość:

  1. Key module - Zainstaluj Key, utwórz klucz Authentication i wybierz go w API Secret key w formularzu ustawień. Klucz może być oparty na zmiennej środowiskowej lub pliku poza katalogiem głównym witryny.
  2. settings.php - Dodaj $config['fastcomments.settings']['api_secret'] = 'your-secret'; do settings.php lub settings.local.php. Sekret nigdy nie trafia do eksportowanej konfiguracji.
  3. The settings form - Wprowadź go w polu API Secret. To przechowuje wartość w fastcomments.settings, więc trafia do eksportów konfiguracji. Raport statusu Drupala ostrzega, gdy jest to aktywne źródło.

Formularz pokazuje, które źródło jest aktywne. Pozostawienie pola pustego zachowuje przechowywany sekret. Zaznacz Remove the API Secret stored in configuration, aby usunąć go po przeniesieniu sekretu do modułu Key lub settings.php.

Styl komentowania

Wybierz widżet, który odpowiada temu, jak chcesz, aby ludzie rozmawiali na Twojej stronie.

  • Live Comments - Komentarze w czasie rzeczywistym w formie wątków.
  • Streaming Chat - Interfejs czatu na żywo, dobry na wydarzenia i transmisje na żywo.
  • Collab Chat - Anotacja zaznaczonego tekstu w głównym obszarze treści. Odwiedzający podświetlają tekst i rozpoczynają dyskusję w kontekście.
  • Collab Chat + Comments - Zarówno czat współpracy, jak i standardowe komentarze na tej samej stronie.

Tryb SSO

  • None - Brak SSO. Użytkownicy komentują jako goście lub tworzą konto FastComments.
  • Simple - Przekazuje informacje o użytkowniku Drupal (imię, e-mail, awatar) do FastComments bez weryfikacji po stronie serwera.
  • Secure - Używa HMAC‑SHA256 do weryfikacji użytkowników Drupal w FastComments. Zalecane, gdy skonfigurowany jest sekret API.

Zobacz sekcję Single Sign-On (SSO) po szczegóły.

Inne ustawienia

  • CDN URL - Domyślnie https://cdn.fastcomments.com.
  • Site URL - Domyślnie https://fastcomments.com.
  • Email notifications - Wyślij e‑mail do autora treści, gdy nowy komentarz zostanie opublikowany pod jego treścią.

W przypadku rezydencji danych w UE, zobacz sekcję EU Data Residency.

Bloki widgetów Internal Link

Moduł dostarcza kilka bloków, które możesz umieścić z poziomu Structure > Block layout (/admin/structure/block).

  • FastComments Widget - Główny widżet komentowania. Automatycznie wykrywa bieżącą encję. Pominie encje, które już mają dołączone pole FastComments, więc nie zobaczysz zduplikowanych widżetów na tej samej stronie.
  • FastComments Live Chat - Czat strumieniowy w czasie rzeczywistym. Można go umieścić obok pola komentarzy na tej samej stronie.
  • FastComments Collab Chat - Adnotacje i dyskusje dotyczące zaznaczonego tekstu.
  • FastComments Image Chat - Adnotacje na obrazach oparte na współrzędnych. Odwiedzający klikają na obraz, aby zostawić komentarz przypisany do określonego miejsca.
  • FastComments Recent Comments - Wyświetla ostatnie komentarze z całej witryny. Liczba wyświetlanych komentarzy jest konfigurowalna w ustawieniach bloku.
  • FastComments Top Pages - Pokazuje strony w twojej witrynie z największą liczbą komentarzy.

Bloki zorientowane na treść (Live Chat, Collab Chat, Image Chat) automatycznie wykrywają bieżącą encję, a na stronach niebędących encjami przechodzą do identyfikatora opartego na ścieżce. Oznacza to, że działają na stronach taksonomii, widokach i niestandardowych trasach bez dodatkowej konfiguracji.

Pola typów treści Internal Link

Dla większości stron najłatwiejszym sposobem dodania komentarzy jest dołączenie pola FastComments do swoich typów treści. Przejdź do Structure > Content types > [type] > Manage fields i dodaj to pole.

Każda encja, która ma to pole, otrzymuje:

  • A status toggle tak, aby redaktorzy mogli włączać lub wyłączać komentowanie dla poszczególnych encji.
  • Opcjonalny custom identifier, dzięki któremu możesz używać stabilnego ID, które nie jest powiązane ze ścieżką encji Drupala.

Główny blok FastComments Widget rozpoznaje to pole i pominie encje, które mają je już dołączone. Dzięki temu możesz mieszać komentarze przypisane do poszczególnych encji z blokiem bez podwójnego wyświetlania widgetu na tej samej stronie.

Jednokrotne logowanie (SSO) Internal Link

FastComments integruje się z systemem użytkowników Drupala za pomocą SSO (single sign-on). Twoi użytkownicy logują się na swojej stronie Drupal, a moduł automatycznie przekazuje ich tożsamość do FastComments. Brak dodatkowych kont do tworzenia, brak konieczności przeprowadzania początkowej synchronizacji.

The module supports three SSO modes, set under Administration > Configuration > Content > FastComments.

Brak

Brak SSO. Użytkownicy komentują jako goście lub tworzą konto FastComments. Użyj tego, jeśli Twoja strona jest publiczna i nie musisz powiązywać komentarzy z użytkownikami Drupala.

Prosty

Przekazuje do FastComments nazwę użytkownika Drupala, adres e-mail i awatar bez weryfikacji po stronie serwera. Nie jest potrzebny API Secret. Dobre dla serwisów wewnętrznych lub o niskim ryzyku.

Bezpieczny (zalecany)

Używa HMAC-SHA256 do weryfikacji tożsamości każdego użytkownika z FastComments. To jest tryb, którego chcesz użyć, gdy masz skonfigurowany API Secret, i jest to jedyny tryb, który zapobiega podszywaniu się odwiedzającego pod innego użytkownika.

Tożsamość użytkownika jest przekazywana do FastComments za każdym razem, gdy użytkownik przegląda wątek komentarzy. Nie ma potrzeby uruchamiania początkowej ani ciągłej synchronizacji.

(Opcjonalne) Dodaj swoich administratorów do Użytkownicy i administratorzy i moderatorów do Moderatorzy komentarzy, aby poprawić ich doświadczenie i włączyć śledzenie statystyk dla moderatorów.

Aby lepiej zrozumieć, jak działa SSO, zobacz sekcję SSO w dokumentacji dotyczącej dostosowań.

Uprawnienia Internal Link

Moduł dodaje trzy uprawnienia Drupala, które możesz przypisać dla poszczególnych ról w People > Permissions.

  • Administer FastComments - Dostęp do formularza ustawień FastComments pod adresem /admin/config/content/fastcomments.
  • View FastComments - Wymagane, aby zobaczyć widżet komentowania. Bez tego uprawnienia widżet nie jest renderowany.
  • Toggle FastComments - Pozwala użytkownikom włączać lub wyłączać komentarze dla poszczególnych encji za pomocą widżetu pola.

Domyślnie tylko użytkownicy z uprawnieniem administer site configuration mogą zmieniać ustawienia FastComments. Przyznaj View FastComments anonimowym i uwierzytelnionym użytkownikom, jeśli chcesz, aby odwiedzający widzieli widżet.

Wielojęzyczność Internal Link

Moduł automatycznie przekazuje aktualny język witryny Drupal do każdego widżetu FastComments. Jeśli Twoja witryna Drupal jest skonfigurowana dla wielu języków, interfejs komentowania zostanie wyświetlony w odpowiadającym języku bez dodatkowej konfiguracji.

Dotyczy to wszystkich typów widżetów: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments oraz Top Pages.

Miejsce przechowywania danych UE Internal Link

Jeśli Twoje konto FastComments jest hostowane w UE, zaktualizuj dwa ustawienia w Administration > Configuration > Content > FastComments:

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

Powinieneś także pobrać swój Tenant ID i API Secret z panelu w UE pod adresem eu.fastcomments.com/auth/my-account/api zamiast domyślnego panelu w USA. Wszystko inne w module działa tak samo.

Dostosowanie Internal Link

FastComments został zaprojektowany tak, aby można go było dostosować do wyglądu Twojej witryny.

Jeśli chcesz dodać własne style lub zmienić konfigurację, Zobacz naszą dokumentację dotyczącą dostosowywania, aby dowiedzieć się, jak.

Wymagania Internal Link

Moduł nie wymaga żadnych innych modułów Drupala ani zewnętrznych bibliotek. Wymaga jedynie rdzenia Drupala (user, field).

Mechanizm zapasowy <noscript> zapewnia komentarze renderowane po stronie serwera dla odwiedzających bez włączonego JavaScriptu, dzięki czemu Live Comments i Streaming Chat nadal działają w przeglądarkach, w których skrypty są wyłączone.

Dodaj ankiety do swojej witryny Drupal Internal Link

Gdy FastComments jest zainstalowany na Twojej stronie Drupal, możesz także uruchamiać ankiety na żywo bezpośrednio w komentarzach. Włącz Enable Polls w ustawieniach dostosowywania widgetu, a przycisk ankiety pojawi się na pasku narzędzi komentarzy. Ankiety przyjmują od 2 do 10 opcji, wyniki aktualizują się na żywo dla wszystkich na stronie, a Ty decydujesz, kto może tworzyć ankiety i czy głosowanie wymaga logowania. Nie ma nic więcej do zainstalowania na Drupal.

Wypróbuj demo Live Polls lub przeczytaj dokumentację ankiet, aby je skonfigurować.

Współtwórz ten przewodnik