Customizations & Configuration

Personalizzazioni e Configurazione

Contesto

Qui troverai una documentazione approfondita su ciascuna delle funzionalità e impostazioni supportate dal widget dei commenti.

Questa documentazione coprirà i concetti fondamentali e approfondirà ciascuna area di funzionalità, con guide pratiche e problemi comuni.

Saranno forniti esempi di codice, con le righe rilevanti evidenziate. Verranno fornite schermate delle pagine di configurazione dove applicabile.

Gli esempi di codice useranno la nostra libreria vanilla JavaScript; tuttavia le opzioni di configurazione utilizzano esattamente gli stessi nomi per tutte le versioni del widget dei commenti (React, Vue, ecc.).

La maggior parte delle configurazioni e delle funzionalità descritte in questa guida non richiedono la scrittura di codice.

Identificare il tuo account

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

Demo Tenant ID

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo"
}];
</script>

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

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "aKa2Z4Q="
}];
</script>

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).

Come i commenti sono associati a pagine e articoli

Quando si visualizza una discussione di commenti, o si lascia un commento, FastComments deve sapere a quale pagina, articolo o prodotto appartengono quei commenti.

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

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

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

Defining a Custom URL ID

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "urlId": "https://example.com/page"
}];
</script>

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

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

Quando si crea una regola di personalizzazione, spesso vorremo che si applichi a tutte le pagine del nostro sito. Tuttavia, in alcuni casi vogliamo personalizzare il widget dei commenti su una pagina in particolare, sia per applicare uno stile personalizzato, sia magari per rendere anonimi i commenti di quella pagina. Potresti anche, per esempio, far apparire i commenti in tempo reale immediatamente su alcune pagine, mentre su altre nasconderli dietro pulsanti di notifica.

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

URL ID Input in The Widget Customization Page

