
Lingua 🇮🇹 Italiano
Primi passi
Configurazione
Documentazione
Add Comments to Your Drupal Site
Questo è il modulo ufficiale di FastComments per Drupal.
Un modulo per Drupal che integra FastComments con Drupal 10/11, fornendo blocchi widget, integrazione dei campi delle entità, SSO e permessi granulati.
Repository
Installazione 
- Posiziona questo modulo nella directory del tuo sito Drupal
modules/custom/fastcomments/(o installalo tramite Composer:composer require drupal/fcom). - Abilita il modulo:
Oppure abilitalo tramite l'interfaccia di amministrazione in Extend (drush en fastcomments/admin/modules).
Configurazione 
Vai a Amministrazione > Configurazione > Contenuto > FastComments (/admin/config/content/fastcomments).
Impostazioni
- Tenant ID (obbligatorio) - Il tuo Tenant ID di FastComments. Trovalo in Impostazioni > API/SSO (UE).
- API Secret - Richiesto per Secure SSO, la verifica dei webhook e la sincronizzazione delle pagine. Si trova in Impostazioni > API/SSO (UE).
- Modalità SSO - Integrazione Single Sign-On:
- Nessuna - Nessuno SSO, gli utenti commentano come ospiti o creano account FastComments.
- Semplice - Trasmette le informazioni utente di Drupal (nome, email, avatar) a FastComments senza verifica lato server.
- Sicura - Usa la verifica HMAC-SHA256 per autenticare in modo sicuro gli utenti Drupal con FastComments (consigliato).
- Stile dei commenti - Il tipo di widget da visualizzare:
- Live Comments - Commenti annidati in tempo reale.
- Streaming Chat - Interfaccia di chat in diretta.
- Collab Chat - Annotazione collaborativa tramite selezione del testo sull'area principale del contenuto.
- Collab Chat + Comments - Sia collab chat che commenti standard.
- URL CDN - URL CDN di FastComments (predefinito:
https://cdn.fastcomments.com). - URL del sito - URL del sito FastComments (predefinito:
https://fastcomments.com). - Notifiche email - Invia un'email agli autori del contenuto quando viene pubblicato un nuovo commento sul loro contenuto.
Aggiungere commenti ai tipi di contenuto
Aggiungi il campo FastComments ai tuoi tipi di contenuto tramite Struttura > Tipi di contenuto > [type] > Gestisci campi. Il campo ha un interruttore di stato e un identificatore personalizzato opzionale per ogni entità.
Residenza dei dati UE
Per la residenza dei dati nell'UE, aggiorna:
- URL CDN a
https://cdn-eu.fastcomments.com - URL del sito a
https://eu.fastcomments.com
Blocchi widget 
Sono disponibili diversi blocchi tramite Struttura > Layout blocchi (/admin/structure/block):
- FastComments Widget - Il widget principale per i commenti. Rileva automaticamente l'entità corrente. Salta le entità che hanno già il campo FastComments (per evitare duplicati).
- FastComments Live Chat - Chat in streaming in tempo reale. Può essere posizionata accanto al campo commenti sulla stessa pagina.
- FastComments Collab Chat - Annotazione e discussione tramite selezione del testo.
- FastComments Image Chat - Annotazione basata su coordinate sulle immagini.
- FastComments Recent Comments - Mostra i commenti recenti in tutto il sito. Numero di commenti configurabile.
- FastComments Top Pages - Mostra le pagine con più commenti.
I blocchi incentrati sui contenuti (Live Chat, Collab Chat, Image Chat) rilevano automaticamente l'entità corrente e, nelle pagine che non sono entità, ricorrono a un identificatore basato sul percorso.
Permessi 
- Amministrare FastComments - Accesso al modulo delle impostazioni di FastComments.
- Visualizzare FastComments - Richiesto per visualizzare il widget dei commenti.
- Attivare/Disattivare FastComments - Consente agli utenti di abilitare/disabilitare i commenti per ogni entità tramite il widget del campo.
Come funziona 
Quando un utente visita un'entità con il campo FastComments abilitato:
- Il widget JavaScript di FastComments viene caricato dal CDN.
- Se SSO è configurato, l'identità Drupal dell'utente viene passata a FastComments.
- Un fallback
<noscript>fornisce commenti renderizzati dal server per gli utenti senza JavaScript (solo nelle modalità Live Comments e Streaming Chat).
Hai bisogno di aiuto?
Se riscontri problemi o hai domande sul modulo Drupal, per favore:
Contribuire
I contributi sono benvenuti! Visita il repository GitHub per le linee guida per i contributi.