Plugin Comments

Le plugin Comments permet aux personnes de commenter le contenu de votre site à l’aide de leur compte Facebook. Les personnes peuvent également partager leurs activités de commentaire avec leurs amis (et avec les amis de leurs amis) sur Facebook. Le plugin Comments propose également des outils de modération intégrés et un classement social par pertinence.

Configurateur du plugin CommentsModérationParamètresRéglage de la langueQuestions/réponses

Étape par étape

1. Choisir l’URL ou la Page

Choisissez l’URL du site web que vous souhaitez utiliser avec le plugin Comments.

2. Configurateur de code

Copiez puis collez l’URL dans le configurateur de code ci-après. Vous pouvez définir les paramètres tels que l’attribut width (largeur) de votre plugin Comments, ou le nombre de publications que vous voulez afficher par défaut (num_posts). Cliquez sur le bouton Obtenir le code pour créer le code de votre plugin Comments.

3. Copier et coller l’extrait de code

Copiez et collez l’extrait de code dans le code HTML du site web ou de la page web sur lesquels vous souhaitez mettre les commentaires en place.

Générateur de code du plugin Comments

URL à commenter
Largeur
Nombre de publications

Paramètres

Le configurateur de code ci-dessus utilise uniquement un sous-ensemble de tous les paramètres possibles pour votre plugin Comments. Vous pouvez également modifier les paramètres suivants :

Paramètre Attribut HTML5 Description Valeur par défaut

colorscheme

data-colorscheme

Le jeu de couleurs utilisé par le plugin Comments. La valeur peut être light (clair) ou dark (foncé).

"light"

href

data-href

L’URL absolue avec laquelle les commentaires publiés dans le plugin sont associés de manière permanente. Toutes les actualités partagées sur Facebook liées aux commentaires publiés à l’aide du plugin Comments seront associées à cette URL.

URL actuelle.

mobile

data-mobile

Une valeur booléenne qui indique si la version optimisée pour le format web mobile doit être utilisée.

Détecté automatiquement

num_posts

data-numposts

Le nombre de commentaires à afficher par défaut. La valeur minimum est 1.

10

order_by

data-order-by

L’ordre à utiliser pour afficher les commentaires. La valeur peut être social (social), reverse_time (antichronologique) ou time (chronologique). Les différents types d’ordre sont expliqués dans les questions/réponses.

"social"

width

data-width

La largeur du plugin Comments sur la page web. Il peut s’agir d’une valeur en pixels ou d’un pourcentage (comme la valeur 100 %) pour que la largeur soit adaptative. La version mobile du plugin Comments ignore le paramètre de largeur et utilise la valeur 100 % pour que la largeur soit adaptative. La largeur minimale prise en charge par le plugin Comments est de 320 pixels.

550

Ordre de tri des commentaires

Les personnes peuvent trier les commentaires en fonction de l’heure ou du classement social à l’aide du menu situé en haut à droite du plugin Comments.

Vous pouvez définir l’ordre de tri par défaut à l’aide de l’attribut data-order-by et de l’une des trois valeurs suivantes :

social (par défaut)

On la connaît également sous le nom de « Meilleurs ». Le plugin Comments utilise des mesures sociales pour afficher en premier les commentaires de plus haute qualité. Les commentaires sont triés de manière à afficher en premier les commentaires les plus pertinents des amis et des amis d’amis, ainsi que les fils de discussion les plus actifs ou ayant le plus de mentions J’aime. Les commentaires signalés comme indésirables sont masqués.

Remarque : les fils de commentaires obsolètes, notamment ceux associés à un objet Open Graph créé avant le lancement original du plugin Comments, ne pourront pas être triés par pertinence sociale.

time

Les commentaires sont affichés dans l’ordre dans lequel ils ont été publiés, les plus anciens au début et les plus récents à la fin.

reverse_time

Les commentaires sont affichés dans l’ordre inverse dans lequel ils ont été publiés, les plus récents au début et les plus anciens à la fin.

Réglage de la langue

