Personalizzazioni e configurazione

Potresti notare che il widget dei commenti può essere utilizzato con un Tenant ID di "demo", ad esempio:

Demo Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo"

7}];

8</script>

9

Questo serve solo per provare e giocare con il widget dei commenti. In produzione, dovresti fornire il tuo Tenant ID, in questo modo:

Defining Your Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "aKa2Z4Q="

7}];

8</script>

9

Il tuo Tenant ID può essere trovato già applicato nello snippet di codice del widget dei commenti nel tuo account.

Puoi anche trovare il tuo Tenant ID e gestire le tue chiavi API nella pagina delle credenziali API.

Da questo momento in poi, se sei connesso a FastComments, gli esempi di codice utilizzeranno il tuo Tenant ID reale (se hai effettuato l'accesso su https://fastcomments.com).

Durante il rendering di una discussione di commenti, o lasciando un commento, FastComments deve sapere a quale pagina, articolo o prodotto appartengono quei commenti.

Per fare ciò, utilizziamo qualcosa che chiamiamo "URL ID". È un identificatore, come una stringa o un numero, oppure un URL.

Per impostazione predefinita, se non specifichi l'urlId, verrà utilizzato l'URL della pagina. Prenderemo l'URL della pagina corrente e lo puliremo per rimuovere eventuali parametri di marketing comuni o identificatori di tracciamento.

Nel caso di integrazioni di terze parti, come WordPress, il nostro plugin utilizzerà solitamente l'identificatore che rappresenta le informazioni attualmente visualizzate come URL ID, ad esempio l'ID dell'articolo/pagina.

Definire un URL ID personalizzato

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "urlId": "https://example.com/page"

8}];

9</script>

10

Una cosa a cui faremo spesso riferimento in questo documento è l'Interfaccia di personalizzazione del widget.

Questa interfaccia può essere utilizzata per apportare molte modifiche al widget dei commenti senza usare codice.

Quando si crea una regola di personalizzazione, spesso vogliamo che si applichi a tutte le pagine del nostro sito. Tuttavia, in alcuni casi desideriamo personalizzare il widget dei commenti su una pagina specifica, ad esempio per applicare uno stile personalizzato o per rendere i commenti di quella pagina anonimi. Si potrebbe anche, per esempio, far apparire i commenti in tempo reale subito su alcune pagine, nascondendoli sotto pulsanti di notifica su altre.

Tutto ciò è possibile tramite il campo di input URL ID su questa pagina, che appare come segue:

Input URL ID nella pagina di personalizzazione del widget

Il valore in questo campo dovrebbe corrispondere al parametro urlId passato al widget dei commenti. Se desideri che la tua regola di personalizzazione sia indipendente da urlId, lascia questo campo vuoto o inserisci *.