Il valore in questo campo dovrebbe corrispondere al parametro urlId passato al widget dei commenti. Se vuoi 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 ora anche pattern! Ad esempio puoi avere */blog/* per aggiungere uno stile specifico al tuo blog e */store/* per avere uno stile specifico per il tuo store, il tutto utilizzando lo stesso dominio.

Avvertenze

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

Visualizzare gli stessi commenti su pagine diverse

Poiché il parametro urlId ci permette di definire a quale pagina, o id, sono collegati i commenti, possiamo semplicemente impostare urlId allo stesso valore su quelle pagine.

The Same Comments on Multiple Pages

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "urlId": "https://example.com/source-page"
}];
</script>

Stile personalizzato

FastComments è progettato per essere personalizzato. Il widget dei commenti viene eseguito all'interno di un iframe per motivi di sicurezza, quindi per applicare stili personalizzati è necessario seguire uno dei due approcci.

Il primo, il più semplice e quello che preferiamo, è utilizzare la pagina di personalizzazione del widget.

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

Custom CSS Input Area

Questo approccio ha alcuni vantaggi:

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

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

Passing Custom CSS

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": "button { background: red; }"
}];
</script>

Tuttavia, questo presenta limitazioni:

Esiste un limite alla quantità di CSS personalizzato che può essere passato prima che i nostri server rifiutino la richiesta, a causa della dimensione degli header.
Devi gestire il CSS personalizzato nella tua infrastruttura e nel tuo sistema di build. Questo può essere anche un vantaggio anziché uno svantaggio.
C'è un sovraccarico aggiuntivo nell'inviare il CSS personalizzato sulla rete due volte in questo caso d'uso, poiché deve essere inviato ai nostri server e poi inviato di nuovo nel contenuto dell'iframe. Tuttavia, per la maggior parte delle dimensioni dei payload, questo non è percettibile.
Una ottimizzazione comune è minimizzare il CSS per ridurne la dimensione sulla rete, ma con questo approccio dovrai gestirlo tu.
Il tuo CSS personalizzato non verrà testato quando apportiamo modifiche.

File CSS esterni

Puoi dire al widget di recuperare un file esterno usando @import!

Si raccomanda di inserire il @import in una regola di personalizzazione. In questo modo, se dovessimo mai dover apportare una modifica al widget dei commenti, possiamo utilizzare i nostri strumenti di automazione per verificare la tua configurazione. Ad esempio, creeresti una regola di personalizzazione nell'interfaccia di personalizzazione del widget, cliccheresti su Avanzate e inseriresti in CSS personalizzato:

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

Nel codice - Non consigliato

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

External CSS File

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": "@import url(https://example.com/styles.css);"
}];
</script>

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

Styling della finestra profilo utente

Anche i modal dei profili utente possono 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 dei profili utente.

Per esempio:

User Profile CSS

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": ".user-profile .profile-name { color: blue; }"
}];
</script>

Compatibilità retroattiva

Da FastComments sappiamo che i nostri clienti personalizzano il widget dei commenti. È così per progettazione: l'ultima cosa che vogliamo è che il nostro prodotto provochi incoerenze di design nel tuo prodotto.

Poiché questa è una parte importante del nostro prodotto, abbiamo una pipeline di build che ci permette di rivedere le modifiche al widget dei commenti, per cliente, ad ogni rilascio.

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

Caratteri personalizzati

FastComments è progettato per essere personalizzato, e il font utilizzato dai nostri widget non fa eccezione.

Per impostazione predefinita, FastComments utilizza la system font stack per apparire al meglio su un'ampia gamma di dispositivi.

Per definire i tuoi font, vedi la documentazione sul CSS personalizzato.

Lì troverai un modo per definire CSS personalizzato, che ti permetterà di impostare i font desiderati.

Come definire il font

Per sovrascrivere il font, ti consigliamo di definire il tuo CSS usando i selettori .fast-comments, textarea. Per esempio:

Esempio di font esterno personalizzato

Copy

Run

@import url('https://fonts.googleapis.com/css2?family=Roboto:wght@300&display=swap');
.fast-comments, textarea {
    font-family: 'Roboto', sans-serif;
}

Rimozione del branding

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.

Supporto per sfondi scuri (Modalità scura)

Per impostazione predefinita, il widget dei commenti FastComments rileva automaticamente la modalità scura nella maggior parte dei siti.

Quando viene rilevata la modalità scura, FastComments passerà da testo nero su sfondo bianco a testo bianco su sfondo nero. Anche le immagini cambieranno.

Al caricamento della pagina, il widget cercherà di determinare quanto scuro sia lo sfondo della pagina dietro il widget dei commenti. Ciò significa che la pagina potrebbe avere uno sfondo bianco, ma se posizioni il widget dei commenti all'interno di un contenitore con sfondo nero, la modalità scura dovrebbe comunque attivarsi automaticamente per rendere i commenti leggibili.

Tuttavia, il meccanismo di rilevamento, che si basa sulla determinazione della "luminosità", potrebbe non attivare la modalità scura quando desideri. Per forzarla, imposta il flag hasDarkBackground su true come segue:

Force Dark Background Mode

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "hasDarkBackground": true
}];
</script>

Attivare/disattivare la Modalità scura

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

<script src="https://fastcomments.com/js/embed-v2.min.js"></script>
<button id="toggle-dark-mode">Toggle Dark Mode</button>
<div id="fastcomments-widget"></div>
<script>
    (function() {
        const button = document.getElementById('toggle-dark-mode');
        const config = {
            tenantId: 'demo',
            hasDarkBackground: false
        };
        const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);
        button.addEventListener('click', function() {
            config.hasDarkBackground = !config.hasDarkBackground;
            if (config.hasDarkBackground) {
                document.body.classList.add('dark');
            } else {
                document.body.classList.remove('dark');
            }
            instance.update(config);
        });
    })();
</script>
<style>
    body.dark {
        background: #000;
        color: #fff;
    }
</style>

Sostituzione del testo

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

È possibile sovrascrivere un singolo elemento di testo, come il pulsante di invio, o tutto il testo dell'intero widget dei commenti.

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

Custom Text

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "translations": {
        "SUBMIT_REPLY": "Reply"
    }
}];
</script>

Tutte le traduzioni personalizzabili si trovano qui nella scheda "opzioni avanzate".

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

Custom Text

Al momento, tutte le sovrascritture delle traduzioni interessano tutte le localizzazioni.

Modificare l'avatar predefinito

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

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

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

Override The Default Avatar

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultAvatarSrc": "https://example.com/some-image.png"
}];
</script>

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

Customizing The Default Avatar

Nota che la definizione dell'avatar per un utente particolare, ad esempio con SSO, è trattata in una sezione dedicata.

Disabilitare gli avatar

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

Hiding Avatars

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "hideAvatars": true
}];
</script>

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

Hiding Avatars

Disabilitare tutti gli stili predefiniti

Per progetti di personalizzazione dello stile più ampi, potrebbe essere preferibile partire da una base pulita e non utilizzare affatto lo stile predefinito.

Tutti gli stili predefiniti possono essere rimossi impostando il parametro noStyles su true, come segue:

Disabling All Default Styles

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noStyles": true
}];
</script>

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

Disabling All Default Styles

Collegamento dai commenti alle pagine

Quando si inviano email di notifica, o si visualizzano i commenti in interfacce utente come la pagina di moderazione, è utile poter collegare dal commento alla pagina su cui si trova.

Se l'ID dell'URL non è sempre un vero e proprio ID, allora dobbiamo memorizzare l'URL altrove. È per questo che esiste la proprietà "url", definita come segue.

Defining a Custom URL

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "url": "https://example.com/article-5"
}];
</script>

Un caso d'uso comune è collegare il thread dei commenti a un identificatore, come un articolo, e poi rimandare a una pagina specifica, per esempio:

Defining Custom URL and URL IDs together

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "url": "https://example.com/article-5",
    "urlId": "article-5"
}];
</script>

L'URL non viene ripulito dai comuni parametri di marketing. Per impostazione predefinita, qualunque sia l'URL della pagina corrente, è l'URL che viene memorizzato con il commento.

Comprimi le risposte per impostazione predefinita

Per impostazione predefinita, le risposte ai commenti di primo livello vengono mostrate.

Questo può essere configurato in modo che l'utente debba cliccare "Mostra risposte" sui commenti di primo livello per vedere i commenti figli.

Collapse Replies to Top Level Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "collapseReplies": true
}];
</script>

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

Collapse Replies

Questa impostazione non influenzerà il numero di commenti di primo livello caricati inizialmente. Se hai un commento di primo livello e 29 commenti figli, con questa impostazione attivata vedrai:

Vedrai il commento di primo livello.
Vedrai Mostra risposte (29) sotto questo commento.

Se desideri mostrare tutti i commenti di primo livello in combinazione con questa opzione, imposta starting page to -1.

Abilitare l'editor WYSIWYG

Per impostazione predefinita, le funzionalità di formattazione in FastComments vengono eseguite aggiungendo tag di ancoraggio visibili come <b></b> attorno al testo. Cliccando la barra degli strumenti o usando le scorciatoie fa questo per te. Tuttavia, alcune community potrebbero voler optare per l'uso della formattazione senza tag di ancoraggio. Questo si chiama abilitare il editor WYSIWYG (ciò che vedi è ciò che ottieni). Questo editor appare esattamente uguale a quello predefinito, eccetto che carica del codice extra che permette agli utenti di mettere in grassetto, sottolineare, ecc. il loro testo senza tag di ancoraggio visibili.

Enabling WYSIWYG Editing

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableWYSIWYG": true
}];
</script>

This can also be done without code. In the widget customization page, see the "Abilita formattazione avanzata" option.

Enable WYSIWYG

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

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

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, consulta l'opzione "Disabilita la barra delle risposte".

Disabling The Toolbar

Disabilitare il blocco

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

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

Disable Blocking

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableBlocking": true
}];
</script>

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

Disable Blocking

Determinare quale pagina visualizzare

Quando si recuperano e si visualizzano i commenti, il widget dei commenti deve sapere da quale pagina iniziare. Per impostazione predefinita, inizia con la prima pagina, visualizzando solo quella pagina.

Se lo si desidera, la pagina esatta da visualizzare può essere passata al widget dei commenti come impostazione startingPage.

Specifying The Page to Render

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "startingPage": 1
}];
</script>

Nota che i numeri delle pagine partono da zero, quindi l'esempio sopra visualizza la seconda pagina.

Passare tra i thread di commento senza ricaricare la pagina

Abbiamo spiegato come urlId sia l'id della pagina o dell'articolo a cui sono associati i commenti.

Inoltre, per ricapitolare, se non è definito il urlId verrà impostato di default sull'URL della pagina corrente.

Che succede con le SPA, o applicazioni a pagina singola, dove la pagina o il contenuto a cui sono associati i commenti cambia dinamicamente senza un ricaricamento della pagina?

Angular, React, Vue, ecc.

Con le nostre librerie come Angular e React, aggiornare semplicemente la proprietà urlId passata al widget farà sì che il widget dei commenti si aggiorni. Puoi vedere questo in azione per l'app React, per esempio, qui.

VanillaJS

Se stai usando la libreria VanillaJS è un po' più complicato poiché non c'è un framework come Angular o React che gestisca il data binding o la propagazione dello stato.

Quando istanzi il widget VanillaJS, questo restituisce alcune funzioni che possono essere chiamate per aggiornarlo.

Ecco un esempio funzionale in cui cambiamo l'hash della pagina e aggiorniamo il widget dei commenti:

Esempio di cambio dell'hash della pagina

Copy

Run

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<button id="change-page"></button>
<div id="fastcomments-widget"></div>
<script>
    (function fastCommentsMain() {
        let config = {
            tenantId: 'demo'
        };
        let instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);
        let page = '#page-1';
        function getNextPage() {
            if (page === '#page-1') {
                return '#page-2';
            } else {
                return '#page-1';
            }
        }
        let button = document.getElementById('change-page');
        function nextPage() {
            page = getNextPage();
            button.innerText = 'Go to ' + getNextPage();
            window.location.hash = page;
            let locationString = window.location.toString();
            config.url = locationString; // Aggiorniamo anche url, così le notifiche possono collegarsi alla pagina corretta
            config.urlId = locationString;
            instance.update(config);
        }
        nextPage();
        button.addEventListener('click', nextPage);
    })();
</script>

Date assolute (disabilita i timestamp leggibili)

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

Potrebbe essere necessario o desiderabile usare date assolute; in tal caso impostare questo parametro su true.

Use Absolute Dates

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "absoluteDates": true
}];
</script>

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

Use Absolute Dates

Mostrare sia date assolute che relative

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

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

Use Both Absolute and Relative Dates

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "absoluteAndRelativeDates": true
}];
</script>

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

Use Both Absolute and Relative Dates

Aggiungere il testo dell'intestazione

Del testo, come un'intestazione o un messaggio, può essere visualizzato sotto il conteggio dei commenti ma sopra il testo che indica lo stato di accesso.

Lo chiamiamo intestazione e, per impostazione predefinita, è nascosta.

Specifying Header HTML

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "headerHTML": "<h1>Leave a Comment!</h1>"
}];
</script>

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

Specifying Header HTML

Visualizzare i link come testo

Per impostazione predefinita, FastComments visualizzerà i link in questo modo: https://exmaple.com - dove l'URL del link diventa un tag anchor HTML cliccabile.

Alcuni siti potrebbero voler disabilitare questa funzionalità, ad esempio per scoraggiare i truffatori. Offriamo questa possibilità impostando l'opzione Comment HTML Rendering Option su Links as Text.

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

Render Links as Text

Mostrare/nascondere i commenti con un pulsante

Per impostazione predefinita, FastComments renderizza la casella di inserimento commenti e il thread dei commenti contemporaneamente. Per risparmiare spazio verticale, nasconderà anche eventuali altri campi obbligatori fino a quando l'utente non interagisce con il widget.

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

Click to Show Comments

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

Click to Show or Hide Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "useShowCommentsToggle": true
}];
</script>

Questo è progettato per sostituire la configurazione hideCommentsUnderCountTextFormat.

Il conteggio viene aggiornato in tempo reale insieme al 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 attivando "Click to Show Comments":

Enable Click to Show Comments

Personalizzare il testo del conteggio commenti

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

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

Customizing The Comment Count Text

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "commentCountFormat": "There are [count] comments."
}];
</script>

È possibile personalizzarlo senza codice, nella pagina di personalizzazione del widget:

Customizing The Comment Count Text

Disabilitare il reindirizzamento delle immagini

Per impostazione predefinita, FastComments consente agli utenti di caricare immagini. Quando un utente clicca quell'immagine, FastComments, per impostazione predefinita, apre una nuova scheda per mostrarla a grandezza intera. Impostando questo flag su true si disabilita questo comportamento:

Disable Image Redirect

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableImageRedirect": true
}];
</script>

Se non prevedi di intercettare tu stesso il clic sull'immagine (vedi onImageClicked), consigliamo di combinare questa impostazione con qualche regola di stile per rimuovere l'aspetto che l'immagine sia cliccabile.

Disabilitare la creazione automatica degli hashtag

Quando gli utenti inseriscono 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 usati tramite l'API.

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

Disabling Automatic HashTag Creation

Disabilitare la campanella delle notifiche

Per impostazione predefinita, FastComments mostrerà una campanella di notifica nell'angolo in alto a destra dell'area dei commenti.

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

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

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

Tuttavia, possiamo disabilitare completamente la campanella di notifica:

Disable Notification Bell

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableNotificationBell": true
}];
</script>

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

Disable Notification Bell

---

Disabilitare i profili

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

Tuttavia, possiamo disabilitare questa funzionalità:

Disable Profiles

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableProfiles": true
}];
</script>

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

Disable Profiles

Disabilitare il messaggio di successo

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

Disable Success Message

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableSuccessMessage": true
}];
</script>

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

Disable Success Message

Modificare la valutazione del contenuto delle GIF

Per impostazione predefinita, il widget dei commenti FastComments imposterà un 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:

Set Gif Rating

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "gifRating": "pg-13"
}];
</script>

Nell'interfaccia utente, troverai questo sotto Gif Picker Rating purché Disable Image Uploads? non sia selezionato.

Setting The Gif Rating

Moderazione dei contenuti delle immagini

Per impostazione predefinita, il widget di commenti FastComments ha la moderazione del contenuto delle immagini impostata su off.

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

Nell'interfaccia di personalizzazione del widget, lo troverai sotto Image Content Moderation Level purché Disable Image Uploads? non sia selezionato.

Setting The Image Content Moderation Level

Modificare lo stile di voto

Per impostazione predefinita, FastComments visualizza le opzioni di voto come frecce su e giù, permettendo agli utenti di effettuare un voto positivo o negativo su un commento.

È comunque possibile cambiare lo stile della barra degli strumenti di voto. Le opzioni attuali sono i pulsanti predefiniti Su/Giù, oppure utilizzare un meccanismo di voto a forma di cuore.

Usiamo il flag voteStyle come segue:

Enable Heart Button

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "voteStyle": 1
}];
</script>

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

Change Voting Style

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

Disabilitare l'eliminazione

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

Tuttavia, è possibile impedirlo.

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

Disable Comment Deleting

Questo riguarda solo i commentatori normali e non i moderatori o gli amministratori, che potranno comunque eliminare.
Questo influirà anche sulle integrazioni API quando viene passato contextUserId.

Disabilitare la modifica

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

Tuttavia, è possibile impedirlo.

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

Disable Comment Editing

Questo interessa solo i commentatori regolari e non i moderatori o gli amministratori, che potranno comunque modificare.
Questo influirà anche sulle integrazioni API quando viene passato contextUserId.

Evidenziare i nuovi commenti

FastComments offre diversi modi per evidenziare i nuovi commenti.

In primo luogo, per impostazione predefinita i commenti che hanno attivato una notifica in-app (risposte, risposte nello stesso thread, o commenti su una pagina a cui sei iscritto), verranno evidenziati automaticamente con l'avatar dell'utente che brilla leggermente. Il colore può essere personalizzato tramite CSS usando la classe is-unread.

I commenti pubblicati nelle ultime 24 ore hanno applicata la classe 24hr, che può essere utilizzata per applicare uno stile.

Infine, tutti i nuovi commenti live che compaiono nella sessione dell'utente verranno evidenziati per alcuni secondi tramite un'animazione. Questo è fatto tramite la classe CSS is-live e può essere personalizzata a sua volta.

Dimensioni delle pagine

Per impostazione predefinita, la dimensione della pagina di FastComments è 30. Questo include le risposte nei thread.

La dimensione della pagina può essere personalizzata nella Interfaccia di configurazione del widget in varie dimensioni che vanno da 10 a 200.

Nota che modificare la dimensione della pagina richiede il ricalcolo di tutti i thread di commento nel tuo account. Questo può richiedere un paio di minuti.

Questo non può essere configurato nel widget lato client poiché le pagine sono calcolate lato server.

Di seguito è mostrato un esempio di configurazione:

Custom Page Sizes

Le dimensioni delle pagine possono essere personalizzate globalmente, per dominio o per pagina, creando regole di personalizzazione diverse.

Questo influenzerà tutti i client, le integrazioni e i framework che potresti utilizzare per mostrare i commenti tramite la nostra piattaforma.

Modelli di email

Le email inviate da FastComments ai tuoi clienti possono essere personalizzate. Il modello, la logica, e le traduzioni possono essere modificate. Il testo può essere personalizzato per locale, e lo stile può persino essere modificato per dominio. Scopri di più sui modelli di email personalizzati qui.

Formati dei nomi utente

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

Tuttavia, può essere desiderabile mascherare o visualizzare il nome dell'utente in modo diverso. Ad 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, nell'impostazione chiamata Commenter Name Format:

Change Name Format

I formati disponibili sono:

Capitalize (visualizza Example User come Example User)
Last Initial (visualizza Example User come Example U.)
All Initials (visualizza Example User come E. U.)
Show "Anonymous"

L'effetto della modifica è immediato. Gli utenti vedranno ancora il loro nome utente completo in cima all'area dei commenti, per se stessi, ma i loro commenti mostreranno il nome utente modificato.

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

Disabilitare il caricamento delle immagini

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

Disabling Image Uploads

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noImageUploads": true
}];
</script>

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

Disabling Image Uploads

Abilitare la casella di ricerca

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

Tuttavia, possiamo attivarlo impostando il flag enableSearch su true:

Enabling Search

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableSearch": true
}];
</script>

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

Enable Search Box

Abilitare gli spoiler

Possiamo abilitare il supporto agli spoiler impostando il flag enableSpoilers su true:

Enabling Spoilers

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableSpoilers": true
}];
</script>

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

Enable Spoilers

Quando del testo viene evidenziato e viene cliccato il pulsante SPOILER ora visibile, il testo sarà mascherato finché l'utente non ci passa sopra il cursore. 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.

Abilitare il conteggio visualizzazioni dei commenti

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

Tuttavia, è possibile abilitare questa funzionalità e il sistema inizierà a registrare quando ogni utente scorre fino a un commento.

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

È possibile abilitare questa opzione impostando il flag enableViewCounts su true:

Enabling Comment View Counts

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableViewCounts": true
}];
</script>

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

Enabling Comment View Counts

Tracciamo il user id* che ha visualizzato il commento, quindi se visualizzi di nuovo il commento non viene incrementato. Se visualizzi di nuovo il commento dopo due anni, il conteggio verrà nuovamente incrementato.

*Nota: o l'anon session id, o l'IP dell'utente come valore hashato.

Mostrare subito i commenti in tempo reale

Per impostazione predefinita, il commento live è abilitato. Ciò significa che se vengono aggiunti, eliminati, modificati o fissati dei commenti, le modifiche dovrebbero apparire a tutti gli utenti che stanno visualizzando il thread dei commenti nello stesso momento.

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

Se i nuovi commenti sono risposte dirette alla pagina, il pulsante verrà mostrato nella parte superiore del thread dei commenti. Se sono risposte a un commento particolare, il pulsante verrà mostrato sotto quel commento.

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

Per alcuni casi d'uso, come le offerte in tempo reale o gli eventi online, questo comportamento non è desiderato - potresti voler che il widget dei commenti sia più simile a una casella "chat" in cui i nuovi commenti "appaiono subito".

Da qui il nome della flag che abilita questa funzionalità: showLiveRightAway.

Possiamo attivarla come segue:

Show Live Comments Right Away

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "showLiveRightAway": true
}];
</script>

Questa impostazione può essere personalizzata senza codice, nella pagina di personalizzazione del widget:

Show Live Comments Right Away

Disabilitare i commenti in tempo reale

Per impostazione predefinita, FastComments avrà i commenti live abilitati.

Ciò significa che ogni visualizzatore del thread dei commenti dovrebbe vedere lo stesso contenuto.

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

Tuttavia, possiamo disabilitare questo:

Disable Live Commenting

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableLiveCommenting": true
}];
</script>

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

Disable Live Commenting

Posizionare i nuovi commenti in tempo reale in fondo

Per impostazione predefinita, i nuovi commenti in tempo reale appaiono in cima all'elenco dei commenti man mano che vengono pubblicati.

Quando questa opzione è abilitata, i nuovi commenti in tempo reale verranno aggiunti invece in fondo all'elenco. Questo influisce su come i commenti appaiono quando vengono pubblicati in diretta mentre gli utenti visualizzano la discussione.

New Live Comments to Bottom

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "newCommentsToBottom": true
}];
</script>

Con questa impostazione abilitata:

I nuovi commenti in tempo reale pubblicati da altri utenti appariranno in fondo all'elenco dei commenti
Gli utenti vedranno i nuovi commenti apparire sotto i commenti esistenti in tempo reale
Questo influisce solo sugli aggiornamenti dei commenti in tempo reale - non sul caricamento iniziale della pagina
Questo può aiutare a mantenere il flusso di lettura quando gli utenti seguono una discussione

Nota che questa impostazione influisce solo su dove vengono posizionati i nuovi commenti in tempo reale mentre arrivano. Non influenza l'ordinamento iniziale quando la pagina viene caricata.

Abilitare lo scorrimento infinito

Per impostazione predefinita, il widget FastComments si ridimensiona verticalmente per adattarsi a tutti i commenti visibili. La paginazione avviene tramite un pulsante "Mostra altri" alla fine della pagina corrente, poiché abbiamo riscontrato che questa interazione risulta la più naturale per la maggior parte degli utenti.

Tuttavia, ci sono alcuni casi in cui è preferibile lo scorrimento infinito. Ad esempio, utilizziamo questa funzionalità nel nostro prodotto Stream Chat.

Possiamo nascondere i pulsanti "Mostra altri" e passare allo scorrimento infinito impostando il flag enableInfiniteScrolling su true:

Enabling Infinite Scrolling

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableInfiniteScrolling": true
}];
</script>

Ciò richiede anche l'aggiunta di CSS personalizzato. Aggiungi CSS personalizzato per il selettore .comments per abilitare lo scorrimento, ad esempio:

Abilita Scorrimento Infinito

Copy

Run

.comments {
    max-height: 500px;
    overflow-y: auto;
}

Un esempio completo e funzionante sarebbe:

Enabling Infinite Scrolling

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableInfiniteScrolling": true,
    "customCSS": ".comments { max-height: 500px;  overflow-y: auto; }"
}];
</script>

Nell'esempio sopra utilizziamo la proprietà customCSS, tuttavia si consiglia di utilizzare invece l'interfaccia di configurazione del Widget per motivi di prestazioni. Consulta la documentazione sul Custom CSS.

Cambiare la direzione di ordinamento predefinita

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

L'ordinamento "Most Relevant" tiene conto dell'orario in cui è stato lasciato il commento e del numero di voti per determinare l'ordine.

L'utente può poi cambiare la direzione di ordinamento in "Più vecchi" o "Più recenti per primi" nell'interfaccia del widget dei commenti.

Tuttavia, possiamo cambiare il valore predefinito su una delle tre opzioni. Ad esempio, se si desidera mostrare prima i commenti più vecchi:

Changing The Default Sort To Oldest First

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultSortDirection": "OF"
}];
</script>

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

Per la direzione di ordinamento "più recenti per primi", faremmo quanto segue:

Changing The Default Sort To Newest First

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultSortDirection": "NF"
}];
</script>

I valori validi per defaultSortDirection sono:

MR: "Più recenti"
NF: "Più recenti per primi"
OF: "Più vecchi per primi"

Questo può essere fatto anche senza codice. Nella pagina di personalizzazione del widget, vedere la sezione "Direzione di ordinamento predefinita".

Changing The Default Sort Direction

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.

Visualizzare tutti i commenti contemporaneamente - disabilitare la paginazione

Per disabilitare la paginazione e visualizzare tutti i commenti contemporaneamente, impostare startingPage su -1.

Render All Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "startingPage": -1
}];
</script>

Spostare la casella di risposta dopo i commenti

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

Moving The Reply Box to The Bottom

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "inputAfterComments": true
}];
</script>

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

Moving The Reply Box to The Bottom

Limitare la lunghezza del commento

Il numero massimo di caratteri consentito nell'area di inserimento del commento può essere limitato dal parametro maxCommentCharacterLength.

Il valore predefinito è 2000.

Elementi come gli URL delle immagini non vengono inclusi nella determinazione della lunghezza.

Limit Comment Length

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "maxCommentCharacterLength": 500
}];
</script>

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

Limit Comment Length

Disabilitare i commenti su più righe

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

Tuttavia, potrebbe essere desiderabile limitare l'utente a inserire solo una singola riga di testo. Alcuni casi d'uso esemplificativi includono offerte online, o chat in tempo reale, per le quali FastComments può essere utilizzato.

Attiviamo il useSingleLineCommentInput flag come segue:

Enable Single-Line Comment Input

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "useSingleLineCommentInput": true
}];
</script>

Questo può anche essere fatto senza codice. Nella pagina di personalizzazione del widget, vedere la sezione "Abilita l'immissione di commenti su singola riga".

Enable Single-Line Comment Input

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

Limitare il numero di commenti per utente

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

Questo viene tracciato tramite user id, anon user id e ip address (hashato).

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

Limiting Comment Volume Per User

Nota che, se stai usando l'API per la creazione dei commenti, potresti voler passare l'originale ip dell'utente nella richiesta al nostro backend in modo che il rate limiting venga applicato per utente e non globalmente al tuo account.

Impedire nuovi commenti di primo livello

Impostare noNewRootComments su true farà sì che il widget nasconda l'area di risposta principale, ma consentirà comunque agli utenti di rispondere ai commenti figli. Ad esempio, potresti impostarlo in modo condizionale al caricamento della pagina per consentire solo ad alcuni utenti di lasciare commenti di primo livello.

Prevent New Root Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noNewRootComments": true
}];
</script>

Profondità massima delle risposte

Per impostazione predefinita, FastComments consente un annidamento illimitato delle risposte, creando una struttura a thread in cui gli utenti possono rispondere indefinitamente alle risposte.

L'opzione maxReplyDepth ti consente di limitare la profondità massima dei thread di risposte. Quando viene raggiunta la profondità massima, gli utenti non vedranno più il pulsante di risposta sui commenti a quel livello.

Limiting Reply Depth to 2 Levels

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "maxReplyDepth": 2
}];
</script>

Con maxReplyDepth impostato su 2:

Gli utenti possono commentare al livello principale (profondità 0)
Gli utenti possono rispondere ai commenti di livello principale (profondità 1)
Gli utenti possono rispondere a quelle risposte (profondità 2)
Non sono consentite ulteriori risposte oltre la profondità 2

Impostarlo su 1 consentirebbe solo risposte ai commenti di livello principale, creando una struttura di discussione più piatta.

Impostare maxReplyDepth a 0 disabiliterebbe tutte le risposte, permettendo solo commenti di livello principale. Se non specificato, le risposte possono essere annidate senza limiti.

Panoramica sul Single Sign On (SSO)

SSO, o single-sign-on, è un insieme di convenzioni usate per permettere a te o ai tuoi utenti di usare FastComments senza dover creare un altro account.

Assumendo che non permetti commenti anonimi, è necessario un account per commentare con FastComments. Rendiamo questo processo di registrazione molto semplice: l'utente lascia semplicemente la sua email quando commenta. Tuttavia, capiamo che anche questo è un'ulteriore frizione che alcuni siti vogliono evitare.

Possiamo ridurre questa frizione avendo un unico flusso di accesso per l'intero sito.

Come lo ottengo?

Tutti i tipi di account attualmente hanno accesso a SSO. Tuttavia, il numero massimo di utenti SSO varierà a seconda del tuo pacchetto. Come per le altre funzionalità, i piani Pro e superiori forniscono supporto diretto allo sviluppo.

Confrontiamo le opzioni, e poi entriamo nei dettagli di ciascuna.

Migrazione di utenti e commenti

Quando si esegue la migrazione da una piattaforma con SSO come Disqus, avrai già utenti e i loro commenti.

I commenti vengono importati come parte della tua migrazione, tramite l'API, la nostra Import UI, o il supporto clienti. L'Import UI è preferita se supporta la piattaforma da cui stai migrando, poiché incorpora gestione degli errori, estrazione e upload di avatar e media, e un sistema di monitoraggio dei job in batch.

Gli utenti stessi vengono aggiunti automaticamente quando visualizzano per la prima volta le discussioni dei commenti. In alternativa, possono essere aggiunti in anticipo tramite l'API, ma questo lavoro non offre molti vantaggi.

Se i commenti vengono importati e gli utenti SSO non vengono aggiunti manualmente tramite l'API, allora i commenti verranno automaticamente assegnati all'account dell'utente la prima volta che questo viene creato quando visualizza una qualsiasi discussione di commenti. Potranno quindi gestire, modificare ed eliminare i commenti che avevano scritto originariamente.

La migrazione automatica viene eseguita tramite email o username. Alcune piattaforme non forniscono le email nell'export, come Disqus, quindi in questo caso facciamo fallback sull'username.

Finché passi un username corrispondente e una email nel payload SSO, aggiungeremo l'email ai singoli oggetti commento in modo che le notifiche e le menzioni funzionino.

Se desideri importare commenti e utenti contemporaneamente, lavora con il supporto per migrare i commenti agli account rispettivi degli utenti dopo che questi sono stati importati tramite l'API.

Quindi, per riassumere, il percorso più semplice da seguire per la migrazione è:

Importa i commenti.
1. Avatar e altri media vengono migrati automaticamente se si utilizza l'Import UI in Manage Data -> Imports.
Configura Secure o Simple SSO.
Lascia che la migrazione avvenga per utente automaticamente quando eseguono il login per la prima volta.
1. Questo di solito aggiunge meno di un secondo al tempo di caricamento della pagina se l'utente ha meno di 50k commenti.

Utenti WordPress

Se stai usando il nostro plugin per WordPress allora non c'è codice da scrivere! Vai semplicemente alla pagina Admin del plugin, clicca su Impostazioni SSO, e poi su Abilita.

Questo ti porterà a un wizard a singolo click che creerà la tua API key, la invierà alla tua installazione WordPress e attiverà SSO. Abbiamo consolidato tutto questo in un singolo click per te.

Nota che se stai installando il plugin per la prima volta dovrai completare il processo di setup prima di vedere la pagina di amministrazione con il pulsante Impostazioni SSO.

SSO per WordPress - Moderatori

Nota che attualmente, affinché il badge "Moderatore" appaia accanto ai tuoi moderatori quando commentano con il plugin per WordPress di FastComments, devono anche essere aggiunti come Moderatore nella dashboard di FastComments e avere la loro email verificata.

Integrazioni personalizzate

Per integrazioni personalizzate, ci sono due opzioni.

Opzione Uno - Secure SSO

Con Secure SSO, FastComments sa che l'utente che commenta, vota e legge i commenti è un utente reale del tuo sito.

Finché crei un payload valido, l'utente avrà sempre un'esperienza di commento senza interruzioni.

Con Secure SSO, il payload SSO viene creato lato server usando l'autenticazione HMAC e poi passato al widget sul client.

Con Secure SSO, l'account dell'utente è completamente separato dal resto della base utenti di FastComments. Questo significa che se abbiamo due partner Azienda A e Azienda B, ognuno può avere un utente SSO con lo username "Bob".

Requisiti

Conoscenze di base nello sviluppo backend.
Conoscenze di base nella gestione di chiavi API segrete.
Conoscenze di base nello sviluppo di API o nel server-side rendering.

Vantaggi

Sicuro.
Esperienza di commento senza interruzioni.

Svantaggi

Richiede sviluppo backend.

Aggiornamento dei dati utente

Con Secure SSO, ogni volta che passi il payload utente sso, aggiorneremo il loro utente con le informazioni più recenti. Per esempio, se l'utente ha uno username X, e passi Y nel payload SSO, il loro username diventerà Y.

Se vuoi rimuovere dei valori usando questo approccio allora impostali a null (non undefined).

API Secure SSO

Forniamo inoltre un'API per interagire con gli utenti SSO. Vedi la documentazione.

Nota che quando si utilizza Secure SSO, gli utenti vengono creati automaticamente dietro le quinte al caricamento della pagina. Non è necessario importare in blocco i tuoi utenti.

Opzione Due - Simple SSO

L'alternativa a Secure SSO è semplicemente passare le informazioni dell'utente al widget dei commenti.

Fornire un'email con Simple SSO non è obbligatorio, tuttavia senza questa i loro commenti appariranno come "Non verificato".

^Nota! A partire dai primi mesi del 2022 i nomi utente con Simple SSO non devono essere unici su tutto FastComments.com.

Idealmente, Simple SSO dovrebbe essere scelto solo quando si sviluppa su una piattaforma che non fornisce accesso al backend.

Requisiti

Conoscenze di base nello sviluppo lato client.
È necessario conoscere almeno l'email dell'utente.

Vantaggi

Semplice.
Tutte le attività vengono comunque verificate.
L'utente non inserisce mai il proprio username o email.

Svantaggi

Meno sicuro rispetto a Secure SSO poiché il payload lato client potrebbe essere manipolato per impersonare qualsiasi utente.

API Simple SSO

Gli utenti creati automaticamente tramite il flusso Simple SSO vengono memorizzati come oggetti SSOUser. Possono essere accessi e gestiti tramite l'API SSOUser. Vedi la documentazione.

Integrazioni personalizzate - Single Sign On sicuro (SSO)

FastComments Secure SSO utilizza la crittografia HMAC-SHA256 come meccanismo per implementare SSO. Per prima cosa vedremo l'architettura generale, forniremo esempi e passaggi dettagliati.

C'è anche della documentazione riguardante la migrazione da altri provider con meccanismi SSO simili e le differenze.

Il flusso è il seguente:

Flusso SSO sicuro

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

Anche se usiamo ExpressJS nell'esempio NodeJS e Spring nell'esempio Java, non sono necessari framework/librerie in questi runtime per implementare FastComments SSO - i pacchetti di crittografia nativi funzionano.

Non è necessario scrivere nuovi endpoint API con FastComments SSO. Semplicemente cripta le informazioni dell'utente usando la tua chiave segreta e passa il payload al comment widget.

Ottieni la tua chiave API segreta

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

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

Entriamo nei dettagli di cosa significano questi parametri.

Il comment widget accetta 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é di oltre due giorni nel passato.
loginURL: Un URL che il comment widget può mostrare per effettuare il login dell'utente.
logoutURL: Un URL che il comment widget può mostrare per effettuare il logout dell'utente.
loginCallback: Quando fornito invece dell'URL di login, una funzione che il comment widget invoca cliccando il pulsante di login.
logoutCallback: Quando fornito invece dell'URL di logout, una funzione che il comment widget invoca cliccando il pulsante di logout.

Secure SSO Client Code

Copy

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "sso": {
        "userDataJSONBase64": "...",
        "verificationHash": "...",
        "timestamp": 1768890093199,
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout"
    }
}];
</script>

L'oggetto utente

The User object contains the following schema:

Oggetto utente

Copy

interface SSOUser {
    /** Obbligatorio. Massimo 1k caratteri. **/
    id: string;
    /** Obbligatorio. Massimo 1k caratteri. Nota: Deve essere univoco. **/
    email: string;
    /** Obbligatorio. Massimo 1k caratteri. Nota: Lo username non può essere un'email. Non deve essere univoco. **/
    username: string;
    /** Opzionale. Massimo 3k caratteri per URL. Il valore predefinito proviene da gravatar basato sull'email. Supporta immagini codificate in base64, nel qual caso il limite è di 50k caratteri. **/ 
    avatar?: string;
    /** Opzionale. Predefinito false. **/
    optedInNotifications?: boolean;
    /** Opzionale. Predefinito false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Opzionale. Massimo 100 caratteri. Questa etichetta verrà mostrata accanto al loro nome. Il valore predefinito è Amministratore/Moderatore quando applicabile. **/
    displayLabel?: string;
    /** Opzionale. Massimo 500 caratteri. Verrà mostrato al posto di username. **/
    displayName?: string;
    /** Opzionale. Massimo 2k caratteri. Il nome dell'utente sarà collegato a questo. **/
    websiteUrl?: string;
    /** Opzionale. Fino a 100 gruppi per utente. Un id di gruppo non può essere più lungo di 50 caratteri. **/
    groupIds?: string[];
    /** Opzionale. Indica che l'utente è un amministratore. **/
    isAdmin?: boolean;
    /** Opzionale. Indica che l'utente è un moderatore. **/
    isModerator?: boolean;
    /** Opzionale, predefinito true. Impostare su false per abilitare la scheda "attività" nel profilo dell'utente. **/
    isProfileActivityPrivate?: boolean;
    /** Opzionale, predefinito false. Impostare su true per disabilitare i commenti del profilo. **/
    isProfileCommentsPrivate?: boolean;
    /** Opzionale, predefinito false. Impostare su true per disabilitare i messaggi diretti a questo utente. **/
    isProfileDMDisabled?: boolean;
}

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 a true o false rispettivamente. La prima volta che l'utente carica la pagina con questo valore nel payload SSO, le sue impostazioni di notifica verranno aggiornate.

