FastComments.com
Menu Icon

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

TLDR

Hiter začetek

Namestitev Drupala

Namestitev
Konfiguracija
Bloki pripomočkov
Polja tipov vsebine
Enotna prijava (SSO)
Dovoljenja
Večjezičnost
Podatkovno rezidenstvo EU
Prilagajanje
Zahteve

Ankete

Dodajte ankete na vašo Drupal stran

Dodajte živo komentiranje na Drupal strani

Hiter začetek Internal Link

To je skrajšana različica (TL;DR) navodil za Drupal.

  1. Namestite modul z composer require drupal/fcom, ali ga postavite v modules/custom/fastcomments/.
  2. Omogočite ga z drush en fastcomments, ali preko skrbniškega vmesnika na /admin/modules.
  3. Pojdite na Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Vnesite svoj Tenant ID in API Secret iz Nastavitve > API/SSO (EU).
  5. Dodajte polje FastComments kateremu koli tipu vsebine preko Structure > Content types > [type] > Manage fields.

Modul je objavljen na drupal.org/project/fcom.

Namestitev Internal Link

Modul FastComments za Drupal nadomešča vgrajene komentarje Drupala s hitrim, v realnem času delujočim sistemom za komentiranje. Modul je objavljen na drupal.org in deluje z Drupalom 10 in 11.

Obstajata dva načina za namestitev.

Namestitev z Composer

composer require drupal/fcom
drush en fastcomments

Ročna namestitev

Prenesite modul z drupal.org/project/fcom in ga postavite v mapo vaše spletne strani modules/custom/fastcomments/. Nato ga omogočite z drush en fastcomments, ali iz skrbniškega vmesnika na Extend (/admin/modules).

Note! Modul je odvisen le od Drupal core (user and field). Ni potrebnih nobenih drugih Drupal modulov ali knjižnic.

Ko je modul omogočen, pojdite v razdelek Configuration, da nastavite svoj Tenant ID in API Secret.

Konfiguracija Internal Link

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

Zahtevano

  • Tenant ID – Vaš FastComments Tenant ID. Najdete ga pod Settings > API/SSO (EU).
  • API Secret – Potrebno za varno SSO, preverjanje webhooka in sinhronizacijo strani. Najdete ga pod Settings > API/SSO (EU).

Shranjevanje API skrivnosti

Modul prebere API Secret iz prvega od teh virov, ki ima vrednost:

  1. Key module – Namestite Key, ustvarite ključ Authentication in ga izberite pod API Secret key v obrazcu nastavitev. Ključ je lahko podprt z okoljsko spremenljivko ali datoteko izven korena spletnega strežnika.
  2. settings.php – Dodajte $config['fastcomments.settings']['api_secret'] = 'your-secret'; v settings.php ali settings.local.php. Skrivnost se nikoli ne vključi v izvoženo konfiguracijo.
  3. The settings form – Vnesite jo v polje API Secret. To shrani vrednost v fastcomments.settings, zato se pojavi v izvozu konfiguracije. Drupalovo poročilo o stanju opozori, ko je to aktivni vir.

Obrazec prikazuje, kateri vir je aktiven. Če pustite polje prazno, se ohrani shranjena skrivnost. Označite Remove the API Secret stored in configuration, da jo izbrišete po premiku skrivnosti v modul Key ali settings.php.

Slog komentiranja

Izberite gradnik, ki ustreza načinu, kako želite, da ljudje komunicirajo na vašem spletnem mestu.

  • Live Comments – Komentarji v realnem času.
  • Streaming Chat – Vmesnik za klepet v živo, primeren za dogodke in prenose v živo.
  • Collab Chat – Oznaka izbranega besedila v glavnem vsebinskem območju. Obiskovalci označijo besedilo in začnejo razpravo v kontekstu.
  • Collab Chat + Comments – Tako collab chat kot standardni komentarji na isti strani.

