FastComments.com
Menu Icon

Jezik 🇸🇮 Slovenščina
🇺🇸 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

Povzetek

Hiter začetek

Namestitev Drupala

Namestitev
Konfiguracija
Bloki pripomočkov
Polja tipov vsebine
Enotna prijava (SSO)
Dovoljenja
Večjezičnost
Lokacija podatkov v EU
Prilagoditev
Zahteve

Add Live Commenting to Drupal Sites

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

Vse nastavitve najdete v Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Required

  • Tenant ID - Vaš FastComments Tenant ID. Najdete ga pod Settings > API/SSO (EU).
  • API Secret - Zahtevan za Secure SSO, preverjanje webhookov in sinhronizacijo strani. Najdete ga pod Settings > API/SSO (EU).

Commenting Style

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

  • Live Comments - Komentarji v realnem času, organizirani v niti.
  • Streaming Chat - Vmesnik za klepet v živo, primeren za dogodke in prenose v živo.
  • Collab Chat - Označevanje besedila za pripombe na glavnem vsebinskem območju. Obiskovalci označijo besedilo in začnejo razpravo v kontekstu.
  • Collab Chat + Comments - Tako collab chat kot običajni komentarji na isti strani.

SSO Mode

  • None - Brez SSO. Uporabniki komentirajo kot gostje ali ustvarijo FastComments račun.
  • Simple - Posreduje podatke uporabnika Drupal (name, email, avatar) FastComments brez preverjanja na strežniku.
  • Secure - Uporablja HMAC-SHA256 za preverjanje uporabnikov Drupala z FastComments. Priporočeno, ko imate konfiguriran API Secret.

Oglejte si razdelek Single Sign-On (SSO) za podrobnosti.

Other Settings

  • CDN URL - Privzeto https://cdn.fastcomments.com.
  • Site URL - Privzeto https://fastcomments.com.
  • Email notifications - Pošlje e-poštno obvestilo avtorju vsebine, ko je na njegovi vsebini objavljen nov komentar.

Za EU podatkovno rezidenco 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 tri Drupal dovoljenja, ki jih lahko dodelite na vlogo pod People > Permissions.

  • Administer FastComments - Dostop do obrazca za nastavitve FastComments na /admin/config/content/fastcomments.
  • View FastComments - Zahtevano za ogled pripomočka za komentarje. Brez tega dovoljenja se pripomoček ne prikaže.
  • Toggle FastComments - Omogoča uporabnikom, da vključijo ali izključijo komentarje na ravni posamezne entitete z uporabo pripomočka polja.

By default, only users with the administer site configuration permission can change FastComments settings. Grant View FastComments to anonymous and authenticated users if you want visitors to see the 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.

Lokacija podatkov v 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.

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

Prispevajte k temu vodniku