FastComments.com
Menu Icon

Jezik 🇷🇸 Srpski (Latinica)
🇺🇸 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
Rezidencija podataka u EU
Prilagođavanje
Zahtevi

Ankete

Dodajte ankete na vaš Drupal sajt

Dodajte live komentarisanje na Drupal sajtove

Brzi početak Internal Link

Ovo je verzija "predugo, nisam čitao" Drupal uputstava.

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

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

Instalacija Internal Link

FastComments Drupal modul zamenjuje ugrađene komentare Drupala brzim sistemom za komentarisanje u realnom vremenu. Modul je objavljen na drupal.org i radi sa Drupalom 10 i 11.

Postoje dva načina za instalaciju.

Instalacija pomoću Composera

composer require drupal/fcom
drush en fastcomments

Ručna instalacija

Preuzmite modul sa drupal.org/project/fcom i postavite ga u direktorijum vašeg sajta modules/custom/fastcomments/. Zatim ga omogućite pomoću drush en fastcomments, ili iz administratorskog interfejsa pod Extend (/admin/modules).

Napomena! Modul zavisi samo od Drupal core-a (user i field). Nisu potrebni drugi Drupal moduli ili biblioteke.

Kada je modul omogućen, idite na odeljak Configuration da podesite vaš Tenant ID i API Secret.

Konfiguracija Internal Link

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

Obavezno

  • Tenant ID - Vaš FastComments Tenant ID. Pronađite ga pod Settings > API/SSO (EU).
  • API Secret - Obavezno za Secure SSO, verifikaciju webhook-ova i sinhronizaciju stranica. Nalazi se pod Settings > API/SSO (EU).

Čuvanje API Secret-a

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

  1. Key modul - Instalirajte Key, napravite Authentication ključ i izaberite ga pod API Secret key na formi za podešavanja. Ključ može biti podržan promenljivom okruženja ili fajlom van web root-a.
  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. Forma za podešavanja - Unesite je u polje API Secret. Ovo čuva vrednost u fastcomments.settings, tako da završava u izvozima konfiguracije. Drupal izveštaj o statusu upozorava kada je ovo aktivan izvor.

Forma prikazuje koji je izvor aktivan. Ako ostavite polje prazno, sačuvana tajna ostaje. Štiklirajte Remove the API Secret stored in configuration da biste je obrisali nakon premeštanja tajne u Key modul ili settings.php.

Stil komentara

Izaberite vidžet koji odgovara načinu na koji želite da ljudi komuniciraju na vašem sajtu.

  • Live Comments - Komentari u granama u realnom vremenu.
  • Streaming Chat - Interfejs za live chat, dobar za događaje i prenose uživo.
  • Collab Chat - Anotacija izbora teksta na glavnom području sadržaja. Posetioci istaknu tekst i započnu diskusiju u kontekstu.
  • Collab Chat + Comments - I collab chat i standardni komentari na istoj stranici.

SSO režim

  • None - Bez SSO-a. Korisnici komentarišu kao gosti ili naprave FastComments nalog.
  • Simple - Prosleđuje informacije o Drupal korisniku (ime, email, avatar) FastComments-u bez server-side verifikacije.
  • Secure - Koristi HMAC-SHA256 za verifikaciju Drupal korisnika sa FastComments-om. Preporučuje se kada imate konfigurisan API Secret.

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

Ostala podešavanja

  • CDN URL - Podrazumevano https://cdn.fastcomments.com.
  • Site URL - Podrazumevano https://fastcomments.com.
  • Email obaveštenja - Šalje email autoru sadržaja kada se objavi novi komentar na njegovom sadržaju.

Za EU data residency, pogledajte odeljak EU Data Residency.

Widget blokovi Internal Link

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

  • FastComments Widget - Glavni vidžet za komentare. Automatski detektuje trenutni entitet. Preskače entitete koji već imaju pridruženo FastComments polje, tako da nećete videti duplirane vidžete na istoj stranici.
  • FastComments Live Chat - Chat sa strimovanjem u realnom vremenu. Može se postaviti uz polje za komentare na istoj stranici.
  • FastComments Collab Chat - Anotacija i diskusija na osnovu izabranog teksta.
  • FastComments Image Chat - Anotacija na slikama zasnovana na koordinatama. Posetioci klikću na sliku da ostave komentare vezane za određene lokacije.
  • FastComments Recent Comments - Prikazuje nedavne komentare sa celog sajta. Broj je konfigurabilan na bloku.
  • FastComments Top Pages - Prikazuje stranice na vašem sajtu sa najviše komentara.

Blokovi fokusirani na sadržaj (Live Chat, Collab Chat, Image Chat) automatski detektuju trenutni entitet, a na stranicama koje nisu entiteti koriste identifikator zasnovan na putanji. To znači da rade na taksonomskim stranicama, view-ovima i prilagođenim rutama bez dodatnog podešavanja.

Polja tipa sadržaja Internal Link

Za većinu sajtova, najlakši način da dodate komentare je da pripojite polje FastComments vašim tipovima sadržaja. Idite na Structure > Content types > [type] > Manage fields i dodajte polje.

