FastComments.com
Menu Icon

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

TLDR

Brzi početak

Instalacija Drupala

Instalacija
Konfiguracija
Widget blokovi
Polja tipa sadržaja
Jedinstvena prijava (SSO)
Dozvole
Višejezičnost
Smještaj podataka u EU
Prilagodba
Zahtjevi

Ankete

Dodajte ankete na svoju Drupal stranicu

Dodajte komentiranje uživo na Drupal stranice

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

All settings live under 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 webhooka i sinkronizaciju stranice. Pronađite ga pod Postavke > API/SSO (EU).

Pohranjivanje API tajne

Modul čita API Secret iz prvog od ovih izvora koji ima vrijednost:

  1. Key module - Instalirajte Key, kreirajte Authentication ključ i odaberite ga pod API Secret key u obrascu za postavke. Ključ može biti podržan varijablom okruženja ili datotekom izvan web korijena.
  2. settings.php - Dodajte $config['fastcomments.settings']['api_secret'] = 'your-secret'; u settings.php ili settings.local.php. Tajna nikada ne ulazi u izvezenu konfiguraciju.
  3. Obrazac za postavke - Unesite je u polje API Secret. Ovo pohranjuje vrijednost u fastcomments.settings, pa se ona nalazi u izvozima konfiguracije. Drupal izvještaj o statusu upozorava kada je ovo aktivni izvor.

Obrazac prikazuje koji je izvor aktivan. Ostavite polje prazno da zadržite pohranjenu tajnu. Tick Remove the API Secret stored in configuration to delete it after moving the secret to the Key module or settings.php.

Stil komentiranja

Odaberite widget koji odgovara načinu na koji želite da ljudi razgovaraju na vašoj stranici.

  • Live Comments - Komentari u stvarnom vremenu s grananjem.
  • Streaming Chat - Sučelje za live chat, pogodno za događaje i prijenose uživo.
  • Collab Chat - Anotacija odabira teksta u glavnom području sadržaja. Posjetitelji ističu tekst i započinju raspravu u kontekstu.
  • Collab Chat + Comments - I collab chat i standardni komentari na istoj stranici.

SSO način

  • None - Nema SSO. Korisnici komentiraju kao gosti ili kreiraju FastComments račun.
  • Simple - Prosljeđuje informacije o Drupal korisniku (ime, email, avatar) FastCommentsu bez provjere na poslužitelju.
  • Secure - Koristi HMAC‑SHA256 za provjeru Drupal korisnika s FastCommentsom. Preporučeno kada imate konfiguriranu API Secret.

Pogledajte odjeljak Single Sign-On (SSO) za detalje.

Ostale postavke

  • CDN URL - Zadano je https://cdn.fastcomments.com.
  • Site URL - Zadano je https://fastcomments.com.
  • Email notifications - Pošaljite email autoru sadržaja kada se na njegovom sadržaju objavi novi komentar.

Za EU rezidenciju podataka, pogledajte odjeljak EU Data Residency.

Widget blokovi 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čnost 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.

Smještaj 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.

Dodajte ankete na svoju Drupal stranicu Internal Link

Jednom kada je FastComments na vašem Drupal siteu, možete također pokrenuti live ankete izravno u komentarima. Uključite Enable Polls u postavkama prilagodbe widgeta i gumb ankete pojavljuje se u alatnoj traci komentara. Ankete podržavaju od 2 do 10 opcija, rezultati se ažuriraju uživo za sve na stranici, a vi odabirete tko može stvarati ankete i zahtijeva li glasanje prijavu. Nema ništa drugo za instalirati na Drupal.

Isprobajte demo Live anketa ili pročitajte Dokumentaciju anketa da ih postavite.

Doprinesite ovom vodiču