A partire dal 2023 il campo URL ID nella personalizzazione del widget accetta anche i modelli! Ad esempio potresti avere */blog/* per aggiungere uno stile specifico al tuo blog e */store/* per avere uno stile specifico al tuo negozio, il tutto usando lo stesso dominio.

Problemi comuni

1. Se la tua pagina ha parametri hash (come example.com#page-1) - questo diventerà parte dell'URL ID, per impostazione predefinita.
2. Durante le migrazioni, ad esempio da WordPress a Gatsby, potresti dover migrare i valori dei commenti URL ID dopo la migrazione iniziale. Per questo, contattaci.

FastComments è progettato per essere personalizzato. Il widget dei commenti stesso gira all'interno di un iframe per motivi di sicurezza, quindi per applicare uno stile personalizzato devi seguire una delle due modalità.

Il primo, il più semplice, e il nostro preferito, è utilizzare la pagina di personalizzazione del widget.

Nella pagina di personalizzazione del widget, vedi la sezione "Mostra opzioni avanzate", sotto la quale c'è un'area etichettata "CSS personalizzato":

Area di input CSS personalizzato

Questo approccio ha alcuni vantaggi:

1. Il CSS inserito viene minificato prima di essere inviato all'utente, e la formattazione viene mantenuta coerente nell'interfaccia di modifica.
2. Ottieni tutti i vantaggi dell'interfaccia di personalizzazione del widget, ad esempio personalizzando facilmente il widget dei commenti in modo diverso per siti diversi.
3. Quando apportiamo modifiche al widget dei commenti, il tuo stile personalizzato verrà testato come parte del nostro processo di rilascio.

Il secondo approccio è specificare il parametro customCSS nella configurazione del widget, come segue:

Passare CSS personalizzato

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "button { background: red; }"

8}];

9</script>

10

Tuttavia, questo ha limiti:

1. C'è un limite a quanta CSS personalizzata può essere passata prima che i nostri server rifiutino la richiesta, a causa della dimensione delle intestazioni.
2. Devi gestire il CSS personalizzato nella tua infrastruttura e nel sistema di build. Questo può anche essere un vantaggio piuttosto che uno svantaggio.
3. C'è un overhead aggiuntivo nell'inviare il CSS personalizzato sulla rete due volte in questo caso d'uso, poiché deve essere inviato ai nostri server e poi restituito nel contenuto dell'iframe. Tuttavia, per la maggior parte delle dimensioni del payload, ciò non è percepibile.
4. Una comune ottimizzazione è minificare il CSS per ridurne le dimensioni sulla rete, ma con questo approccio dovrai gestirlo tu.
5. Il tuo CSS personalizzato non verrà testato quando apportiamo modifiche.

File CSS esterni

Puoi far sì che il widget recuperi un file esterno usando @import!

È consigliato inserire il @import in una regola di personalizzazione. In questo modo, se dovessimo mai dover modificare il widget dei commenti, possiamo utilizzare i nostri strumenti di automazione per verificare la tua configurazione. Quindi, ad esempio, creeresti una regola di personalizzazione nell'interfaccia di personalizzazione del widget, cliccheresti su Avanzate e inseriresti nel CSS personalizzato:

@import url(https://example.com/styles.css);

In codice - non consigliato

Puoi anche caricare un file CSS esterno tramite la proprietà customCSS:

File CSS esterno

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

Tuttavia, ricorda che il tuo CSS non potrà essere testato da noi se lo fai in questo modo.

Stile del modal del profilo utente

I modal del profilo utente possono anche essere stilizzati con CSS personalizzato. Tuttavia, per garantire che lo stile personalizzato venga applicato ai profili utente, tutti i selettori CSS devono essere prefissati con .user-profile. Senza questo prefisso, lo stile personalizzato verrà ignorato per i modal del profilo utente.

Ad esempio:

CSS profilo utente

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

Compatibilità retroattiva

In FastComments, sappiamo che i nostri clienti personalizzano il widget dei commenti. È così progettato - l'ultima cosa che vogliamo è che il nostro prodotto causi incoerenze di design nel tuo prodotto.

Poiché è una parte importante del nostro prodotto, disponiamo di una pipeline di build che ci consente di revisionare le modifiche al widget dei commenti, per cliente, ad ogni rilascio.

Se troviamo problemi minori, aggiorneremo il tuo account per garantire che il nostro rilascio proceda senza intoppi. Se vediamo cambiamenti importanti che interrompono il funzionamento, questo ci permette di fermare il rilascio.

Per i clienti con account Pro o Enterprise, è consentita la personalizzazione del marchio (white-label). Semplicemente contattaci e saremo felici di aiutarti.

Se desideri semplicemente rimuovere il nostro logo dal widget dei commenti, questa opzione è abilitata automaticamente nei piani Flex e Pro.

Questi piani forniscono inoltre la stessa funzionalità per le email inviate dalla nostra piattaforma.

Per i siti che consentono di attivare/disattivare la modalità scura dopo il caricamento iniziale della pagina, questo è un po' più complesso.

Innanzitutto, tutte le versioni correnti della libreria del widget Comment (React, Vue) contengono esempi di attivazione/disattivazione della modalità scura nei rispettivi repository.

Per il widget VanillaJS, dovremo fare un po' più di lavoro. Innanzitutto, FastCommentsUI restituisce un oggetto con le funzioni "destroy" e "update".

Possiamo semplicemente chiamare la funzione update ogni volta che vogliamo aggiornare la configurazione del widget dei commenti, come segue. Ecco un esempio completo e funzionante di attivazione/disattivazione della modalità scura con il widget VanillaJS.

Esempio completo di attivazione e disattivazione della modalità scura

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

Con FastComments, tutto il testo nel widget dei commenti è personalizzabile.

Puoi sovrascrivere un singolo pezzo di testo, come il pulsante di invio, o tutto il testo nell'intero widget dei commenti.

Per impostazione predefinita, il testo nel widget dei commenti è tradotto in base alla lingua dell'utente. Tuttavia, possiamo sovrascrivere il testo, se siamo certi che la nostra base di utenti utilizza la stessa locale/lingua, ad esempio:

Testo personalizzato

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

Tutte le traduzioni personalizzabili possono essere trovate qui under the "opzioni avanzate" tab.

Tuttavia, c'è un modo più semplice, tramite l'interfaccia di personalizzazione del widget. Lì, possiamo semplicemente trovare il testo che appare nel widget dei commenti nella locale EN_US, e specificare una sostituzione.

Testo personalizzato

Tutte le sovrascritture delle traduzioni attualmente influenzano tutte le localizzazioni.

Quando un utente commenta con FastComments per la prima volta, proveremo a recuperare il suo avatar da https://gravatar.com/.

Tuttavia, se non troviamo un avatar, o l'utente non ne imposta mai uno nel suo account, mostriamo un'immagine avatar predefinita statica.

Per specificare la tua immagine avatar statica, puoi usare l'impostazione defaultAvatarSrc.

Sostituisci l'Avatar Predefinito

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedi la sezione "Avatar Predefinito".

Personalizzare l'Avatar Predefinito

Nota che la definizione dell'avatar per un utente specifico, ad esempio con SSO, è trattata nella sua propria sezione.

Gli avatar possono essere rimossi completamente dal widget dei commenti, anche se gli utenti hanno definito il proprio avatar.

Hiding Avatars

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Nascondere gli Avatar

Per progetti di personalizzazione dello stile più ampi, potrebbe essere desiderabile partire da zero e non utilizzare affatto lo stile predefinito.

Tutto lo stile predefinito può essere rimosso impostando il parametro noStyles su true, come segue:

Disabling All Default Styles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget, sotto Opzioni Avanzate:

Disabilitare tutti gli stili predefiniti

Per impostazione predefinita, le risposte ai commenti di livello superiore vengono visualizzate.

Questo può essere configurato in modo che l'utente debba fare clic su "Show Replies" sui commenti di livello superiore per vedere le risposte.

Comprimi le risposte ai commenti di livello superiore

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Comprimi le risposte

Questa impostazione non influenzerà il numero di commenti di livello superiore caricati inizialmente. Se hai un commento di livello superiore e 29 risposte, con questa impostazione attiva otterrai:

• Vedi il commento di livello superiore.
• Vedi Show Replies (29) sotto questo commento.

Se desideri mostrare tutti i commenti di livello superiore in combinazione con questa opzione, imposta pagina iniziale a -1.

Per impostazione predefinita, le funzionalità di formattazione in FastComments vengono eseguite aggiungendo tag di ancoraggio visibili come <b></b> intorno al tuo testo. Cliccare sulla barra degli strumenti o utilizzare le scorciatoie lo fa per te. Tuttavia, alcune community potrebbero voler optare per la formattazione senza tag di ancoraggio. Questo è chiamato abilitare l'editor WYSIWYG (what you see is what you get). Questo editor appare esattamente come quello predefinito, ma carica del codice aggiuntivo che consente agli utenti di rendere il testo in grassetto, sottolineato, ecc. senza tag di ancoraggio visibili.

Abilitare la modifica WYSIWYG

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedi l'opzione "Enable Advanced Formatting".

Abilita WYSIWYG

Per impostazione predefinita, FastComments mostrerà una barra degli strumenti quando si scrive un commento per fornire scorciatoie per decorare il testo e caricare le immagini.

Questa barra degli strumenti può essere disabilitata nel codice o tramite l'interfaccia di personalizzazione.

Disabilitare la barra degli strumenti

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedere l'opzione "Disabilita la barra degli strumenti di risposta".

Disabilitare la barra degli strumenti

Per impostazione predefinita, FastComments consente agli utenti di bloccare altri utenti. Il blocco di un utente farà sì che i suoi commenti vengano mascherati, impedirà le notifiche tra gli utenti e così via.

Potrebbe essere desiderabile disabilitare questa funzionalità. È possibile farlo in questo modo:

Disabilita blocco

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

Questo può anche essere fatto senza codice, il che consente anche una corretta validazione lato server, tramite l'interfaccia di personalizzazione del widget:

Disabilita blocco

Per impostazione predefinita, vengono utilizzate date relative localizzate. Per esempio, accanto a un commento appena lasciato potresti vedere "11 minuti fa".

Potrebbe essere necessario o desiderato utilizzare date assolute, nel qual caso imposti questo parametro su true.

Use Absolute Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteDates": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget, sotto Opzioni Avanzate:

Usa date assolute

Per impostazione predefinita, vengono utilizzate date relative localizzate. Ad esempio, accanto a un commento appena pubblicato potresti vedere "11 minuti fa".

Potrebbe essere necessario o desiderato mantenere questo formato di data relativa, ma anche mostrare la data completa accanto ad essa; in tal caso imposti questo parametro su true.

Use Both Absolute and Relative Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget, sotto Opzioni avanzate. Dovrai prima abilitare le Date assolute per vedere questa opzione nell'interfaccia utente.

Usa sia le date assolute che quelle relative

Alcuni testi, come un'intestazione o un messaggio, possono essere visualizzati sotto il conteggio dei commenti ma sopra il testo dello stato di accesso.

Chiamiamo questo l'intestazione, e per impostazione predefinita è nascosta.

Specifying Header HTML

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget, sotto Opzioni Avanzate:

Specificare l'HTML dell'intestazione

By default, FastComments will render links like this: https://exmaple.com - where the link URL becomes a clickable HTML anchor tag.

Some sites may want to disable this, for example to discourage scammers. We provide this by setting the Comment HTML Rendering Option to Links as Text.

This can be customized without code, on the widget customization page, for an entire domain, or page:

Renderizza i collegamenti come testo

Per impostazione predefinita, FastComments renderà la casella di inserimento del commento e il thread dei commenti contemporaneamente. Per risparmiare spazio verticale, nasconderà anche tutti gli altri campi richiesti finché il widget non verrà interagito.

Tuttavia, il widget dei commenti può essere nascosto dietro un pulsante, ad esempio:

Clicca per mostrare i commenti

Il pulsante utilizza testi tradotti diversi a seconda che i commenti siano attualmente mostrati o meno. Se i commenti sono nascosti, utilizza translations.SHOW_COMMENTS_BUTTON_TEXT. Se i commenti sono mostrati, utilizza translations.HIDE_COMMENTS_BUTTON_TEXT. Le traduzioni possono contenere il testo [count] che verrà sostituito dal conteggio localizzato.

Clicca per mostrare o nascondere i commenti

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useShowCommentsToggle": true

8}];

9</script>

10

Questo è progettato per sostituire la configurazione hideCommentsUnderCountTextFormat.

Il conteggio viene aggiornato in tempo reale con il thread dei commenti. Il pulsante non viene mostrato se non ci sono commenti.

Questo può essere abilitato senza codice creando una regola di personalizzazione e abilitando "Clicca per mostrare i commenti":

Abilita Clicca per mostrare i commenti

Il conteggio dei commenti visualizzato nella parte superiore del widget dei commenti può essere personalizzato.

Questo può essere sostituito con qualsiasi stringa, e il valore [count] verrà sostituito con il valore del conteggio, localizzato per l'utente.

Personalizzazione del testo del conteggio dei commenti

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Personalizzazione del testo del conteggio dei commenti

Quando gli utenti inseriscono gli hashtag, nella forma di #someexampletag, FastComments creerà automaticamente quel HashTag e lo evidenzierà nel loro commento.

In alcuni casi è desiderabile disabilitare questa funzionalità o controllare quali hashtag possono essere utilizzati tramite l'API.

Per farlo, basta abilitare Disable Automatic #hashtag Creation tramite l'interfaccia di personalizzazione del widget.

Disabilitazione della creazione automatica di HashTag

Di default, FastComments mostrerà una campanella di notifica in alto a destra dell'area dei commenti.

Questa campanella diventerà rossa e mostrerà un conteggio del numero di notifiche che l'utente ha. Alcuni esempi di notifiche sono:

• L'utente ti ha risposto.
• L'utente ha risposto in una discussione a cui hai commentato.
• L'utente ha votato positivamente il tuo commento.
• L'utente ha risposto a una pagina a cui sei iscritto.

La campanella di notifica fornisce anche un meccanismo per iscriversi a un'intera pagina, come pure.

Tuttavia, possiamo disabilitare completamente la campanella di notifica:

Disabilita la campanella di notifica

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedi la sezione "Disabilita la campanella di notifica".

Disabilita la campanella di notifica

Per impostazione predefinita, FastComments mostrerà il profilo dell'utente quando fai clic sul suo avatar.

Tuttavia, possiamo disabilitare questa funzionalità:

Disable Profiles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedi la sezione "Disabilita Profili".

Disabilita Profili

Per impostazione predefinita, FastComments mostrerà una scheda "Commenti del profilo" sui profili degli utenti, consentendo ai visitatori di lasciare commenti sul profilo di qualcuno.

Tuttavia, possiamo disabilitare questa scheda:

Disabilita i commenti del profilo

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileComments": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedere la sezione "Disabilita i commenti del profilo".

Disabilita i commenti del profilo

Per impostazione predefinita, FastComments mostrerà una scheda "Direct Messages" sui profili degli utenti, consentendo ai visitatori di inviare messaggi diretti a un utente.

Tuttavia, possiamo disabilitare questa scheda:

Disable Profile Direct Messages

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileDirectMessages": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedere la sezione "Disable Direct Messages".

Disabilita Messaggi Diretti del Profilo

Per impostazione predefinita, FastComments mostrerà un messaggio di conferma dopo aver commentato. Questo può essere disabilitato come segue:

Disabilita messaggio di successo

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget:

Disabilita messaggio di successo

Per impostazione predefinita, il widget dei commenti FastComments imposterà una gif rating di pg.

Le opzioni disponibili sono g, pg, pg-13 e r.

Questo può essere impostato nel codice o tramite l'interfaccia utente. Nel codice possiamo farlo come segue:

Imposta Valutazione Gif

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

Nell'interfaccia utente, lo troverai sotto Gif Picker Rating finché Disable Image Uploads? non è selezionato.

Impostazione della valutazione Gif

Per impostazione predefinita, il widget dei commenti FastComments ha la moderazione dei contenuti delle immagini impostata su off.

Le opzioni disponibili sono off, low, medium e high.

Nell'interfaccia di personalizzazione del widget, troverai questa impostazione sotto Image Content Moderation Level finché Disable Image Uploads? non è selezionato.

Impostazione del livello di moderazione dei contenuti delle immagini

Per impostazione predefinita, FastComments visualizza le opzioni di voto come frecce su e giù, consentendo agli utenti di votare un commento positivamente o negativamente.

Tuttavia, è possibile modificare lo stile della barra degli strumenti di voto. Le opzioni attuali sono i pulsanti predefiniti Su/Giù o l'utilizzo di un meccanismo di voto in stile Cuore.

Utilizziamo il flag voteStyle come segue:

Abilita pulsante a cuore

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

Consigliamo vivamente di farlo senza codice, poiché abilita anche le convalide lato server. Nella pagina di personalizzazione del widget, vedere la sezione "Vote Style".

Cambia stile di voto

Il voto può anche essere disabilitato, vedere Disable Voting sopra le opzioni di stile.

Per impostazione predefinita, FastComments consentirà agli utenti di eliminare i propri commenti.

Tuttavia, è possibile impedirlo.

Nella pagina di personalizzazione del widget, vedere l'opzione "Disabilita eliminazione".

Disabilita eliminazione commenti

• Questo influisce solo sui commentatori regolari e non sui moderatori o amministratori, che potranno ancora eliminare.
• Questo influenzerà anche le integrazioni API quando viene passato contextUserId.

Per impostazione predefinita, FastComments consentirà agli utenti di modificare i propri commenti.

Tuttavia, è possibile impedirlo.

Nella pagina di personalizzazione del widget, vedere l'opzione "Disabilita modifica".

Disabilita modifica commenti

• Questo influisce solo sui commentatori regolari e non sui moderatori o amministratori, che potranno comunque modificare.
• Questo influenzerà anche le integrazioni API quando viene passato contextUserId.

By default, the FastComments page size is 30. This includes replies in threads.

The page size can be customized in the Widget Configuration UI in varying sizes ranging from 10 to 200.

Note that changing the page size requires recalculating all the comment threads in your account. This may take a couple of minutes.

This cannot be configured in the client side widget as pages are calculated server-side.

Example configuration is shown below:

Dimensioni della pagina personalizzate

Page sizes can be customized globally, or per-domain, or per-page, by creating different customization rules.

This will affect all clients, integrations, and frameworks that you may be using to show comments via our platform.

Per impostazione predefinita, FastComments mostrerà il nome dell'utente così come è stato inserito, o come ci è stato trasmesso tramite SSO.

Tuttavia, potrebbe essere desiderabile mascherare o mostrare il nome dell'utente in modo diverso. Per esempio, se il nome dell'utente è Allen Rex, potresti voler mostrare solo "Allen R.".

Questo può essere fatto senza codice nell'interfaccia di personalizzazione del widget, sotto l'impostazione chiamata Commenter Name Format:

Modifica Formato Nome

I formati disponibili sono:

• Capitalize (mostra l'utente di esempio come Example User)
• Last Initial (mostra Example User come Example U.)
• All Initials (mostra Example User come E. U.)
• Mostra "Anonymous"

L'effetto di questa modifica è immediato. Gli utenti vedranno ancora il loro nome utente completo nella parte superiore dell'area dei commenti, per loro stessi, ma i loro commenti mostreranno il nome utente modificato.

I nomi utente sono mascherati lato server per proteggere gli utenti.

Per impostazione predefinita FastComments consente il caricamento di immagini. Questo può essere disabilitato impostando il flag noImageUploads su true.

Disabling Image Uploads

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Disabilitare il caricamento di immagini

By default FastComments does not allow iframes in comments. When you enable media embeds, commenters can paste the embed code (the <iframe> snippet) from trusted providers like YouTube, Vimeo, SoundCloud, and Spotify, and it will render inline in the comment.

For security, this is not a client-side widget config flag. It is a server-side setting, validated when each comment is saved, so it cannot be turned on from the page. Only iframes pointing at a built-in list of trusted providers are allowed. Any other iframe is removed.

This is done without code, on the widget customization page:

Consenti incorporamenti multimediali

Adding Your Own Providers

If you want to allow embeds from a provider that is not on the built-in trusted list, add its hostname in the "Additional Embed Domains" field on the same page. These hostnames are allowed in addition to the built-in providers. Matching is exact, so include the full hostname (for example, player.example.com). Anything you do not list stays blocked.

Both the plain comment box and the WYSIWYG editor support pasting an embed. In the WYSIWYG editor the embed is inserted as a removable block.

Per impostazione predefinita, non viene mostrata alcuna casella di ricerca nel widget dei commenti.

Tuttavia, possiamo attivarla impostando il flag enableSearch su true:

Abilitare la ricerca

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedere l'opzione "Abilita casella di ricerca".

Abilita casella di ricerca

Possiamo abilitare il supporto per i spoiler impostando il flag enableSpoilers su true:

Enabling Spoilers

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedere l'opzione "Enable Spoilers".

Abilita Spoiler

Quando il testo è evidenziato e il pulsante SPOILER ora visibile viene cliccato, il testo verrà mascherato finché l'utente non vi passa sopra con il mouse. Per la modalità scura facciamo la stessa cosa, con colori diversi che si adattano meglio alla modalità scura.

Questo è anche compatibile con l'editor WYSIWYG.

Per impostazione predefinita, FastComments non traccia chi ha visualizzato ogni commento né fornisce statistiche a riguardo.

Tuttavia, possiamo abilitare questa funzionalità e il sistema inizierà a tracciare quando ogni utente scorre verso un commento.

Quando ciò accade, un contatore accanto a un'icona a forma di occhio mostrata su ogni commento verrà incrementato. Il conteggio è aggiornato in tempo reale e abbreviato in base alla lingua dell'utente.

Possiamo abilitare questa opzione impostando il flag enableViewCounts su true:

Abilitare il conteggio delle visualizzazioni dei commenti

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableViewCounts": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Abilitare il conteggio delle visualizzazioni dei commenti

Tracciamo l'ID utente* che ha visualizzato il commento, in modo che se visualizzi nuovamente il commento non venga incrementato. Se visualizzi nuovamente il commento dopo due anni, il conteggio aumenterà di più.

• *Nota: oppure l'ID della sessione anonima, oppure l'IP dell'utente come valore hash.

Per impostazione predefinita, i commenti live sono abilitati. Ciò significa che se vengono aggiunti, eliminati, modificati o evidenziati commenti, le modifiche dovrebbero apparire a tutti gli utenti che visualizzano il thread dei commenti contemporaneamente.

Tuttavia, per impostazione predefinita, questi nuovi commenti appariranno sotto un pulsante mostrato dinamicamente con un testo simile a "Show 2 New Comments".

Se i nuovi commenti sono risposte direttamente alla pagina, il pulsante verrà mostrato in cima al thread dei commenti. Se sono risposte a un commento specifico, il pulsante verrà mostrato sotto quel commento.

Questo serve a evitare che la dimensione della pagina cambi costantemente per l'utente, potenzialmente causando frustrazione quando si tenta di afferrare la barra di scorrimento.

Per alcuni casi d'uso, come aste live o eventi online, questo non è il comportamento desiderato - potresti voler che il widget dei commenti sia più simile a una "chat" in cui i nuovi commenti "show right away".

Ecco il nome del flag che abilita questa funzionalità: showLiveRightAway.

Possiamo attivarlo come segue:

Mostra i commenti live subito

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Mostra i commenti live subito

Per impostazione predefinita, FastComments avrà i commenti in tempo reale abilitati.

Ciò significa che ogni visualizzatore della discussione dei commenti dovrebbe vedere lo stesso contenuto.

Ad esempio, se viene aggiunto un commento, quel commento dovrebbe apparire. Se un commento viene modificato o rimosso, allora quei commenti saranno modificati o rimossi per tutti i visualizzatori della discussione. Lo stesso vale per i voti e per tutte le azioni di moderazione.

Tuttavia, possiamo disabilitarlo:

Disabilita i commenti in tempo reale

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedere la sezione "Disabilita i commenti in tempo reale".

Disabilita i commenti in tempo reale

Per impostazione predefinita, FastComments ordinerà i commenti secondo la direzione di ordinamento "Most Relevant".

L'ordinamento Most Relevant tiene conto del momento in cui è stato lasciato il commento e del numero di voti per l'ordinamento.

L'utente può quindi cambiare la direzione di ordinamento in Oldest o Newest First nell'interfaccia del widget dei commenti.

Tuttavia, possiamo modificare il valore predefinito in una delle tre opzioni. Per esempio, se vuoi mostrare per primi i commenti più vecchi:

Modifica dell'ordinamento predefinito in più vecchi per primi

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

Impostiamo il valore di defaultSortDirection a "OF" per impostare la direzione su "OF".

Per la direzione di ordinamento newest-first, faremmo quanto segue:

Modifica dell'ordinamento predefinito in più recenti per primi

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

I valori validi per defaultSortDirection sono:

• MR: "Most Recent"
• NF: "Newest First"
• OF: "Oldest First"

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedi la sezione "Default Sort Direction".

Modifica della direzione di ordinamento predefinita

Nota che i commenti su ogni pagina per ciascuna direzione di ordinamento sono pre‑calcolati, quindi tutte le direzioni di ordinamento hanno le stesse prestazioni.

Per impostazione predefinita l'area di inserimento del commento è prima del thread dei commenti. Tuttavia, impostando questo parametro di configurazione su true possiamo spostarla dopo.

Spostare la casella di risposta in fondo

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Spostare la casella di risposta in fondo

Il numero massimo di caratteri consentiti da inserire nel campo di input del commento può essere limitato dal parametro maxCommentCharacterLength.

Il valore predefinito è 2000.

Elementi come gli URL delle immagini non sono inclusi nel calcolo della lunghezza.

Limit Comment Length

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Limita la lunghezza del commento

Per impostazione predefinita, FastComments consentirà all'utente di inserire un commento con quante righe desidera, fino al limite di caratteri predefinito.

Tuttavia, potrebbe essere opportuno limitare l'utente a inserire una sola riga di testo. Alcuni esempi di casi d'uso includono aste online o chat in tempo reale, per i quali FastComments può essere utilizzato.

Abilitiamo il flag useSingleLineCommentInput come segue:

Enable Single-Line Comment Input

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedere la sezione "Enable Single-Line Comment Input".

Abilita input di commenti a riga singola

Nota che i commenti su ogni pagina per ogni direzione di ordinamento sono pre‑calcolati, quindi tutte le direzioni di ordinamento hanno le stesse prestazioni.

Per impostazione predefinita, ogni utente può inviare fino a 5 commenti nello stesso minuto.

Questo viene tracciato tramite ID utente, ID utente anonimo e indirizzo IP (hashato).

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Limitare il volume dei commenti per utente

Nota che se stai usando l'API di creazione dei commenti potresti voler passare l'indirizzo ip originale dell'utente nella richiesta al nostro backend affinché il limitatore di velocità venga applicato per utente e non globalmente al tuo account.

FastComments ti consente di richiedere ai commentatori alla prima visita di accettare i tuoi Termini di Servizio prima di inviare un commento.

Quando abilitato:

• Utenti anonimi vedranno una casella di controllo TOS ogni volta che commentano
• Utenti autenticati vedranno la casella di controllo solo al loro primo commento, o quando aggiorni i tuoi Termini di Servizio

Configurazione

Vai alla pagina di personalizzazione del widget e abilita la casella di controllo "Richiedi l'accettazione dei Termini di Servizio". Una volta abilitata, vedrai le seguenti opzioni:

Opzioni dei Termini di Servizio

• Modalità Testo TOS: Per impostazione predefinita, la casella di controllo visualizza "Accetto i Termini di Servizio e l'Informativa sulla Privacy" con collegamenti a entrambi i documenti. Seleziona "Personalizza il testo per lingua" per fornire il tuo testo per ogni lingua.
• Data Ultimo Aggiornamento TOS: Quando aggiorni i tuoi Termini di Servizio, imposta questa data. Gli utenti che hanno accettato prima di questa data saranno tenuti ad accettare nuovamente.

Come Funziona

• Il timestamp di accettazione dei TOS è memorizzato per utente e per commento
• Quando un utente accetta i TOS, la data viene registrata sul suo profilo utente (per tenant)
• Se imposti una data "Ultimo Aggiornamento" successiva alla data di accettazione dell'utente, questi dovrà ri-accettare
• Per gli utenti anonimi che non possono essere tracciati, la casella di controllo appare su ogni invio di commento

FastComments Secure SSO utilizza la cifratura HMAC-SHA256 come meccanismo per implementare SSO. Prima descriveremo l'architettura generale, forniremo esempi e passi dettagliati.

Esiste anche della documentazione riguardante la migrazione da altri provider con meccanismi SSO simili, e le differenze.

Il flusso è il seguente:

Flusso Secure SSO

Poiché Secure SSO coinvolge sviluppo full-stack, esempi di codice funzionanti completi in Java/Spring, NodeJS/Express e PHP vanilla sono attualmente su GitHub.

Sebbene utilizziamo ExpressJS nell'esempio NodeJS e Spring nell'esempio Java, non sono necessari framework/librerie in questi runtime per implementare FastComments SSO - funzionano i pacchetti crypto nativi.

Non è necessario scrivere nuovi endpoint API con FastComments SSO. Basta crittografare le informazioni dell'utente usando la tua chiave segreta e passare il payload al widget dei commenti.

Ottieni la tua chiave segreta API

La tua API Secret può essere recuperata da questa pagina. Puoi trovare questa pagina anche andando su My Account, cliccando il riquadro API/SSO, e poi cliccando "Get API Secret Key".

Parametri del widget dei commenti

La documentazione API di alto livello per il widget dei commenti può essere trovata qui.

Entriamo più in dettaglio su cosa significano questi parametri.

Il widget dei commenti prende un oggetto di configurazione - lo passi già se stai usando FastComments per fornire il tuo customer id (chiamato tenantId).

Per abilitare SSO, passa un nuovo oggetto "sso", che deve avere i seguenti parametri. I valori dovrebbero essere generati lato server.

• userDataJSONBase64: I dati dell'utente in formato JSON, poi codificati in Base64.
• verificationHash: L'hash HMAC-SHA256 creato da UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Timestamp epoch, in millisecondi. Non deve essere nel futuro, né più di due giorni nel passato.
• loginURL: Un URL che il widget dei commenti può mostrare per effettuare il login dell'utente.
• logoutURL: Un URL che il widget dei commenti può mostrare per effettuare il logout dell'utente.
• loginCallback: Quando fornito al posto del login URL, una funzione che il widget dei commenti invocherà quando si clicca il pulsante di login.
• logoutCallback: Quando fornito al posto del logout URL, una funzione che il widget dei commenti invocherà quando si clicca il pulsante di logout.

Secure SSO Client Code

Copy

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1787115342928.0,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout",

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

The User Object

The User object contains the following schema:

Oggetto utente

Copy

1

2interface SSOUser {

3 /** Obbligatorio. Massimo 1k caratteri. **/