Svaki entitet koji ima polje dobija:

  • prekidač statusa koji omogućava urednicima da uključe ili isključe komentare za svaki entitet.
  • Opcionalan prilagođeni identifikator tako da možete koristiti stabilan ID koji nije vezan za Drupal putanju entiteta.

Glavni blok FastComments Widget prepoznaje ovo polje i preskočiće entitete koji ga već imaju priloženog. Na taj način možete kombinovati komentare po entitetu sa blokom bez da vidite vidžet dva puta na istoj stranici.

Jedinstvena prijava (SSO) Internal Link

FastComments se integriše sa Drupal-ovim korisničkim sistemom putem SSO (single-sign-on). Vaši korisnici se prijavljuju na vaš Drupal sajt, i modul automatski prosleđuje njihov identitet FastComments-u. Nema dodatnih naloga za kreiranje, nema početne sinhronizacije za pokretanje.

Modul podržava tri SSO moda, podešena pod Administration > Configuration > Content > FastComments.

Nema

Nema SSO. Korisnici komentarišu kao gosti ili kreiraju FastComments nalog. Koristite ovo ako je vaš sajt javan i ne treba vam vezivanje komentara za Drupal korisnike.

Jednostavno

Prosleđuje Drupal korisnikovo ime, email i avatar FastComments-u bez verifikacije na serverskoj strani. Nije potreban API Secret. Pogodno za interne ili niskorizične sajtove.

Sigurno (preporučeno)

Koristi HMAC-SHA256 da verifikuje svaki korisnički identitet sa FastComments-om. Ovo je režim koji želite kada imate konfigurisani API Secret, i jedini režim koji sprečava posetioca da se lažno predstavlja kao drugi korisnik.

Identitet korisnika se prosleđuje FastComments-u svaki put kada korisnik pregleda nit komentara. Ne postoji inicijalna ili kontinuirana sinhronizacija koja treba da se pokreće.

(Opcionalno) 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 detaljniji prikaz kako SSO funkcioniše, pogledajte SSO odeljak dokumentacije o prilagođavanjima i konfiguraciji.

Dozvole Internal Link

Modul dodaje tri Drupal dozvole koje možete dodeliti po ulozi pod People > Permissions.

  • Upravljaj FastComments - Pristup formi za podešavanja FastComments na /admin/config/content/fastcomments.
  • Pregled FastComments - Potrebno da bi se video vidžet za komentare. Bez ove dozvole vidžet se ne prikazuje.
  • Uključivanje/isključivanje FastComments - Omogućava korisnicima da omoguće ili onemoguće komentare po entitetu koristeći field widget.

Po difoltu, samo korisnici sa administer site configuration dozvolom mogu da menjaju FastComments podešavanja. Dodelite View FastComments anonimnim i prijavljenim korisnicima ako želite da posetioci vide vidžet.

Višejezičnost Internal Link

Modul automatski prosleđuje trenutni jezik Drupal sajta svakom FastComments widgetu. Ako je vaš Drupal sajt podešen za više jezika, korisnički interfejs za komentarisanje će se prikazati na odgovarajućem jeziku bez dodatne konfiguracije.

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

Rezidencija podataka u EU Internal Link

Ako je vaš FastComments nalog hostovan u EU, ažurirajte dve postavke u Administration > Configuration > Content > FastComments:

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

Takođe ćete želeti da preuzmete svoj Tenant ID i API Secret sa EU kontrolnog panela na eu.fastcomments.com/auth/my-account/api umesto sa podrazumevanog US kontrolnog panela. Sve ostalo u modulu radi na isti način.

Prilagođavanje Internal Link

FastComments je dizajniran da se prilagodi vašem sajtu.

Ako želite da dodate prilagođeni stil ili podesite konfiguraciju, Pogledajte našu dokumentaciju o prilagođavanju da saznate kako.

Zahtevi Internal Link

  • Drupal 10 ili 11
  • PHP 8.1 ili noviji
  • FastComments nalog (FastComments)

Modul ne zahteva nikakve druge Drupal module ili biblioteke trećih strana. On zavisi samo od jezgra Drupala (user, field).

Fallback u <noscript> pruža server-renderovane komentare za posetioce bez JavaScripta, tako da Live Comments i Streaming Chat i dalje rade na pregledačima sa onemogućenim skriptovanjem.

Dodajte ankete na vaš Drupal sajt Internal Link

Kada je FastComments instaliran na vaš Drupal sajt, možete takođe pokretati ankete uživo direktno u komentarima. Uključite Enable Polls u podešavanjima prilagođavanja widgeta i dugme ankete će se pojaviti u alatnoj traci komentara. Ankete mogu imati od 2 do 10 opcija, rezultati se ažuriraju uživo za sve na stranici, a vi birate ko može kreirati ankete i da li glasanje zahteva prijavu. Nema ništa drugo što treba instalirati na Drupal.

Isprobajte demo uživo anketa ili pročitajte Dokumentacija o anketama da ih postavite.

Doprinesite ovom vodiču