Plugin Commentaires

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

Étape par étape

1. Choisir l’URL ou la Page

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

2. Configurateur de code

Copiez-collez l’URL dans le configurateur de code ci-dessous. Vous pouvez ajuster certains paramètres comme l’attribut width (largeur) de votre plugin Commentaires 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 Commentaires.

3. Copier-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 Commentaires

Paramètres

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

Ordre de tri des commentaires

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

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

reverse_time (par défaut)

Les commentaires sont affichés dans l’ordre inverse de leur publication, les plus récents au début et les plus anciens à la fin.

time

Les commentaires sont affichés dans l’ordre de leur publication, les plus anciens au début et les plus récents à la fin.

Modification de la langue

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

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

Vous devrez peut-être modifier la largeur d’un plugin social en fonction de la langue choisie. En savoir plus sur la localisation et la traduction.

Modération des commentaires

Le plugin Commentaires 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 des commentaires, vous devez suivre les instructions de configuration de la modération.

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 Commentaires, vous ne pourrez pas utiliser cette vue.

2. Vue modération par page : cliquez sur le lien Outil de modération à côté d’un espace 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 marquée

Les commentaires marqué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é marqués.

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érateur·trices

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·trice.

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·e modérateur·trice 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érateur·trices 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.

Paramètres de l’URL

Fermeture d’un fil

Vous pouvez fermer un fil de commentaires sur n’importe quelle URL lorsque vous utilisez le plugin Commentaires. 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 Commentaires à un compte ou à une application Facebook.

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

Si votre site dispose de plusieurs espaces Commentaires, nous vous recommandons de définir un ID d’app Facebook en tant qu’entité gestionnaire, ce qui signifie que tou·tes les admins 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="&#123;YOUR_APP_ID&#125;" />

En plus des personnes que vous ajoutez avec le paramètre Modérateur·trices, tou·tes les admins de votre app pourront également modérer les commentaires, mais seul·es les modérateur·trices reçoivent des notifications de nouveaux commentaires si vous avez activé les notifications.

Lorsque vous placez plusieurs espaces Commentaires 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 à tous les espaces Commentaires.

Par exemple, si vous définissez une visibilité limitée pour le paramètre de modération, cela s’applique à tous les espaces Commentaires gérés 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 d’espaces Commentaires.

Définir un compte Facebook comme admin

Pour définir un compte Facebook en tant qu’admin d’un plugin Commentaires, 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 Commentaires :

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

Pour ajouter plusieurs modérateur·trices, ajoutez plusieurs éléments, ayant chacun un identifiant 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;"/>

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> pour l’accorder avec le 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="https://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 l’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. La dernière étape de 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 en 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 à mesure qu’ils sont publiés :

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

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 activer le webhook.

Pour plus d’informations sur la réponse, consultez la documentation Référence Webhooks.