4 id: string;

5 /** Obbligatorio. Massimo 1k caratteri. Nota: Deve essere univoco. **/

6 email: string;

7 /** Obbligatorio. Massimo 1k caratteri. Nota: Lo username non può essere una email. Non deve essere unico. **/

8 username: string;

9 /** Facoltativo. Massimo 3k caratteri per URL. Predefinito: da gravatar basato sull'email. Supporta immagini codificate in base64, nel qual caso il limite è 50k caratteri. **/

10 avatar?: string;

11 /** Facoltativo. Predefinito false. **/

12 optedInNotifications?: boolean;

13 /** Facoltativo. Predefinito false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Facoltativo. Massimo 100 caratteri. Questa etichetta sarà mostrata accanto al loro nome. Predefinito: Amministratore/Moderatore quando applicabile. **/

16 displayLabel?: string;

17 /** Facoltativo. Massimo 500 caratteri. Questo sarà mostrato al posto dello username. **/

18 displayName?: string;

19 /** Facoltativo. Massimo 2k caratteri. Il nome dell'utente punterà a questo URL. **/

20 websiteUrl?: string;

21 /** Facoltativo. Fino a 100 gruppi per utente. Un id del gruppo non può essere più lungo di 50 caratteri. **/

22 groupIds?: string[];

