
Jezik 🇸🇮 Slovenščina
Uvod
Konfiguracija
Dokumentacija
Add Comments to Your Drupal Site
To je uradni Drupal modul za FastComments.
Drupal modul, ki integrira FastComments z Drupalom 10/11 ter zagotavlja bloke pripomočkov, integracijo polj entitet, SSO in natančna dovoljenja.
Repozitorij
Namestitev 
- Postavite ta modul v imenik vaše Drupal strani
modules/custom/fastcomments/(ali namestite prek Composerja:composer require drupal/fcom). - Omogočite modul:
Ali omogočite prek skrbniškega vmesnika na Razširitve (drush en fastcomments/admin/modules).
Konfiguracija 
Pojdite v Administracija > Konfiguracija > Vsebina > FastComments (/admin/config/content/fastcomments).
Nastavitve
- Tenant ID (required) - Vaš FastComments Tenant ID. Najdete to pod Nastavitve > API/SSO (EU).
- API Secret - Zahtevano za Secure SSO, preverjanje webhookov in sinhronizacijo strani. Najdete ga pod Nastavitve > API/SSO (EU).
- SSO Mode - Integracija Enotne prijave (Single Sign-On):
- None - Brez SSO, uporabniki komentirajo kot gostje ali ustvarijo FastComments račune.
- Simple - Posreduje podatke Drupal uporabnika (ime, e-pošta, avatar) v FastComments brez preverjanja na strežniku.
- Secure - Uporablja HMAC-SHA256 preverjanje za varno overjanje Drupal uporabnikov pri FastComments (priporočeno).
- Commenting Style - Vrsta vtičnika za prikaz:
- Live Comments - V realnem času medsebojno povezani komentarji.
- Streaming Chat - Vmesnik za klepet v živo.
- Collab Chat - Sodelovalno označevanje besedila na glavni vsebini.
- Collab Chat + Comments - Tako sodelovalni klepet kot standardni komentarji.
- CDN URL - FastComments CDN URL (privzeto:
https://cdn.fastcomments.com). - Site URL - FastComments site URL (privzeto:
https://fastcomments.com). - Email notifications - Pošlji e-pošto avtorjem vsebine, ko je na njihovi vsebini objavljen nov komentar.
Dodajanje komentarjev k tipom vsebine
Dodajte polje FastComments k vašim tipom vsebine preko Struktura > Tipi vsebine > [type] > Uredi polja. Polje ima stikalo za status in neobvezni prilagojen identifikator za vsako entiteto.
Rezidenca podatkov v EU
Za rezidenco podatkov v EU posodobite:
- CDN URL na
https://cdn-eu.fastcomments.com - Site URL na
https://eu.fastcomments.com
Bloki gradnikov 
Na voljo je več blokov v Struktura > Razporeditev blokov (/admin/structure/block):
- FastComments Widget - Glavni pripomoček za komentiranje. Samodejno zazna trenutno entiteto. Preskoči entitete, ki že imajo FastComments field (da se prepreči podvajanje).
- FastComments Live Chat - Čat v realnem času s pretakanjem. Lahko se postavi ob polje za komentarje na isti strani.
- FastComments Collab Chat - Oznake besedila z anotacijami in razprava.
- FastComments Image Chat - Anotacije na slikah, osnovane na koordinatah.
- FastComments Recent Comments - Prikaže nedavne komentarje po celotnem spletnem mestu. Nastavljivo število komentarjev.
- FastComments Top Pages - Prikaže strani z največ komentarji.
Vsebinski bloki (Live Chat, Collab Chat, Image Chat) samodejno zaznajo trenutno entiteto in se na ne-entitetnih straneh zatekajo k identifikatorju, temelječem na poti.
Dovoljenja 
- Administer FastComments - Dostop do obrazca z nastavitvami FastComments.
- View FastComments - Potrebno za ogled pripomočka za komentiranje.
- Toggle FastComments - Uporabnikom omogoča vklop ali izklop komentarjev za posamezno entiteto prek pripomočka polja.
Kako deluje 
Ko uporabnik obišče entiteto s omogočenim poljem FastComments:
- JavaScript gradnik FastComments se naloži iz CDN.
- Če je SSO konfiguriran, se uporabnikova Drupal identiteta posreduje FastComments.
- Nadomestek
<noscript>zagotavlja komentarje, upodobljene na strežniku, za uporabnike brez JavaScripta (samo v načinih Live Comments in Streaming Chat).
Potrebujete pomoč?
Če naletite na težave ali imate vprašanja glede modula za Drupal, prosimo:
Prispevanje
Prispevki so dobrodošli! Prosimo, obiščite GitHub repozitorij za smernice glede prispevkov.