Plug-in dei commenti

Il plug-in dei commenti consente alle persone di commentare i contenuti del tuo sito mediante l'account Facebook. Gli utenti possono anche decidere di condividere le proprie attività relative ai commenti con gli amici (e gli amici degli amici) su Facebook. Il plug-in dei commenti comprende anche strumenti di moderazione integrati.

Modifiche ai plug-in social nella regione europea

Potresti iniziare a riscontrare qualche effetto sui Plug-in social a causa dell'aggiornamento di una richiesta per il consenso all'uso dei cookie che verrà mostrata alle persone che utilizzano i prodotti Facebook nella regione europea. Non supporteremo più i Plug-in social "Mi piace" e "Commenta" per gli utenti nella regione europea, a meno che non soddisfino entrambe queste condizioni: 1) hanno effettuato l'accesso al proprio account Facebook e 2) hanno fornito il consenso al controllo "Cookie dell'app e del sito web". Se entrambi questi requisiti sono soddisfatti, l'utente sarà in grado di vedere e interagire con plug-in come il pulsante "Mi piace" o "Commenta". Se uno dei requisiti di cui sopra non viene soddisfatto, l'utente non sarà in grado di vedere i plug-in.

La regione europea è una lista specifica di Paesi che include:

  • Unione europea (UE): Austria, Belgio, Bulgaria, Croazia, Repubblica di Cipro, Repubblica Ceca, Danimarca, Estonia, Finlandia, Francia, Germania, Grecia, Ungheria, Irlanda, Italia, Lettonia, Lituania, Lussemburgo, Malta, Paesi Bassi, Polonia, Portogallo, Romania, Slovacchia, Slovenia, Spagna, Svezia.

  • Membri non appartenenti all'Unione europea, ma solo a SEE/EFTA o unione doganale: [Solo SEE/EFTA] Islanda, Liechtenstein e Norvegia; Svizzera: [Unione doganale dell'UE] tutte le Isole del Canale, Isola di Man, Monaco; Zone britanniche di sovranità a Cipro; [Unione doganale europea] Andorra, San Marino, Città del Vaticano.

  • Membri non appartenenti all'Unione europea, ma parte delle regioni ultraperiferiche (OMR): Martinica, Mayotte, Guadalupa, Guyana francese, Riunione, Saint-Martin, Madeira, Azzorre, Isole Canarie.
  • Regno Unito (tutte le isole britanniche)

Istruzioni dettagliate

1. Selezione dell'URL o della Pagina

Seleziona l'URL di un sito web da usare con il plug-in dei commenti.

2. Configuratore di codici

Copia e incolla l'URL nel configuratore di codici di seguito. Puoi modificare le impostazioni come width del plug-in dei commenti o il numero di post da mostrare per impostazione predefinita (num_posts). Clicca sul pulsante Ottieni il codice per generare il codice del plug-in dei commenti.

3. Copia e incollamento dello snippet di codice

Copia e incolla lo snippet di codice nell'HTML del sito o della pagina web in cui desideri implementare i commenti.

Generatore di codici del plug-in dei commenti

URL per i commenti
Larghezza
Numero di post

Impostazioni

Il configuratore di codici descritto in precedenza usa solo un sottoinsieme di tutte le possibili impostazioni del plug-in dei commenti. Puoi modificare anche le impostazioni seguenti:

Impostazione Attributo HTML5 Descrizione Valore predefinito

colorscheme

data-colorscheme

La combinazione di colori usata dal plug-in dei commenti: può essere "light" o "dark".

"light"

href

data-href

L'URL univoco a cui vengono associati in modo permanente i commenti pubblicati nel plug-in. Tutte le notizie condivise su Facebook che riguardano i commenti pubblicati tramite il relativo plug-in rimanderanno a questo URL.

URL corrente

lazy

data-lazy

true implica l'utilizzo del meccanismo di lazy-loading del browser impostando l'attributo iframe loading="lazy". Ne consegue che il browser non esegue il rendering del plug-in se non è vicino al viewport e potrebbe non essere mai visto. Può essere true o false (impostazione predefinita).

false

mobile

data-mobile

Un valore booleano che indica se mostrare o meno la versione ottimizzata per mobile.

Rilevazione automatica

num_posts

data-numposts

Il numero di commenti da mostrare per impostazione predefinita. Il valore minimo è 1.

10

order_by

data-order-by

L'ordine di visualizzazione dei commenti: può essere "reverse_time" o "time". I vari tipi di ordine sono spiegati nella sezione Ordinamento dei commenti.

"reverse-time"

width

data-width

La larghezza del plug-in dei commenti nella pagina web. Può essere espressa come valore in pixel o come percentuale (ad esempio 100%) per una larghezza variabile. La versione mobile del plug-in dei commenti ignora il parametro relativo alla larghezza, adottandone una di tipo variabile del 100%. La larghezza minima supportata dal plug-in dei commenti è 320 pixel.

550

Ordinamento dei commenti

I commenti sono ordinabili per data mediante il menu in alto a destra nel plug-in dei commenti.

