FastComments.com
Menu Icon

Lingua 🇮🇹 Italiano
🇺🇸 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

In breve

Avvio rapido

Installazione di Drupal

Installazione
Configurazione
Blocchi widget
Campi del tipo di contenuto
Single Sign-On (SSO)
Permessi
Multilingue
Residenza dei dati nell'UE
Personalizzazione
Requisiti

Add Live Commenting to Drupal Sites

Avvio rapido Internal Link

Questa è la versione "too long; didn't read" (TL;DR) delle istruzioni per Drupal.

  1. Installa il modulo con composer require drupal/fcom, oppure mettilo in modules/custom/fastcomments/.
  2. Attivalo con drush en fastcomments, oppure dall'interfaccia di amministrazione su /admin/modules.
  3. Vai a Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Inserisci il tuo Tenant ID e API Secret da Impostazioni > API/SSO (UE).
  5. Aggiungi il campo FastComments a qualsiasi tipo di contenuto tramite Structure > Content types > [type] > Manage fields.

Il modulo è pubblicato su drupal.org/project/fcom.

Installazione Internal Link

Il modulo FastComments per Drupal sostituisce i commenti integrati di Drupal con un sistema di commenti in tempo reale e veloce. Il modulo è pubblicato su drupal.org e funziona con Drupal 10 e 11.

Ci sono due modi per installarlo.

Installazione con Composer

composer require drupal/fcom
drush en fastcomments

Installazione manuale

Scarica il modulo da drupal.org/project/fcom e posizionalo nella directory modules/custom/fastcomments/ del tuo sito. Quindi abilitalo con drush en fastcomments, oppure dall'interfaccia di amministrazione in Extend (/admin/modules).

Nota! Il modulo dipende solo dal core di Drupal (user and field). Non sono richiesti altri moduli Drupal o librerie.

Una volta abilitato il modulo, vai alla sezione Configuration per impostare il Tenant ID e l'API Secret.

Configurazione Internal Link

Tutte le impostazioni si trovano sotto Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Obbligatorio

Stile dei commenti

Scegli il widget che corrisponde a come vuoi che le persone si esprimano sul tuo sito.

  • Live Comments - Commenti threadati in tempo reale.
  • Streaming Chat - Interfaccia chat in tempo reale, adatta per eventi e dirette streaming.
  • Collab Chat - Annotazione tramite selezione del testo nell'area principale dei contenuti. I visitatori evidenziano il testo e avviano una discussione nel contesto.
  • Collab Chat + Comments - Sia collab chat che commenti standard sulla stessa pagina.

Modalità SSO

  • Nessuno - Nessuno SSO. Gli utenti commentano come ospiti o creano un account FastComments.
  • Semplice - Passa le informazioni utente di Drupal (nome, email, avatar) a FastComments senza verifica lato server.
  • Sicuro - Usa HMAC-SHA256 per verificare gli utenti Drupal con FastComments. Consigliato quando hai un API Secret configurato.

Consulta la sezione Single Sign-On (SSO) per i dettagli.

Altre impostazioni

  • CDN URL - Per impostazione predefinita https://cdn.fastcomments.com.
  • Site URL - Per impostazione predefinita https://fastcomments.com.
  • Email notifications - Invia un'email all'autore del contenuto quando viene pubblicato un nuovo commento sul suo contenuto.

Per la residenza dei dati nell'UE, consulta la sezione EU Data Residency.

Blocchi widget Internal Link

Il modulo include diversi blocchi che puoi posizionare da Structure > Block layout (/admin/structure/block).

  • FastComments Widget - Il widget principale per i commenti. Rileva automaticamente l'entità corrente. Salterà le entità che hanno già il campo FastComments associato, quindi non vedrai widget duplicati sulla stessa pagina.
  • FastComments Live Chat - Chat in streaming in tempo reale. Può essere posizionata accanto al campo dei commenti sulla stessa pagina.
  • FastComments Collab Chat - Annotazione e discussione basata sulla selezione del testo.
  • FastComments Image Chat - Annotazione basata su coordinate sulle immagini. I visitatori cliccano su un'immagine per lasciare commenti collegati a posizioni specifiche.
  • FastComments Recent Comments - Visualizza i commenti recenti sul tuo sito. Il conteggio è configurabile sul blocco.
  • FastComments Top Pages - Mostra le pagine del tuo sito con più commenti.

I blocchi incentrati sul contenuto (Live Chat, Collab Chat, Image Chat) rilevano automaticamente l'entità corrente e, nelle pagine non basate su entità, ricorrono a un identificatore basato sul percorso. Ciò significa che funzionano sulle pagine di tassonomia, sulle views e sulle rotte personalizzate senza alcuna configurazione aggiuntiva.

