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

W skrócie

Szybki start

Instalacja Drupala

Instalacja
Konfiguracja
Bloki widżetów
Pola typu treści
Logowanie jednokrotne (SSO)
Uprawnienia
Wielojęzyczność
Przechowywanie danych w UE
Dostosowywanie
Wymagania

Add Live Commenting to Drupal Sites

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

Wszystkie ustawienia znajdują się w Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Wymagane

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

Styl komentowania

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

  • Live Comments - Komentarze wątkowe w czasie rzeczywistym.
  • Streaming Chat - Interfejs czatu na żywo, dobry na wydarzenia i transmisje na żywo.
  • Collab Chat - Adnotacje poprzez zaznaczanie tekstu na głównym obszarze treści. Odwiedzający zaznaczają tekst i zaczynają dyskusję w kontekście.
  • Collab Chat + Comments - Zarówno collab chat, jak i standardowe komentarze na tej samej stronie.

Tryb SSO

  • None - Brak SSO. Użytkownicy komentują jako goście lub tworzą konto FastComments.
  • Simple - Przesyła informacje użytkownika Drupala (imię, email, avatar) do FastComments bez weryfikacji po stronie serwera.
  • Secure - Używa HMAC-SHA256 do weryfikacji użytkowników Drupala z FastComments. Zalecane, gdy masz skonfigurowane API Secret.

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 na jego treści pojawi się nowy komentarz.

W sprawie przechowywania danych w UE zobacz sekcję EU Data Residency.

Bloki widżetó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 typu 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.

Logowanie jednokrotne (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.

Przechowywanie danych w 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.

Dostosowywanie 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.

Współtwórz ten przewodnik