Vous pouvez modifier la langue du plugin Comments en chargeant une version localisée du SDK Facebook pour JavaScript. Lorsque vous chargez le SDK, modifiez la valeur js.src en la remplaçant par votre paramètre régional. Par exemple, remplacez en_US par votre paramètre régional, comme fr_FR pour le français (France) :

js.src = "//connect.facebook.net/fr_FR/sdk.js#xfbml=1&version=v2.4";

Les paramètres régionaux pris en charge sont répertoriés dans le fichier XML de paramètres régionaux de Facebook.

Vous devrez peut-être modifier la largeur d’un Social Plugin si vous voulez afficher plusieurs langues. En savoir plus sur la localisation et la traduction.

Modération des commentaires

Le plugin Comments contient un puissant outil de modération. Cet outil permet à votre équipe de gestion de la communauté de modérer rapidement et facilement plusieurs commentaires à la fois.

Configuration

Pour utiliser l’outil de modération de commentaires, vous devez suivre les instructions de configuration de la modération.

Instructions de configuration de la modération

Veuillez noter que vous ne pouvez pas utiliser l’API Graph pour répondre aux commentaires fournis via le plugin Commentaires.


Tableau de bord

Il existe deux façons de parcourir l’outil de modération :

1. Vue modération par application : accédez à developers.facebook.com/tools/comments. Vous trouverez une liste de toutes vos applications Facebook et pourrez modérer tous les commentaires liés à chaque application. Si vous n’utilisez pas d’application Facebook pour votre plugin Comments, vous ne pourrez pas utiliser cette vue.

2. Vue modération par page : cliquez sur le lien Outil de modération à côté d’une zone de commentaires (voir la capture d’écran ci-dessous). La vue n’affiche que les commentaires publiés sur cette page web (URL).

Vue modération

Les deux vues de modération sont illustrées dans les captures d’écran ci-dessous. Si vous utilisez la vue modération par application, vous pouvez utiliser le menu pour sélectionner une application.

Dans le tableau de modération, vous pouvez soit approuver, soit masquer les commentaires en fonction de leur statut. Pour modifier le statut de plusieurs commentaires, utilisez les cases dans la colonne de gauche.

1. Vue modération par page

Dans cette vue modération, tous les commentaires d’une URL particulière seront affichés.

2. Vue modération par application

Dans cette vue modération, tous les commentaires de votre application seront affichés.

3. File d’attente signalée

Les commentaires signalés par les utilisateurs ou par Facebook seront affichés ici. Les commentaires de cette liste peuvent être publics ou masqués en fonction des paramètres des applications ou de la façon dont ils ont été signalés.

4. Ma file d’attente

Afin de mieux partager le travail entre les développeurs, vous pouvez utiliser cette fonctionnalité pour vous attribuer des commentaires à modérer. Les autres modérateurs et administrateurs auront toujours accès aux commentaires attribués ici, mais les commentaires de votre file d’attente n’apparaîtront pas dans celle des autres.

Paramètres

Pour chaque application, vous pouvez définir des paramètres personnalisés. Utilisez le bouton Paramètres (en haut à droite de l’outil) pour ouvrir la fenêtre des paramètres.


Modérateurs

Vous pouvez autoriser d’autres personnes à modérer vos commentaires. Commencez à saisir le nom d’un de vos amis dans la zone de saisie. Une liste de suggestions vous aidera à sélectionner la personne que vous voulez ajouter comme modérateur.


Trier les commentaires par

Vous pouvez également contrôler le tri des commentaires. Pour en savoir plus, consultez Ordre de tri des commentaires.


Modération

Vous pouvez modifier la visibilité par défaut des nouveaux commentaires. Par exemple, vous pouvez approuver tous les nouveaux commentaires. Si un commentaire n’est pas approuvé, il n’est visible que par son auteur, jusqu’à ce qu’un modérateur l’approuve.

Il existe trois modes de modération différents :

Public

Tous les commentaires sont publics. Ils apparaissent également dans l’onglet Révision.

Fermé

Tous les commentaires sont masqués.

Utilisateurs bannis