23 /** Facoltativo. Indica che l'utente è amministratore. **/

24 isAdmin?: boolean;

25 /** Facoltativo. Indica che l'utente è moderatore. **/

26 isModerator?: boolean;

27 /** Facoltativo, predefinito true. Impostare a false per abilitare la scheda "activity" nel profilo dell'utente. **/

28 isProfileActivityPrivate?: boolean;

29 /** Facoltativo, predefinito false. Impostare a true per disabilitare i commenti del profilo. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Facoltativo, predefinito false. Impostare a true per disabilitare i messaggi diretti a questo utente. **/

32 isProfileDMDisabled?: boolean;

33 /** Configurazione facoltativa per i badge utente. **/

34 badgeConfig?: {

35 /** Array di ID badge globali da assegnare. Limitato a 30 badge. L'ordine è rispettato. **/

36 badgeIds: string[];

37 /** Array di ID badge con scope alla pagina corrente (urlId). Visualizzati solo nella pagina assegnata. **/

38 pageBadgeIds?: string[];

39 /** Se true, sostituisce i badge già visualizzati. I badge globali e quelli a livello di pagina vengono sovrascritti indipendentemente. **/

40 override?: boolean;

41 /** Se true, aggiorna le proprietà di visualizzazione dei badge dalla configurazione del tenant. **/

42 update?: boolean;

43 };

