FastComments.com
Menu Icon

Jezik 🇭🇷 Hrvatski
🇺🇸 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

Ukratko

Brzi početak

Instalacija Drupala

Instalacija
Konfiguracija
Blokovi widgeta
Polja tipa sadržaja
Jedinstvena prijava (SSO)
Dozvole
Višejezično
Pohrana podataka u EU
Prilagodba
Zahtjevi

Add Live Commenting to Drupal Sites

Brzi početak Internal Link

Ovo je "predugo, nisam čitao" verzija uputa za Drupal.

  1. Instalirajte modul pomoću composer require drupal/fcom, ili ga stavite u modules/custom/fastcomments/.
  2. Omogućite ga pomoću drush en fastcomments, ili iz administratorskog sučelja na /admin/modules.
  3. Idite na Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Unesite svoj Tenant ID i API Secret iz Settings > API/SSO (EU).
  5. Dodajte polje FastComments bilo kojem tipu sadržaja putem Structure > Content types > [type] > Manage fields.

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

Instalacija Internal Link

FastComments Drupal modul zamjenjuje ugrađene Drupal komentare brzim, komentarskim sustavom u stvarnom vremenu. Modul je objavljen na drupal.org i radi s Drupalom 10 i 11.

Postoje dva načina instalacije.

Instalacija s Composerom

composer require drupal/fcom
drush en fastcomments

Ručna instalacija

Preuzmite modul s drupal.org/project/fcom i smjestite ga u direktorij vaše stranice modules/custom/fastcomments/. Zatim ga omogućite s drush en fastcomments, ili putem administratorskog sučelja pod Extend (/admin/modules).

Napomena! Modul ovisi samo o jezgri Drupala (user i field). Nisu potrebni drugi Drupal moduli niti biblioteke.

Kada je modul omogućen, idite u odjeljak Configuration kako biste postavili svoj Tenant ID i API Secret.

Konfiguracija Internal Link

Sva podešavanja nalaze se pod Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Obavezno

  • Tenant ID - Vaš FastComments Tenant ID. Pronađite ga pod Postavke > API/SSO (EU).
  • API Secret - Potrebno za Secure SSO, provjeru webhookova i sinkronizaciju stranica. Nalazi se pod Postavke > API/SSO (EU).

Stil komentiranja

Pick the widget that matches how you want people to talk on your site.

  • Live Comments - Komentari u niti u stvarnom vremenu.
  • Streaming Chat - Sučelje za chat uživo, pogodno za događaje i prijenose uživo.
  • Collab Chat - Označavanje teksta na glavnom sadržaju. Posjetitelji označe tekst i započnu diskusiju u kontekstu.
  • Collab Chat + Comments - I Collab Chat i standardni komentari na istoj stranici.

Način SSO

  • None - Nema SSO. Korisnici komentiraju kao gosti ili kreiraju FastComments račun.
  • Simple - Prosljeđuje Drupal korisničke podatke (name, email, avatar) FastComments bez verifikacije na poslužitelju.
  • Secure - Koristi HMAC-SHA256 za verifikaciju Drupal korisnika s FastComments. Preporučeno kada imate konfiguriran API Secret.

See the Single Sign-On (SSO) section for details.

Ostala podešavanja

  • CDN URL - Zadano na https://cdn.fastcomments.com.
  • Site URL - Zadano na https://fastcomments.com.
  • Email notifications - Šalje e-poštu autoru sadržaja kada je na njihov sadržaj objavljen novi komentar.

Za rezidenciju podataka u EU, pogledajte odjeljak EU Data Residency.

Blokovi widgeta Internal Link

Modul dolazi s nekoliko blokova koje možete postaviti iz Structure > Block layout (/admin/structure/block).

  • FastComments Widget - Glavni widget za komentare. Automatski otkriva trenutni entitet. Preskočit će entitete koji već imaju pridružen FastComments field, tako da na istoj stranici nećete vidjeti duplicirane widgete.
  • FastComments Live Chat - Chat u stvarnom vremenu. Može se postaviti uz polje za komentare na istoj stranici.
  • FastComments Collab Chat - Označavanje teksta i rasprava.
  • FastComments Image Chat - Anotacije na slikama temeljene na koordinatama. Posjetitelji klikaju na sliku kako bi ostavili komentare vezane uz određena mjesta.
  • FastComments Recent Comments - Prikazuje nedavne komentare na vašoj web-lokaciji. Broj prikazanih komentara može se konfigurirati u bloku.
  • FastComments Top Pages - Prikazuje stranice na vašoj web-lokaciji s najviše komentara.

Blokovi usmjereni na sadržaj (Live Chat, Collab Chat, Image Chat) automatski otkrivaju trenutni entitet, a na stranicama koje nisu entitet koriste identifikator zasnovan na putu. To znači da rade na taksonomskim stranicama, views i prilagođenim rutama bez dodatnog podešavanja.