Inoltre, se vuoi che gli utenti ricevano email di notifica per l'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 utilizzando 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 verrà loro mostrato un messaggio di login (messaggio, link o pulsante, a seconda della configurazione).

Esempi diretti per la serializzazione e l'hashing 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 difficile. Non esitare a contattare il tuo referente o usare la pagina di supporto.

Integrazioni personalizzate - Single Sign On semplice (SSO)

Con Simple SSO, possiamo fornire al widget dei commenti informazioni sull'utente in modo che non debba inserire il proprio nome utente o la propria email per commentare.

Possiamo configurare Simple SSO come segue:

Simple SSO

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "simpleSSO": {
        "username": "Bob",
        "email": "bob@example.com",
        "avatar": "https://example.com/bob.png",
        "websiteUrl": "https://example.com/profiles/bob",
        "displayName": "Bob's Name",
        "displayLabel": "VIP User",
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout",
        "badgeConfig": {
            "badgeIds": [
                "badge-id-1",
                "badge-id-2"
            ],
            "override": false
        }
    }
}];
</script>

L'utente verrà autenticato e verrà creato un utente SSO in background. L'utente avrà createdFromSimpleSSO impostato su true se recuperato dall'API.

Notes:

L'email è l'identificatore univoco per Simple SSO.
Fornire un'email con Simple SSO non è obbligatorio, tuttavia per impostazione predefinita i loro commenti verranno mostrati come "Non verificato". Se non viene fornita un'email, l'utente non può essere completamente autenticato.
NUOVO Da gennaio 2022: i nomi utente non devono essere univoci su tutto fastcomments.com
Simple SSO può creare e aggiornare automaticamente gli utenti SSO se viene fornita un'email e l'utente non è stato originariamente creato tramite Secure SSO.
È possibile specificare badge per l'utente con la proprietà badgeConfig. L'array badgeIds contiene gli ID dei badge da associare all'utente. Se override è impostato su true, sostituirà tutti i badge esistenti visualizzati nei commenti; se false verrà aggiunto ai badge esistenti.