Campi del tipo di contenuto Internal Link

Per la maggior parte dei siti, il modo più semplice per aggiungere commenti è allegare il campo FastComments ai tipi di contenuto. Vai su Structure > Content types > [type] > Manage fields e aggiungi il campo.

Ogni entità che possiede il campo ottiene:

  • Un interruttore di stato che permette agli editor di attivare o disattivare i commenti per entità.
  • Un identificatore personalizzato opzionale, così puoi usare un ID stabile che non è legato al percorso dell'entità Drupal.

Il blocco principale FastComments Widget è a conoscenza di questo campo e salterà le entità che lo hanno già allegato. In questo modo puoi combinare commenti per entità con il blocco senza vedere il widget due volte nella stessa pagina.

Single Sign-On (SSO) Internal Link

FastComments si integra con il sistema utenti di Drupal tramite SSO, o single sign-on. I tuoi utenti effettuano l'accesso al sito Drupal, e il modulo trasmette automaticamente la loro identità a FastComments. Nessun account aggiuntivo da creare, nessuna sincronizzazione iniziale da eseguire.

Il modulo supporta tre modalità SSO, configurabili in Administration > Configuration > Content > FastComments.

Nessuno

Nessuno SSO. Gli utenti commentano come ospiti o creano un account FastComments. Usalo se il tuo sito è pubblico e non è necessario collegare i commenti agli utenti Drupal.

Semplice

Trasmette il nome, l'email e l'avatar dell'utente Drupal a FastComments senza verifica lato server. Non è necessario un API Secret. Indicato per siti interni o a basso rischio.

Sicuro (consigliato)

Utilizza HMAC-SHA256 per verificare ogni identità utente con FastComments. Questa è la modalità che vuoi quando hai configurato un API Secret, ed è l'unica modalità che impedisce a un visitatore di impersonare un altro utente.

L'identità dell'utente viene trasmessa a FastComments ogni volta che un utente visualizza un thread di commenti. Non è necessaria alcuna sincronizzazione iniziale o continua che debba essere eseguita.

(Opzionale) Aggiungi i tuoi amministratori a Utenti e amministratori e i moderatori a Moderatori dei commenti per migliorare la loro esperienza e abilitare il tracciamento delle statistiche per i moderatori.

Per un'analisi più approfondita di come funziona lo SSO, vedi la sezione SSO della documentazione sulle personalizzazioni e la configurazione.

Permessi Internal Link

Il modulo aggiunge tre permessi di Drupal che puoi assegnare per ruolo sotto People > Permissions.

  • Administer FastComments - Accesso al modulo delle impostazioni di FastComments in /admin/config/content/fastcomments.
  • View FastComments - Necessario per vedere il widget dei commenti. Senza questo permesso il widget non viene visualizzato.
  • Toggle FastComments - Permette agli utenti di abilitare o disabilitare i commenti a livello di singola entità usando il widget del campo.

Per impostazione predefinita, solo gli utenti con il permesso administer site configuration possono modificare le impostazioni di FastComments. Concedi View FastComments agli utenti anonimi e autenticati se vuoi che i visitatori vedano il widget.

Multilingue Internal Link

Il modulo passa automaticamente la lingua corrente del sito Drupal a ogni widget FastComments. Se il tuo sito Drupal è configurato per più lingue, l'interfaccia dei commenti verrà visualizzata nella lingua corrispondente senza alcuna configurazione aggiuntiva.

Questo vale per tutti i tipi di widget: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, e Top Pages.

Residenza dei dati nell'UE Internal Link

Se il tuo account FastComments è ospitato nell'UE, aggiorna due impostazioni in Administration > Configuration > Content > FastComments:

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

Dovrai inoltre prelevare il tuo Tenant ID e il tuo API Secret dalla dashboard UE su eu.fastcomments.com/auth/my-account/api invece della dashboard predefinita degli Stati Uniti. Il resto del modulo funziona allo stesso modo.

Personalizzazione Internal Link

FastComments è progettato per essere personalizzato in modo da adattarsi al tuo sito.

Se desideri aggiungere stili personalizzati o modificare la configurazione, Consulta la nostra documentazione sulle personalizzazioni per scoprire come.

Requisiti Internal Link

  • Drupal 10 o 11
  • PHP 8.1 o più recente
  • Un account FastComments

Il modulo non richiede altri moduli di Drupal o librerie di terze parti. Dipende solo dal core di Drupal (user, field).

Un fallback <noscript> fornisce commenti renderizzati dal server per i visitatori senza JavaScript, così Live Comments e Streaming Chat funzionano ancora sui browser con scripting disabilitato.

Contribuisci a questa guida