Dans l’onglet Utilisateurs bannis, les modérateurs peuvent rechercher les utilisateurs bannis. Si un nouveau commentaire est publié par un utilisateur banni, sa visibilité est automatiquement restreinte et il s’affiche dans l’onglet Révision.


La mise en miroir des commentaires est abandonnée avec la sortie de la version 4.28.0 du SDK Facebook. Elle sera prise en charge jusqu’au 5 février 2018.

Mise en miroir des commentaires

La mise en miroir des commentaires permet aux utilisateurs de participer à une conversation unique qui comprend les commentaires issus de votre page web et ceux de votre Page Facebook. Lorsque vous partagez un lien de votre site web sur votre Page Facebook, les commentaires de votre page web apparaissent également en tant que commentaires sur la publication de votre Page Facebook et inversement. L’affichage des commentaires sur votre Page Facebook et sur votre site web crée une conversation plus riche.

Vous pouvez activer la mise en miroir des commentaires dans l’outil de modération en accédant à l’onglet Paramètres. Afin d’activer la mise en miroir des commentaires, vous devez être l’administrateur de la Page Facebook pour laquelle vous souhaitez autoriser la mise en miroir.

Si vous souhaitez autoriser les personnes à inclure des photos dans leurs commentaires (avec mise en miroir des commentaires activée), vous devez également activer la fonction Autoriser les visiteurs de la Page à publier pour votre Page. Pour que les commentaires soient correctement mis en miroir, votre Page Facebook doit être rendue publique et accessible à tous.

La mise en miroir des commentaires prend effet sur les nouvelles pages web créées après que ce paramètre ait été activé. Lorsque la mise en miroir des commentaires est activée pour une page web particulière, vous ne pouvez pas la désactiver (sauf pour les pages web à venir). Par conséquent, si la fonctionnalité de fermeture automatique est activée et est partagée sur votre Page Facebook, de nouveaux commentaires peuvent toujours être rédigés à partir de la publication de la Page Facebook, mais pas à partir de votre page web.

Les personnes sauront-elles que nous mettons les commentaires en miroir ? Lorsqu’une personne commence à saisir un commentaire sur votre site web, un message s’affiche pour l’informer que son commentaire apparaîtra également sur votre Page Facebook. Le même message s’affiche lorsque quelqu’un commente un article publié sur votre Page Facebook.


Comment la modération fonctionne-t-elle ? Tous les commentaires, qu’ils soient laissés sur la publication d’une Page Facebook ou sur l’article original de votre site web, apparaissent dans l’outil principal de modération des commentaires de Facebook. Tous les commentaires affichés sur la page de l’article peuvent donc être modérés. Si vous masquez un commentaire dans l’outil de modération, il sera automatiquement masqué sur la Page Facebook.

Paramètres URL

Fermeture d’un fil

Vous pouvez fermer un fil de commentaires sur n’importe quelle URL lorsque vous utilisez le plugin Comments. De cette façon, les personnes ne peuvent pas ajouter de commentaires à la discussion sur cette page web. Vous pouvez fermer un fil dans le menu Paramètres de l’URL.

Contournement de la fermeture automatique

Si vous avez activé la fermeture automatique, vous pouvez contourner le fil fermé et ainsi réactiver les commentaires. Pour ce faire, accédez au menu Paramètres de l’URL et activez Écraser la fermeture automatique. Définissez ensuite l’état de fermeture choisi pour l’URL modérée.

Configuration de la modération

Pour utiliser l’outil de modération, vous devez connecter votre plugin Comments à un compte ou à une application Facebook.

Configuration à l’aide d’une application Facebook (recommandé)

Si votre site dispose de plusieurs zones de commentaire, nous vous recommandons de définir un ID d’app Facebook en tant qu’entité gestionnaire, ce qui signifie que tous les administrateurs de l’application pourront alors modérer les commentaires. Cela active une interface de modération sur Facebook, où tous les commentaires des plugins gérés par votre ID d’app peuvent être modérés ensemble.

<meta property="fb:app_id" content="{YOUR_APP_ID}" />