Integrazioni personalizzate - Migrazione da Disqus SSO

Le principali differenze tra Disqus e FastComments Secure SSO sono che Disqus usa SHA1 per la crittografia mentre noi usiamo SHA256. Ciò significa che migrare da Disqus è semplice - basta cambiare l'algoritmo di hashing da SHA1 a SHA256 e aggiornare i nomi delle proprietà passate alla UI.

Integrazioni personalizzate - Migrazione da Commento SSO

Commento utilizza un approccio SSO drasticamente diverso - richiedono che tu abbia un endpoint che invocano per autenticare l'utente. FastComments è l'opposto - semplicemente codificare e calcolare l'hash delle informazioni dell'utente usando la tua chiave segreta e passarle.

Proteggere i thread di commenti con Single Sign-On

FastComments SSO (maggiori dettagli) offre ai tuoi utenti un modo per commentare senza dover effettuare il login su un'altra piattaforma.

Tuttavia, questo da solo non mette al sicuro i thread dei commenti, poiché per impostazione predefinita i dati dei commenti sono informazioni pubbliche - chiunque possa visualizzare la pagina può vedere i commenti.

Modificando un'impostazione, possiamo limitare il recupero dei commenti a soli amministratori o utenti SSO validi.

No-Code Setup

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

Quando lo fai, cerca SSO e troverai questa opzione:

Require SSO To View Comments

Attiva e salva la regola di personalizzazione.

Only Protect a Certain Domain or Page

Per proteggere solo un determinato dominio o una pagina, configureremo semplicemente la regola di personalizzazione in tal senso.

Nella parte superiore dell'interfaccia di personalizzazione troveremo due campi, Domain and URL ID.

Per proteggere solamente un dominio specifico, inserisci il dominio in questione nel campo "domain".

Per proteggere una pagina particolare, 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 richiedi Simple SSO, allora entrambi sono consentiti, ma se richiedi Secure SSO allora il contenuto deve essere recuperato con un payload di Secure SSO la cui hash è calcolata con la tua API key affinché possa essere visualizzato.

L'opzione del livello di sicurezza apparirà quando selezioni "Require SSO To View Comments".

Protection Beyond Reading

Abilitando questa opzione, la pagina o il dominio saranno protetti dall'essere commentati a meno che l'utente non abbia effettuato l'accesso 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.

Consentire commenti anonimi

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

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

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

Enabling Anonymous Comments

Impedire la scadenza dei commenti anonimi

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

Per impostazione predefinita, non lo fa.

Questo può essere configurato, o disabilitato, tramite la pagina Impostazioni di moderazione.

Moderation Settings

Disabilitare i campi email