Puoi definire l'ordinamento predefinito tramite l'attributo data-order-by e uno dei valori seguenti:

reverse_time (predefinito)

I commenti vengono mostrati in base all'ordine di pubblicazione inverso, dal più recente al meno recente.

time

I commenti vengono mostrati in base all'ordine di pubblicazione, dal meno recente al più recente.

Modifica della lingua

Puoi modificare la lingua del plug-in dei commenti caricando una versione localizzata di Facebook SDK for Javascript. Durante il caricamento dell'SDK, modifica il valore di src per usare la tua lingua. Ad esempio, puoi sostituire en_US con la tua lingua, come fr_FR per il francese (Francia):

src="https://connect.facebook.net/fr_FR/sdk.js#xfbml=1"

In base alla lingua, potresti dover modificare la larghezza dei plug-in social. Scopri di più su localizzazione e traduzione.

Moderazione dei commenti

Il plug-in dei commenti comprende un efficace strumento di moderazione, che semplifica e rende più veloce la moderazione di più commenti contemporaneamente da parte del tuo team di gestione della community.

Configurazione

Per usare lo strumento di moderazione dei commenti, devi completare le istruzioni sulla configurazione della moderazione.

Istruzioni sulla configurazione della moderazione

Tieni presente che non puoi usare l'API Graph per rispondere ai commenti pubblicati tramite il plug-in dei commenti.


Dashboard

È possibile accedere allo strumento di moderazione in 2 modi:

1. Vista moderatore basata sull'app: accedi a developers.facebook.com/tools/comments. Otterrai una lista di tutte le tue app Facebook che ti consente di moderare tutti i commenti associati alle varie app. Se non utilizzi un'app Facebook con il plug-in dei commenti, non potrai usare questa vista.

2. Vista moderatore basata sulla Pagina: clicca sul link Strumento di moderazione accanto al riquadro dei commenti (vedi lo screenshot sottostante). La vista mostrerà solo i commenti pubblicati su questa pagina web (URL).

Vista moderatore

Gli screenshot seguenti mostrano entrambi i tipi di vista moderatore. Se utilizzi la vista moderatore basata sull'app, il menu ti consente di passare da un'app all'altra.

Nella tabella di moderazione, puoi approvare o nascondere i commenti in base allo stato. Per cambiare lo stato di più commenti, usa le caselle nella colonna sinistra.

1. Vista moderatore basata sulla Pagina

In questa vista moderatore vengono visualizzati tutti i commenti di uno specifico URL.

2. Vista moderatore basata sull'app

In questa vista moderatore vengono visualizzati tutti i commenti dell'app.

3. Lista contrassegnata

I commenti contrassegnati dagli utenti o da Facebook vengono visualizzati qui. La lista può contenere commenti pubblici o nascosti, in base alle impostazioni dell'app e alla modalità con cui sono stati segnalati.

Impostazioni

Puoi definire le impostazioni personalizzate per ciascuna app. Usa il pulsante Impostazioni (in alto a destra nello strumento) per aprire la finestra di dialogo delle impostazioni.


Moderatori

Puoi promuovere altre persone al ruolo di moderatore dei commenti. Inizia a digitare il nome di un amico nella casella di input e l'anteprima di digitazione ti aiuterà a selezionare la persona da nominare moderatore.


Ordina commenti per

Puoi anche decidere come ordinare i commenti. Scopri di più in Ordinamento dei commenti.


Moderazione

Puoi cambiare la visibilità predefinita dei nuovi commenti. Ad esempio, puoi decidere di approvare tutti i nuovi commenti. I commenti non approvati saranno visibili solo per il commentatore fino all'approvazione da parte di un moderatore.

Sono disponibili tre diverse modalità di moderazione:

Tutti

Tutti i commenti saranno pubblici. Verranno visualizzati anche nella tab Controllo.

Chiusa

Tutti i commenti saranno nascosti.

Utenti bloccati

Nella tab Utenti bloccati, i moderatori possono cercare gli utenti bloccati. Se un utente bloccato pubblica un nuovo commento, questo avrà automaticamente una visibilità limitata e sarà visibile nella tab Controllo.


Impostazioni dell'URL

Chiusura di un thread

Puoi chiudere un thread di commenti su qualsiasi URL in cui utilizzi il plug-in dei commenti. In questo modo, le persone non potranno aggiungere nuovi commenti alla discussione in tale pagina web. Puoi chiudere un thread nel menu Impostazioni dell'URL.

Sovrascrittura dell'opzione di chiusura automatica

Se hai abilitato la chiusura automatica, puoi sovrascrivere un thread chiuso e riaprirlo per i commenti. A tale scopo, accedi a Impostazioni dell'URL e attiva l'opzione Override della chiusura automatica. Quindi, imposta lo stato di chiusura desiderato per l'URL sottoposto a moderazione.

Configurazione della moderazione

Per usare lo strumento di moderazione, devi connettere un account o un'app Facebook all'implementazione del plug-in dei commenti.