Način SSO

  • None – Brez SSO. Uporabniki komentirajo kot gostje ali ustvarijo FastComments račun.
  • Simple – Posreduje informacije o Drupal uporabniku (ime, e‑mail, avatar) FastComments brez strežniškega preverjanja.
  • Secure – Uporablja HMAC‑SHA256 za preverjanje Drupal uporabnikov s FastComments. Priporočeno, ko je konfigurirana API Secret.

Za podrobnosti glejte razdelek Single Sign-On (SSO).

Druge nastavitve

  • CDN URL – Privzeto https://cdn.fastcomments.com.
  • Site URL – Privzeto https://fastcomments.com.
  • Email notifications – Pošlji e‑mail avtorju vsebine, ko je na njegovo vsebino objavljen nov komentar.

Za rezidenčnost podatkov v EU glejte razdelek EU Data Residency.

Bloki pripomočkov Internal Link

Modul priloži več blokov, ki jih lahko postavite iz Structure > Block layout (/admin/structure/block).

  • FastComments Widget - Glavni pripomoček za komentiranje. Samodejno zazna trenutno entiteto. Preskočil bo entitete, ki imajo že pripeto FastComments polje, zato na isti strani ne boste videli podvojenih pripomočkov.
  • FastComments Live Chat - Klepet v realnem času s pretočnim prenosom. Lahko ga postavite ob polje za komentarje na isti strani.
  • FastComments Collab Chat - Označevanje besedila z opombami in razprava.
  • FastComments Image Chat - Opombe na podlagi koordinat na slikah. Obiskovalci kliknejo sliko, da pustijo komentarje, vezane na določene lokacije.
  • FastComments Recent Comments - Prikaže nedavne komentarje na vašem spletišču. Število je nastavljivo na bloku.
  • FastComments Top Pages - Prikaže strani na vašem spletišču z največ komentarji.

Vsebinski bloki (Live Chat, Collab Chat, Image Chat) samodejno zaznavajo trenutno entiteto in se, na straneh brez entitete, zanašajo na identifikator, osnovan na poti. To pomeni, da delujejo na taxonomy pages, views in custom routes brez dodatne nastavitve.

Polja tipov vsebine Internal Link

Za večino spletnih mest je najlažji način za dodajanje komentarjev pripeti polje FastComments k vašim tipom vsebine. Pojdite na Structure > Content types > [type] > Manage fields in dodajte polje.

Vsaka entiteta, ki ima to polje, prejme:

  • Preklopnik stanja, da lahko uredniki za vsako entiteto posebej vklopijo ali izklopijo komentiranje.
  • Neobvezni prilagojen identifikator, da lahko uporabite stabilen ID, ki ni vezan na pot entitete v Drupalu.

Glavni blok FastComments Widget upošteva to polje in bo preskočil entitete, ki imajo to polje že pripeto. Na ta način lahko združite komentiranje po entitetah z blokom, ne da bi na isti strani videli pripomoček dvakrat.

Enotna prijava (SSO) Internal Link

FastComments se poveže z Drupalovim sistemom uporabnikov preko SSO oziroma enotne prijave. Vaši uporabniki se prijavijo na vaše Drupal spletno mesto, modul pa samodejno posreduje njihovo identiteto v FastComments. Ni treba ustvarjati dodatnih računov, ni začetne sinhronizacije.

Modul podpira tri načine SSO, nastavljene pod Administration > Configuration > Content > FastComments.

Brez

Brez SSO. Uporabniki komentirajo kot gostje ali ustvarijo FastComments račun. Uporabite to, če je vaše mesto javno in ne potrebujete povezovanja komentarjev z Drupal uporabniki.

Enostaven

Posreduje Drupalovo uporabniško ime, e-pošto in avatar v FastComments brez strežniške verifikacije. Ni potreben API Secret. Primerno za notranja ali nizko-rizična mesta.

Varen (priporočeno)