Quando gli utenti commentano e non hanno effettuato l'accesso, verrà chiesto loro di fornire la loro email.

Questo creerà una "sessione non verificata" per quell'utente, e gli chiederemo di verificare quella 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 email opzionale. Tuttavia, possiamo disabilitarlo completamente. Prima, abilita i commenti anonimi, e poi apparirà l'opzione per disabilitare i campi di input email.

Disable Email Inputs

Con questa impostazione attivata, i campi email non verranno visualizzati affatto in nessuno dei nostri prodotti per i commenti.

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

Potresti prendere in considerazione disabilitare l'etichetta non verificata.

Disabilitare l'etichetta 'Non verificato'

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

Disable The Unverified Label

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableUnverifiedLabel": true
}];
</script>

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

Disable The Unverified Label

Consentire il voto anonimo

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

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

Allow Anonymous Votes

Impostare un nome utente predefinito

Quando gli utenti commentano o votano, e non hanno effettuato l'accesso, verrà loro richiesto di fornire la loro email e il 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.

Setting The Default Username

Callback

Tutte le librerie per il widget dei commenti (attualmente Angular, React, Vue) supportano callback.

I callback sono specificati nell'oggetto di configurazione, con la stessa firma per ogni libreria.

I callback supportati sono:

onInit
onAuthenticationChange
onRender
commentCountUpdated
onReplySuccess
onVoteSuccess
onImageClicked
onOpenProfile
onCommentSubmitStart
onCommentsRendered