44}

45

Moderatori e Amministratori

Per amministratori e moderatori, passa i rispettivi flag isAdmin o isModerator nell'oggetto SSOUser.

Notifiche

Per abilitare o disabilitare le notifiche, imposta il valore di optedInNotifications su true o false rispettivamente. La prima volta che l'utente carica la pagina con questo valore nel payload SSO, le sue impostazioni di notifica saranno aggiornate.

Inoltre, se vuoi che gli utenti ricevano email di notifica per attività sulle pagine a cui si sono iscritti (anziché solo notifiche in-app), imposta optedInSubscriptionNotifications su true.

Utenti VIP e etichette speciali

Puoi mostrare un'etichetta speciale accanto al nome dell'utente usando il campo opzionale "displayLabel".

Utenti non autenticati

Per rappresentare un utente non autenticato, semplicemente non popolare userDataJSONBase64, verificationHash o timestamp. Fornisci un loginURL.

Questi utenti non potranno commentare e invece verranno presentati con un messaggio di login (messaggio, link o pulsante, a seconda della configurazione).

Esempi diretti per serializzare e calcolare l'hash dei dati utente

Ulteriori dettagli ed esempi sono disponibili qui (js), qui (java) e qui (php).

Comprendiamo che qualsiasi integrazione può essere un processo complicato e doloroso. Non esitare a contattare il tuo referente o a utilizzare la pagina di supporto.

