FastComments.com
Menu Icon

Jezik 🇷🇸 Srpski (Latinica)
🇺🇸 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
Widget blokovi
Polja tipa sadržaja
Jedinstvena prijava (SSO)
Dozvole
Višejezičnost
Čuvanje podataka u EU
Prilagođavanje
Zahtevi

Add Live Commenting to Drupal Sites

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 u 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 - Potrebno za Secure SSO, verifikaciju webhook-ova i sinhronizaciju stranica. Nalazi se pod Settings > API/SSO (EU).

Stil komentarisanja

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

  • Live Comments - Komentari sa nitima u realnom vremenu.
  • Streaming Chat - Interfejs za chat uživo, dobar za događaje i livestream-ove.
  • Collab Chat - Annotacija selektovanog teksta u glavnom sadržaju. Posetioci označe tekst i započnu diskusiju u kontekstu.
  • Collab Chat + Comments - I collab chat i standardni komentari na istoj stranici.

SSO Mode

  • None - Nema SSO. Korisnici komentarišu kao gosti ili kreiraju FastComments nalog.
  • Simple - Prosleđuje Drupal korisničke podatke (ime, email, avatar) FastComments bez verifikacije na serverskoj strani.
  • Secure - Koristi HMAC-SHA256 za verifikaciju Drupal korisnika sa FastComments. Preporučeno kada imate konfigurisani API Secret.

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

Ostala podešavanja

  • CDN URL - Podrazumevano je https://cdn.fastcomments.com.
  • Site URL - Podrazumevano je https://fastcomments.com.
  • Email notifications - Pošaljite email autoru sadržaja kada je novi komentar postavljen na njihov sadržaj.

Za EU rezidenciju podataka, pogledajte odeljak EU Data Residency.

Widget blokovi Internal Link

The module ships several blocks you can place from Structure > Block layout (/admin/structure/block).

  • FastComments Widget - Glavni widget za komentare. Automatski detektuje trenutni entity. Preskočiće entitete koji već imaju pridružen FastComments field, tako da nećete videti duplirane widget-e na istoj stranici.
  • FastComments Live Chat - Chat koji radi u realnom vremenu. Može se postaviti pored comment field na istoj stranici.
  • FastComments Collab Chat - Anotacija i diskusija na izabranom tekstu.
  • FastComments Image Chat - Anotacije zasnovane na koordinatama na slikama. Posetioci kliknu na sliku da ostave komentare vezane za određene lokacije.
  • FastComments Recent Comments - Prikazuje najnovije komentare širom vašeg sajta. Broj je konfigurabilan na bloku.
  • FastComments Top Pages - Prikazuje stranice na vašem sajtu sa najviše komentara.

The content-centric blocks (Live Chat, Collab Chat, Image Chat) auto-detect the current entity, and fall back to a path-based identifier on non-entity pages. That means they work on taxonomy pages, views, and custom routes without any extra setup.

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.

Čuvanje 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.

Doprinesite ovom vodiču