Uporablja HMAC-SHA256 za preverjanje vsake uporabniške identitete z FastComments. To je način, ki ga želite, ko imate nastavljen API Secret, in je edini način, ki prepreči obiskovalcu, da se lažno predstavlja za drugega uporabnika.

Uporabniška identiteta se posreduje v FastComments vsakič, ko uporabnik ogleda nit komentarjev. Ni začetne ali stalne sinhronizacije, ki bi jo bilo treba izvajati.

(Optional) Dodajte vaše skrbnike v Uporabniki & Skrbniki in moderatorje v Moderatorji komentarjev, da izboljšate njihovo izkušnjo in omogočite sledenje statistik moderatorjem.

Za podrobnejši vpogled, kako SSO deluje, glejte SSO oddelek dokumentacije o prilagoditvah.

Dovoljenja Internal Link

Modul doda trije Drupal dovoljenja, ki jih lahko dodelite po vlogah pod People > Permissions.

  • Administer FastComments - Dostop do obrazca nastavitev FastComments na /admin/config/content/fastcomments.
  • View FastComments - Obvezno za prikaz widgeta za komentarje. Brez tega dovoljenja se widget ne izriše.
  • Toggle FastComments - Uporabnikom omogoča, da na ravni posamezne entitete vklopijo ali izklopijo komentarje z uporabo polja widgeta.

Privzeto lahko nastavitve FastComments spremenijo samo uporabniki z dovoljenjem administer site configuration. Dodelite View FastComments anonimnim in avtenticiranim uporabnikom, če želite, da obiskovalci vidijo widget.

Večjezičnost Internal Link

Modul samodejno posreduje trenutni jezik spletnega mesta Drupal vsakemu FastComments widgetu. Če je vaše spletno mesto Drupal nastavljeno za več jezikov, se bo vmesnik za komentiranje prikazal v ustreznem jeziku brez dodatne konfiguracije.

To velja za vse vrste widgetov: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments in Top Pages.

Podatkovno rezidenstvo EU Internal Link

Če je vaš račun FastComments gostovan v EU, posodobite dve nastavitvi na Administration > Configuration > Content > FastComments:

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

Prav tako boste želeli pridobiti svoj Tenant ID in API Secret iz EU nadzorne plošče na eu.fastcomments.com/auth/my-account/api namesto iz privzete nadzorne plošče v ZDA. Vse ostalo v modulu deluje enako.

Prilagajanje Internal Link

FastComments je zasnovan tako, da ga lahko prilagodite svojemu spletnemu mestu.

Če želite dodati lastno oblikovanje ali prilagoditi konfiguracijo, Oglejte si našo dokumentacijo o prilagoditvah in konfiguraciji in se naučite, kako.

Zahteve Internal Link

  • Drupal 10 ali 11
  • PHP 8.1 ali novejši
  • Račun pri FastComments

Modul ne zahteva nobenih drugih Drupal modulov ali knjižnic tretjih oseb. Zanaša se le na jedro Drupala (user, field).

Rezerva <noscript> zagotavlja strežniško upodobljene komentarje za obiskovalce brez JavaScripta, tako da Live Comments in Streaming Chat še vedno delujeta v brskalnikih z onemogočenim skriptiranjem.

Dodajte ankete na vašo Drupal stran Internal Link

Ko je FastComments nameščen na vašem spletnem mestu Drupal, lahko tudi izvajate ankete v živo neposredno v komentarjih. V nastavitvah prilagajanja gradnika vklopite Enable Polls in v orodni vrstici komentarjev se prikaže gumb ankete. Ankete podpirajo od 2 do 10 možnosti, rezultati se posodabljajo v živo za vse na strani, vi pa izberete, kdo lahko ustvarja ankete in ali glasovanje zahteva prijavo. Nič drugega ni potrebno namestiti na Drupal.

Poskusite demo Live Polls ali preberite dokumentacijo o anketah, da jih nastavite.

Prispevajte k temu vodniku