FastComments SSO (dettagli qui) fornisce ai tuoi utenti un modo per commentare senza dover accedere a un'altra piattaforma.

Tuttavia, questo da solo non protegge i tuoi thread di commenti, poiché per impostazione predefinita i dati dei commenti sono informazioni pubblicamente disponibili: chiunque possa visualizzare la pagina può vedere i commenti.

Modificando un'impostazione, possiamo limitare il recupero dei commenti a meno che non lo faccia un amministratore o un utente SSO valido.

No-Code Setup

Possiamo impedire la visualizzazione e l'interazione con i nostri thread di commenti, quando SSO è configurato, creando una regola di personalizzazione.

Facendo ciò, cerca “SSO” e troverai questa opzione:

Richiedi SSO per visualizzare i commenti

Abilitala e salva la regola di personalizzazione.

Only Protect a Certain Domain or Page

Per proteggere solo un determinato dominio o pagina, configureremo semplicemente la regola di personalizzazione di conseguenza.

Nella parte superiore dell'interfaccia di personalizzazione, troveremo due campi di input, Dominio e ID URL.

Per proteggere solo un dominio specifico, inserisci il dominio in questione nel campo “domain”.

Per proteggere una pagina specifica, inserisci l'URL della pagina nel campo “URL ID”. Se hai un'integrazione personalizzata con FastComments, puoi inserire qui un tipo di ID invece di un URL.