Configurazione tramite un'app Facebook (metodo preferito)

Se il tuo sito contiene molti riquadri dei commenti, ti consigliamo di indicare come entità di gestione un ID app Facebook in modo che tutti gli amministratori dell'app possano moderare i commenti. In questo modo, viene abilitata un'interfaccia su Facebook che consente di sottoporre facilmente a moderazione tutti i commenti provenienti dai plug-in gestiti dall'ID app.

<meta property="fb:app_id" content="&#123;YOUR_APP_ID&#125;" />

Oltre alle persone che aggiungi utilizzando l'impostazione Moderatori, anche tutti gli amministratori della tua app potranno moderare i commenti, ma solo i moderatori riceveranno le notifiche per i nuovi commenti se le hai abilitate.

Se nel tuo sito implementi più riquadri dei commenti e li colleghi a un'app specificando un ID app, le impostazioni di moderazione scelte si applicheranno a tutti i riquadri dei commenti.

Ad esempio, selezionando l'impostazione di moderazione con visibilità limitata, questa si applicherà a tutti i riquadri dei commenti che appartengono allo stesso ID app. Se desideri applicare impostazioni di moderazione diverse nelle varie aree del sito, devi utilizzare due o più ID app. In questo modo, puoi applicare impostazioni di moderazione diverse per i vari gruppi di riquadri dei commenti.

Puoi specificare fb:app_id o fb:admins, ma non entrambi.

Assegnazione di un account Facebook come amministratore

Per assegnare un account Facebook come amministratore di un'implementazione del plug-in dei commenti, includi il seguente elemento meta nella sezione <head> delle pagine web in cui utilizzerai il plug-in dei commenti:

<meta property="fb:admins" content="&#123;YOUR_FACEBOOK_USER_ID&#125;"/>

Per aggiungere più moderatori e più di un elemento, ciascuno con un ID Facebook:

<meta property="fb:admins" content="&#123;YOUR_FACEBOOK_USER_ID_1&#125;"/>
<meta property="fb:admins" content="&#123;YOUR_FACEBOOK_USER_ID_2&#125;"/>

Contatore dei commenti

Il valore fb:comments-count consente di visualizzare il numero di commenti su un determinato URL in un elemento <span> della tua pagina web. Puoi usare il CSS per impostare lo stile dell'elemento <span> affinché corrisponda al resto del sito web. Nota: questa funzione non è al momento disponibile in HTML5.

Ad esempio, per mostrare il numero di commenti su example.com, usa questo codice:

<span class="fb-comments-count" data-href="https://example.com/"></span>
awesome comments 

In questo modo, verrà visualizzato:

69391 awesome comments

Il numero di commenti relativi a un determinato URL è accessibile mediante l'API Graph. Ad esempio, il numero di commenti su example.com è disponibile mediante la proprietà comment_count nel campo share del nodo dell'URL:

https://graph.facebook.com/v2.4/?fields=share{comment_count}&amp;id=<YOUR_URL>

Webhooks

Puoi configurare i webhooks affinché siano dotati di uno script sul server che riceve notifiche in caso di pubblicazione di un nuovo commento. Per iniziare:

  1. Accedi alla Dashboard gestione app.
  2. Clicca su "+ Aggiungi prodotto" nel menu di navigazione a sinistra.
  3. Nella sezione Webhooks, clicca su "Configura".
  4. Scegli "App" nel menu a discesa.
  5. Clicca sul pulsante "Attiva iscrizione a questo argomento".
  6. Nella finestra di dialogo, inserisci un URL dello script che riceverà le notifiche, ad es. https://example.org/mywebhook.php.
  7. Inserisci un token, ovvero qualsiasi stringa di tua scelta. Quest'ultimo verrà inviato allo script a scopo di verifica.
  8. L'ultimo passaggio della configurazione consiste nel cliccare sul pulsante "Verifica e salva".

Ma prima, diamo un'occhiata alla documentazione su Webhooks per tutti i dettagli sulla modalità di implementazione dello script.

Ecco un rapido esempio dell'aspetto di un semplice mywebhook.php in PHP.

Partendo dalla verifica:

<?php
if ($_GET['hub_verify_token'] === 'make-up-a-token') {
  echo $_GET['hub_challenge'];
}

Questo make-up-a-token corrisponde alla stringa inserita nel passaggio 7 precedente.

A questo punto, i commenti vengono registrati man mano che vengono pubblicati:

file_put_contents(
  'log.txt',
  "\n" . file_get_contents('php://input'),
  FILE_APPEND
);
?>

Tieni presente che $_POST non funziona in PHP, quindi dovrai utilizzare file_get_contents('php://input').

Una volta verificato il webhook, vedrai le voci "plugin_comment" e "plugin_comment_reply" nella sezione Webhooks della tua Dashboard gestione app.

Clicca su "Test" per ricontrollare l'implementazione con un esempio di risposta, quindi seleziona "Attiva iscrizione" per trasmettere in diretta.

Puoi trovare maggiori dettagli sulla risposta nella documentazione di riferimento su Webhooks.