En plus des personnes que vous ajoutez avec le paramètre Modérateurs, tous les administrateurs de votre app pourront également modérer les commentaires, mais seuls les modérateurs reçoivent des notifications de nouveaux commentaires si vous avez activé les notifications.

Lorsque vous placez plusieurs zones de commentaire sur votre site et que vous les connectez à une application en précisant un ID d’app, les paramètres de modération que vous choisissez s’appliquent à toutes les zones de commentaire.

Par exemple, si vous définissez une visibilité limitée pour le paramètre de modération, cela s’applique à toutes les zones de commentaire gérées par l’ID d’app. Si vous devez appliquer différents paramètres de modération à différentes zones de votre site, utilisez au moins deux ID d’app. Vous pouvez ensuite appliquer des paramètres de modération distincts aux différents groupes de zones de commentaire.

Vous pouvez choisir fb:app_id ou fb:admins, mais pas les deux.

Définir un compte Facebook comme administrateur

Pour définir un compte Facebook en tant qu’administrateur d’un plugin Comments, il vous suffit d’inclure l’élément méta suivant dans la section <head> de chaque page web dans laquelle vous utilisez le plugin Comments :

<meta property="fb:admins" content="{YOUR_FACEBOOK_USER_ID}"/>

Pour ajouter plusieurs modérateurs, ajoutez plusieurs éléments, ayant chacun un identifiant Facebook :

<meta property="fb:admins" content="{YOUR_FACEBOOK_USER_ID_1}"/>
<meta property="fb:admins" content="{YOUR_FACEBOOK_USER_ID_2}"/>

Compteur de commentaires

L’utilisation de la valeur fb:comments-count affiche le nombre de commentaires d’une URL donnée dans un élément <span> de votre page web. Vous pouvez ensuite utiliser CSS pour modifier cet élément <span> afin qu’il corresponde au reste de votre site web. Sachez que cette fonctionnalité n’est pas encore disponible en HTML5.

Par exemple, pour afficher le nombre de commentaires sur exemple.com, utilisez ce code :

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

S’affichera ceci :

69391 awesome comments

Vous pouvez accéder au nombre de commentaires sur une URL particulière à l’aide de l’API Graph. Par exemple, le nombre de commentaires sur exemple.com est disponible à l’aide de la propriété comment_count sur le champ share (partager) du nœud d’URL :

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

Webhooks

Vous pouvez configurer des webhooks pour qu’un script sur votre serveur soit notifié lorsqu’un nouveau commentaire est publié. Pour commencer :

  1. Accédez à votre Espace App.
  2. Cliquez sur + Ajouter un produit dans le menu de navigation de gauche.
  3. Dans la section Webhooks, cliquez sur Configurer.
  4. Dans le menu déroulant, choisissez Application.
  5. Cliquez sur le bouton S’inscrire à ce sujet.
  6. Dans la boîte de dialogue, entrez une URL du script qui recevra les notifications, par exemple https://example.org/mywebhook.php
  7. Entrez un token, n’importe quelle chaîne. Il sera envoyé à votre script pour vérification.
  8. Dernière étape : la configuration consiste à cliquer sur le bouton Vérifier et enregistrer.

Mais avant cela, consultez la documentation Webhooks pour connaître tous les détails relatifs à l’implémentation de votre script.

Voici un court exemple de ce à quoi un simple mywebhook.php peut ressembler dans PHP.

Commencer avec la vérification :

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

make-up-a-token est la même chaîne que vous avez entrée à l’étape 7 ci-dessus.

Consignez ensuite tous les commentaires tels qu’ils sont publiés :

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

Notez que dans PHP, $_POST ne fonctionnera pas, vous avez besoin de file_get_contents('php://input')

Une fois votre webhook vérifié, vous verrez « plugin_comment » et « plugin_comment_reply » dans la section Webhooks de votre Espace App.

Cliquez sur Tester pour revérifier votre implémentation avec un exemple de réponse, puis sur S’abonner pour diffuser.

Plus de détails sur la réponse disponibles dans la documentation Référence Webhooks.