Security Levels

Quando richiedi SSO, dovrai decidere se richiedere Simple SSO o Secure SSO. Se scegli Simple SSO, entrambi sono consentiti, ma se scegli Secure SSO, il contenuto deve essere recuperato con un payload Secure SSO hashato con la tua chiave API per poter essere visualizzato.

L'opzione del livello di sicurezza apparirà quando selezioni “Richiedi SSO per visualizzare i commenti”.

Protection Beyond Reading

Abilitare questa opzione proteggerà la pagina o il dominio dal ricevere commenti a meno che l'utente non sia autenticato tramite SSO.

Gotchas

Qualsiasi utente che ha creato commenti prima della tua integrazione SSO non potrà vederli, a meno che non effettui l'accesso tramite la tua integrazione SSO.

Per impostazione predefinita, FastComments richiederà un'email per commentare. Non deve essere un'email valida, tuttavia finché l'utente non clicca sul link inviato, il suo commento mostrerà l'etichetta "Commento non verificato".

Tuttavia, possiamo rimuovere il requisito dell'email. Il campo di inserimento dell'email sarà ancora visibile, ma non sarà più obbligatorio.

Questo può essere configurato tramite l'interfaccia di personalizzazione del widget:

Abilitare i commenti anonimi

FastComments può essere configurato per rimuovere i commenti non verificati dopo un numero desiderato di giorni. Questo aiuta a combattere lo spam.

Per impostazione predefinita, non lo fa.

Questo può essere configurato, o disabilitato, tramite la pagina Moderation Settings.

Impostazioni di moderazione

Quando gli utenti commentano e non sono autenticati, verrà chiesto loro di fornire l'email.

Questo creerà una "sessione non verificata" per quell'utente e gli chiederemo di verificare la sessione via email.

Per alcuni siti o applicazioni, è preferibile non chiedere all'utente la sua email quando commenta o vota.

Abilitare i commenti anonimi rende il campo di inserimento dell'email opzionale. Tuttavia, possiamo disabilitarlo completamente. Prima, abilita i commenti anonimi, e poi apparirà l'opzione per disabilitare i campi di input dell'email.

Disabilita input email

Con questa impostazione attiva, i campi email non verranno mostrati affatto in tutti i nostri prodotti di commento.

Nota che, con questa configurazione, tutti i commenti saranno non verificati a meno che l'utente non crei un account e acceda a https://fastcomments.com.

Potresti considerare di disabilitare l'etichetta non verificata.

Per impostazione predefinita, FastComments mostrerà un'etichetta "Commento non verificato" per i commenti lasciati da un utente che ha una sessione del browser non verificata. Leggi di più sul commento non verificato qui.

Disabilita l'etichetta non verificata

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

Inoltre, questa funzionalità può essere utilizzata, senza scrivere codice, nell'interfaccia di personalizzazione UI:

Disabilita l'etichetta non verificata

Quando gli utenti tentano di votare un commento e non sono autenticati, verrà chiesto loro di fornire il nome utente e l'email.

Possiamo rimuovere questo requisito, consentendo a chiunque di votare un commento senza fornire alcuna informazione.

Consenti voti anonimi

Quando gli utenti commentano o votano, e non sono connessi, verrà chiesto loro di fornire la propria email e nome utente.

Nel caso di commenti anonimi, a volte è desiderabile definire un nome utente predefinito per ridurre l'attrito quando si commenta. Questo può essere fatto dall'interfaccia di personalizzazione. I commenti anonimi devono essere abilitati prima.

Impostazione del nome utente predefinito

Per impostazione predefinita, FastComments renderizza il widget dei commenti nella lingua determinata dal sistema e dal browser dell'utente.

Quando un utente commenta o effettua il login, aggiorniamo la sua ultima lingua utilizzata e la usiamo anche per l'invio delle email.

Ciò influisce su come il widget dei commenti viene tradotto per l'utente. La lingua comprende la lingua e la regione dell'utente, quindi la configurazione della lingua solitamente cambia la lingua usata per mostrare il testo all'utente.

Via The UI

Questo può essere definito utilizzando l'interfaccia di personalizzazione del widget. Vedi l'opzione "Locale / Language":

Changing The Locale / Language

Via Code

Questo può essere sovrascritto con una lingua desiderata.

Manually Defining the User's Locale

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

Supported Languages and Locale Codes

Puoi trovare l'elenco completo delle lingue supportate e i relativi codici locale qui.

SSO Note

Se stai usando SSO, potresti voler passare la lingua dell'utente nell'oggetto user, in modo che le email e altre cose siano localizzate correttamente per loro.

Per impostazione predefinita, FastComments non limita le lingue utilizzate per commentare.

Potrebbe essere desiderabile limitare le lingue che una community utilizza.

Questo può essere configurato senza codice, nella pagina di personalizzazione del widget:

Lingue consentite

Il sistema analizzerà il commento, ne determinerà la lingua e la confronterà con l'elenco consentito.

Se il commento è scritto in una lingua non consentita, verrà mostrato un messaggio di errore localizzato.