Polja tipa sadržaja Internal Link

Za većinu stranica, najlakši način za dodavanje komentara je pridruživanje polja FastComments vašim tipovima sadržaja. Idite na Structure > Content types > [type] > Manage fields i dodajte polje.

Svaki entitet kojem je polje pridruženo dobiva:

  • A status toggle koji urednicima omogućuje uključivanje ili isključivanje komentiranja za pojedini entitet.
  • An optional custom identifier koji vam omogućuje upotrebu stabilnog ID-a koji nije vezan uz Drupal put entiteta.

Glavni blok FastComments Widget prepoznaje ovo polje i preskočit će entitete kojima je polje već pridruženo. Na taj način možete kombinirati komentare po entitetu s blokom bez prikazivanja widgeta dvaput na istoj stranici.

Jedinstvena prijava (SSO) Internal Link

FastComments se integrira s Drupalovim sustavom korisnika putem SSO, odnosno single-sign-on. Vaši korisnici se prijavljuju na vaš Drupal sajt, a modul automatski prosljeđuje njihov identitet FastCommentsu. Nema potrebe za dodatnim računima, nema početne sinkronizacije.

Modul podržava tri SSO načina rada, postavljena pod Administration > Configuration > Content > FastComments.

Nijedan

Bez SSO-a. Korisnici komentiraju kao gosti ili naprave FastComments račun. Koristite ovo ako je vaš sajt javan i ne trebate povezivati komentare s Drupal korisnicima.

Jednostavan

Prosljeđuje Drupalovo korisničko ime, email i avatar FastCommentsu bez provjere na strani servera. Nije potreban API Secret. Dobro za interne ili niskorizične sajtove.

Siguran (preporučeno)

Koristi HMAC-SHA256 za verifikaciju svakog korisničkog identiteta s FastCommentsom. Ovo je način koji želite kada imate konfiguriran API Secret, i jedini je način koji sprječava posjetitelja da se lažno predstavlja kao drugi korisnik.

Korisnički identitet se prosljeđuje FastCommentsu svaki put kad korisnik pogleda nit komentara. Ne postoji početna ili kontinuirana sinkronizacija koja treba biti pokrenuta.

(Neobavezno) Dodajte svoje administratore u Korisnici i administratori i moderatore u Moderatori komentara kako biste poboljšali njihovo iskustvo i omogućili praćenje statistike za moderatore.

Za dublji uvid u to kako SSO funkcionira, pogledajte SSO odjeljak u dokumentaciji za prilagodbe.

Dozvole Internal Link

Modul dodaje tri Drupal dopuštenja koja možete dodijeliti po ulozi pod People > Permissions.

  • Administer FastComments - Pristup obrascu postavki FastComments na /admin/config/content/fastcomments.
  • View FastComments - Potrebno za prikaz widgeta za komentiranje. Bez ovog dopuštenja widget se neće prikazati.
  • Toggle FastComments - Omogućava korisnicima uključivanje ili isključivanje komentara po entitetu koristeći widget polja.

Po zadanom, samo korisnici s dopuštenjem administer site configuration mogu mijenjati postavke FastComments. Dodijelite View FastComments anonimnim i prijavljenim korisnicima ako želite da posjetitelji vide widget.

Višejezično Internal Link

Modul automatski prosljeđuje trenutni jezik Drupal web-mjesta svakom FastComments widgetu. Ako je vaše Drupal web-mjesto konfigurirano za više jezika, sučelje za komentiranje prikazat će se na odgovarajućem jeziku bez dodatne konfiguracije.

Ovo se odnosi na sve vrste widgeta: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments i Top Pages.

Pohrana podataka u EU Internal Link

Ako je vaš FastComments račun hostan u EU, ažurirajte dvije postavke u Administration > Configuration > Content > FastComments:

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

Također dohvatite svoj Tenant ID i API Secret s EU nadzorne ploče na eu.fastcomments.com/auth/my-account/api umjesto s zadane američke nadzorne ploče. Sve ostalo u modulu funkcionira isto.

Prilagodba Internal Link

FastComments je dizajniran da se prilagodi vašoj stranici.

Ako želite dodati prilagođeni izgled ili podesiti konfiguraciju, Pogledajte našu dokumentaciju o prilagodbama i konfiguraciji da biste saznali kako.

Zahtjevi Internal Link

  • Drupal 10 ili 11
  • PHP 8.1 ili noviji
  • Račun na FastComments

Modul ne zahtijeva nikakve druge Drupal module ili biblioteke trećih strana. Ovisi samo o Drupal core (user, field).

A <noscript> fallback pruža komentare renderirane na poslužitelju za posjetitelje bez JavaScripta, pa Live Comments i Streaming Chat i dalje rade u preglednicima s onemogućenim skriptama.

Doprinesite ovom vodiču