Le firme esatte possono essere trovate nelle TypeScript definitions.

Ecco un esempio con tutti i callback utilizzati:

Esempi di callback

Copy

Run

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
    window.FastCommentsUI(document.getElementById('fastcomments-widget'), {
        tenantId: 'demo',
        onInit: function () {
            console.log('Library started to fetch comments!');
        },
        onAuthenticationChange: function (eventName, userObj) {
            console.log('User authenticated!', eventName, userObj);
        },
        onRender: function () {
            console.log('Render event happened!');
        },
        commentCountUpdated: function (newCount) {
            console.log('New comment count:', newCount);
        },
        onReplySuccess: function (comment) {
            console.log('New comment saved!', comment);
        },
        onVoteSuccess: function (comment, voteId, direction, status) {
            console.log('New vote saved!', comment, voteId, direction, status);
        },
        onImageClicked: function (src) {
            console.log('Image clicked!', src);
        },
        onOpenProfile: function (userId) {
            console.log('User tried to open profile', userId);
            // return true; // restituisci true per impedire il comportamento predefinito (aprire il profilo utente su fastcomments.com).
        },
        onCommentSubmitStart: function(comment, continueSubmitFn, cancelFn) {
            console.log('Trying to submit comment', comment);
            setTimeout(function() { // emulazione di comportamento asincrono (chiamata di API, ecc.).
                if(confirm('Should submit?')) {
                    continueSubmitFn();
                } else {
                    cancelFn('Some optional error message');
                }
            }, 1000);
        },
        onCommentsRendered: function(comments) {
            // i commenti sono ordinati in base all'ordinamento predefinito della pagina che può essere "Più rilevanti" (es.: più votati, ecc.) o "Più recenti"
            const topCommentInList = comments[0];
            console.log('First Comment Rendered:', topCommentInList.avatarSrc, topCommentInList.commenterName, topCommentInList.commentHTML);
        }
    });
</script>

Definire manualmente la localizzazione dell'utente

Per impostazione predefinita, FastComments renderizzerà il widget dei commenti nella locale determinata dal sistema e dal browser dell'utente.

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

Questo influisce su come il widget dei commenti viene tradotto per l'utente. La locale consiste nella lingua e nella regione dell'utente, quindi configurare la locale di solito cambierà la lingua usata per mostrare il testo all'utente.

Tramite l'interfaccia utente

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

Changing The Locale / Language

Tramite codice

Questo può essere sovrascritto con la locale desiderata.

Manually Defining the User's Locale

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "locale": "ru_ru"
}];
</script>

Lingue supportate e codici locale

Puoi trovare l'elenco completo delle lingue supportate e dei corrispondenti codici locale qui.

Nota SSO

Se stai usando SSO, potresti voler passare la locale dell'utente nell'oggetto user, affinché le email e altri elementi siano localizzati correttamente per loro.

Limitare le lingue consentite

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

Potrebbe essere desiderabile limitare le lingue utilizzate da una community.

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

Allowed Languages

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.

Titoli delle pagine

Il titolo della pagina corrente è associato al urlId specificato e salvato per l'uso negli strumenti di moderazione.

Per impostazione predefinita, questo viene recuperato da document.title.

Se desiderato, è possibile specificare un titolo di pagina personalizzato come segue:

Specifying The Page Title

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "pageTitle": "Article 42"
}];
</script>

Impedire nuove risposte e disabilitare i voti

I commenti possono essere bloccati in modo che non possano essere 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

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "readonly": true
}];
</script>

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