I commenti possono essere bloccati in modo che non vengano lasciati nuovi commenti o voti impostando il flag readonly su true.

I commenti non potranno inoltre essere modificati o eliminati.

Making The Comment Thread Readonly

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget, per un intero dominio o pagina:

Rendere il thread dei commenti in sola lettura

Aggiornamento!

A partire da novembre 2022, i thread possono essere bloccati o sbloccati in tempo reale dagli amministratori e moderatori tramite il menu a tre puntini sopra l'area di risposta.

Questo impedirà nuovi commenti, consentendo comunque la votazione e permettendo agli utenti di eliminare i propri commenti se lo desiderano, mentre readonly non consente queste funzionalità.

Ciò corrisponde al campo isClosed nell'API Page.

Per impostazione predefinita, FastComments consente di collegare a qualsiasi sito esterno.

Questo può essere limitato a un elenco desiderato di siti o domini. Tentare di pubblicare un collegamento a un sito o dominio non presente nell'elenco definito provocherà la visualizzazione di un errore all'utente.

Questa convalida è valida solo per il Comment Widget e l'API. Le importazioni non sono interessate.

Questo viene fatto senza codice, nella pagina di personalizzazione del widget:

Limita i domini dei link esterni

Per impostazione predefinita, FastComments chiederà all'utente solo il commento, il nome utente e l'email.

Tuttavia, in alcune situazioni potresti voler che l'utente lasci un collegamento al proprio blog o sito web.

Possiamo abilitare la visualizzazione di un campo di input aggiuntivo per inserire l'URL del sito web dell'utente impostando il flag enableCommenterLinks su true:

Abilitare i collegamenti dei commentatori

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

Quando tale URL viene fornito, l'account dell'utente verrà aggiornato e tutti i loro nomi utente su tutti i commenti passati e futuri saranno collegati a questo URL.

Questo può essere personalizzato senza codice, nella pagina di personalizzazione del widget:

Abilitare i collegamenti dei commentatori

Una lista di ID generati dalla pagina Gruppi di moderazione.

Quando specificato, i commenti lasciati usando la configurazione specificata conterranno lo stesso insieme di moderationGroupIds.

Se un Moderator ha uno o più Gruppi di moderazione definiti, essi vedranno solo i commenti nella pagina Moderate Comments associati ai loro gruppi.

Specify Moderation Groups

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

Per l'autenticazione, FastComments dipende dal fatto che i cookie di terze parti siano abilitati nel tuo browser. Senza di essi, gli utenti dovranno sempre lasciare la loro email per commentare (a meno che il campo email sia nascosto), e i loro commenti saranno sempre mostrati come non verificati (per impostazione predefinita).

Per aggirare questo, puoi abilitare il bypass dei cookie di terze parti.

Quando questa impostazione è abilitata, causerà un piccolo popup che mostra un messaggio indicando che l'utente sta effettuando il login. Questo popup compare ogni volta che l'utente interagisce con il widget dei commenti; per esempio, se lascia un commento.

Possiamo fare questo nel codice impostando il flag enableThirdPartyCookieBypass a true:

Abilitazione del bypass dei cookie di terze parti

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

Possiamo anche configurarlo tramite l'interfaccia di personalizzazione del widget, sotto Enable Third-Party Cookie Popup:

Abilitazione del bypass dei cookie di terze parti

By default, users can delete their own comments. Also, deleting their comment automatically deletes all child and transient comments in the thread. This behavior is also live.

You can restrict this in the following ways:

• Instead, anonymize the deleted comment (set name and text to [deleted] or a custom value).
• Don't allow deleting comments when there are replies. A customizable error message is shown.
• Restrict deleting when a comment has replies to only administrators and moderators.

This can be configured via the Comment Thread Deletion section in the Widget Customization UI.

Personalizza il comportamento di eliminazione per le risposte

Per impostazione predefinita, FastComments mostrerà i badge degli utenti solo sui loro commenti all'interno del thread dei commenti.

Tuttavia, possiamo mostrare i badge degli utenti accanto al loro nome sopra il modulo dei commenti abilitando questa funzionalità nella pagina di personalizzazione del widget:

Opzione Mostra Badge nella Barra Superiore

Questo visualizzerà i badge dell'utente accanto al suo nome nell'area della barra superiore, rendendo i suoi risultati e il suo stato più evidenti mentre sta scrivendo un commento.

Nota che questa funzionalità deve essere abilitata nell'interfaccia di personalizzazione del widget per funzionare. Puoi opzionalmente impostare il flag showBadgesInTopBar su false nella configurazione del tuo codice per disabilitarla selettivamente anche quando è attivata a livello di server:

Disable Show Badges in Top Bar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10

Per impostazione predefinita, FastComments non mostra un elenco di utenti nella pagina.

È possibile visualizzare un elenco di persone che stanno visualizzando la pagina in tempo reale, accanto al widget dei commenti. L'elenco si aggiorna in tempo reale man mano che gli utenti entrano e escono, e mostra il loro nome, avatar e un indicatore online.

Ci sono tre opzioni di layout:

• 1 - Top: una riga orizzontale di avatar sovrapposti visualizzata sopra i commenti.
• 2 - Left: una barra laterale con nomi e punti online visualizzata a sinistra del widget.
• 3 - Right: la stessa barra laterale visualizzata a destra del widget.

Imposta il flag usersListLocation per abilitare la funzionalità:

Mostra l'elenco utenti a destra

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3

8}];

9</script>

10

Per impostazione predefinita l'elenco mostra solo gli utenti attualmente online. Per includere anche le persone che hanno commentato la pagina in passato (ma non la stanno visualizzando al momento), imposta usersListIncludeOffline su true:

Includi commentatori passati

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3,

8 "usersListIncludeOffline": true

9}];

10</script>

11

I commentatori passati vengono visualizzati senza il punto verde online, così è chiaro chi è presente in questo momento.

Gli utenti con profili privati sono mostrati con un avatar generico e un'etichetta "Profilo Privato", in modo che il conteggio rimanga accurato senza rivelare le identità.

Questa impostazione può essere configurata anche senza codice. Nella pagina di personalizzazione del widget, vedi l'opzione "Users List Location". Quando la posizione è impostata su qualsiasi valore diverso da Off, appare una casella di controllo "Include past commenters" sotto di essa.

Impostazioni elenco utenti

Con 500 utenti live, l'elenco può essere fino a 30 secondi fuori data.