Making The Comment Thread Readonly

Aggiornamento!

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

Questo impedirà nuovi commenti, pur consentendo il voto e permettendo agli utenti di eliminare i propri commenti se lo desiderano, mentre readonly non consente queste operazioni.

Questo corrisponde al campo isClosed nell'API Page.

Restringere i domini dei link

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

Questo può essere limitato invece a una lista desiderata di siti, o domini. Il tentativo di pubblicare un collegamento a un sito, o dominio, non presente nella lista definita farà sì che venga mostrato un errore all'utente.

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

Questo si fa senza codice, nella pagina di personalizzazione del widget:

Restrict External Link Domains

Il conteggio dei commenti e il conteggio di tutte le risposte nidificate

Il conteggio dei commenti visualizzato nella parte superiore del widget dei commenti può mostrare o tutti i commenti "di primo livello", ovvero le risposte che sono risposte direttamente alla pagina o all'articolo stesso, oppure può essere un conteggio di tutti i commenti nidificati.

Per impostazione predefinita, questo è true - è un conteggio del secondo tipo - tutti i commenti. Nelle versioni precedenti del widget dei commenti il valore predefinito era false.

Possiamo cambiare il comportamento, così che sia un conteggio di tutti i commenti nidificati impostando il flag countAll su true.

Counting All Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "countAll": true
}];
</script>

Se volessimo che il conteggio riflettesse solo i commenti di primo livello, impostiamo il flag su false.

Counting Top Level Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "countAll": false
}];
</script>

Attualmente questo non può essere personalizzato senza modifiche al codice.

Abilitare i link dei commentatori

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

Tuttavia, in alcune situazioni potresti voler permettere all'utente di lasciare un link al proprio blog o sito web.

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

Enabling Commenter Links

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableCommenterLinks": true
}];
</script>

Quando viene fornito tale URL, l'account dell'utente verrà aggiornato e il suo nome utente in tutti i commenti passati e futuri sarà collegato a questo URL.

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

Enabling Commenter Links

Gruppi di moderazione

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

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "moderationGroupIds": [
        "mxZAhjzdb",
        "FT19nXbqA"
    ]
}];
</script>

ID dei gruppi per le menzioni

Una lista di ID da usare per l'autocompletamento delle @mentions. Utile quando vuoi evitare di taggare utenti che non hanno gruppi in comune.

Quando specificato, solo gli utenti appartenenti ad altri gruppi verranno mostrati nell'autocompletamento dopo aver digitato il carattere @.

Limit Groups for Mentions

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "mentionGroupIds": [
        "yxZAhjzda",
        "QT19nXbqB"
    ]
}];
</script>

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

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

Quando questa impostazione è abilitata, apparirà un piccolo popup che mostra un messaggio che indica che l'utente viene autenticato. Questo popup viene mostrato ogni volta che l'utente interagisce con il widget dei commenti; ad esempio, quando lascia un commento.

Possiamo farlo nel codice impostando il flag enableThirdPartyCookieBypass a true:

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

Enabling Third-Party Cookie Bypass

Eliminare commenti che hanno risposte

Per impostazione predefinita, gli utenti possono eliminare i propri commenti. Inoltre, eliminando un loro commento vengono automaticamente eliminati tutti i commenti figli e transitori nella discussione. Questo comportamento è valido anche per i commenti live.

Puoi limitarlo nei seguenti modi:

Invece, anonimizza il commento eliminato (imposta nome e testo su [deleted] o un valore personalizzato).
Non consentire l'eliminazione dei commenti quando ci sono risposte. Viene mostrato un messaggio di errore personalizzabile.
Restringere la cancellazione dei commenti con risposte solo ad amministratori e moderatori.

Questo può essere configurato tramite la sezione Comment Thread Deletion nell'interfaccia di personalizzazione del widget.

Customize Delete Behavior for Replies

Mostrare i badge nella barra superiore

Per impostazione predefinita, FastComments mostrerà i distintivi dell'utente solo nei commenti dell'utente all'interno del thread dei commenti.

Tuttavia, è possibile mostrare i distintivi degli utenti accanto al loro nome sopra il modulo di commento abilitando questa funzione nella pagina di personalizzazione del widget:

Show Badges in Top Bar Option

Questo mostrerà i distintivi dell'utente accanto al suo nome nell'area della barra superiore, mettendo in evidenza i suoi risultati e il suo stato quando sta componendo un commento.

Nota che questa funzione 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

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "showBadgesInTopBar": false
}];
</script>

Guida precedente Guida successiva

Lingua 🇮🇹 Italiano

Nozioni di base

Aspetto

Commenti in tempo reale

Paginazione e ordinamento

La casella di risposta

SSO

Commenti anonimi

Varie

Personalizzazioni e Configurazione

Contesto

Identificare il tuo account

Come i commenti sono associati a pagine e articoli

Avvertenze

Visualizzare gli stessi commenti su pagine diverse

Stile personalizzato

File CSS esterni

Nel codice - Non consigliato

Styling della finestra profilo utente

Compatibilità retroattiva

Caratteri personalizzati

Come definire il font

Rimozione del branding

Supporto per sfondi scuri (Modalità scura)

Attivare/disattivare la Modalità scura

Sostituzione del testo

Modificare l'avatar predefinito

Disabilitare gli avatar

Disabilitare tutti gli stili predefiniti

Collegamento dai commenti alle pagine

Comprimi le risposte per impostazione predefinita

Abilitare l'editor WYSIWYG

Disabilitare la barra degli strumenti

Disabilitare il blocco

Determinare quale pagina visualizzare

Passare tra i thread di commento senza ricaricare la pagina

Angular, React, Vue, ecc.

VanillaJS

Date assolute (disabilita i timestamp leggibili)

Mostrare sia date assolute che relative

Aggiungere il testo dell'intestazione

Visualizzare i link come testo

Mostrare/nascondere i commenti con un pulsante

Personalizzare il testo del conteggio commenti

Disabilitare il reindirizzamento delle immagini

Disabilitare la creazione automatica degli hashtag

Disabilitare la campanella delle notifiche

Disabilitare i profili

Disabilitare il messaggio di successo

Modificare la valutazione del contenuto delle GIF

Moderazione dei contenuti delle immagini

Modificare lo stile di voto

Disabilitare l'eliminazione

Disabilitare la modifica

Evidenziare i nuovi commenti

Dimensioni delle pagine

Modelli di email

Formati dei nomi utente

Disabilitare il caricamento delle immagini

Abilitare la casella di ricerca

Abilitare gli spoiler

Abilitare il conteggio visualizzazioni dei commenti

Mostrare subito i commenti in tempo reale

Disabilitare i commenti in tempo reale

Posizionare i nuovi commenti in tempo reale in fondo

Abilitare lo scorrimento infinito

Cambiare la direzione di ordinamento predefinita

Visualizzare tutti i commenti contemporaneamente - disabilitare la paginazione

Spostare la casella di risposta dopo i commenti

Limitare la lunghezza del commento

Disabilitare i commenti su più righe

Limitare il numero di commenti per utente

Impedire nuovi commenti di primo livello

Profondità massima delle risposte

Impostare maxReplyDepth a 0 disabiliterebbe tutte le risposte, permettendo solo commenti di livello principale. Se non specificato, le risposte possono essere annidate senza limiti.

Panoramica sul Single Sign On (SSO)

Come lo ottengo?

Migrazione di utenti e commenti

Utenti WordPress

SSO per WordPress - Moderatori