Comprendre comment GraphComment relie les commentaires à vos pages

Lorsque vous installez GraphComment sur votre site, chaque commentaire posté est automatiquement rattaché à une page spécifique. Cette association repose sur une hiérarchie d’identifiants qui permet à GraphComment de retrouver les bons commentaires, même si certaines choses changent sur votre site.

1. Le GUID (automatique avec WordPress)

Si vous utilisez notre plugin officiel pour WordPress, GraphComment se base automatiquement sur le GUID : un identifiant permanent généré par WordPress (souvent basé sur l'URL d’origine). Ce système est robuste, car même si vous changez l’URL visible, le GUID ne change pas et les commentaires restent bien associés à la page. Dans ce cas, vous n’aviez rien à faire, tout est géré automatiquement.

2. L'UID (identifiant unique défini par vous)

Si vous n’utilisez pas WordPress ou que vous souhaitez gérer manuellement la liaison entre vos pages et les commentaires, vous pouvez définir un UID personnalisé dans le snippet JavaScript (la portion de code d’intégration).

Exemple de snippet avec UID :

💡 Dans le code ci-dessous, tout le texte qui se trouve après les doubles slash // sont des « commentaires du code". C’est une manière d’avoir des notes qui expliquent ce que fait le code, mais elles ne sont pas exécutées par l’ordinateur. Elles servent uniquement à aider les humains à comprendre le code.

<div id="graphcomment"></div>
<script type="text/javascript">
  var __semio__params = {
    graphcommentId: "demo-gc", // Remplacez par votre ID GraphComment
    behaviour: {
      uid: "article-987654", // UID unique pour cette page
    },
  };

  function __semio__onload() {
    __semio__gc_graphlogin(__semio__params);
  }

  (function() {
    var gc = document.createElement('script');
    gc.type = 'text/javascript';
    gc.async = true;
    gc.onload = __semio__onload;
    gc.defer = true;
    gc.src = 'https://integration.graphcomment.com/gc_graphlogin.js?' + Date.now();
    (document.head || document.body).appendChild(gc);
  })();
</script>

Utiliser un UID est vivement recommandé, car il garantit que les commentaires restent associés à la bonne page même si vous modifiez son URL.

3. L'URL (par défaut si rien n’est défini)

Si vous ne définissez ni GUID ni UID, GraphComment utilise automatiquement l’URL actuelle dans le navigateur pour attacher les commentaires. C’est simple mais risqué : au moindre changement de cette URL (ajout d’un paramètre, d’un slash, etc.), les commentaires seront considérés comme liés à une nouvelle page.

Exemple :

Avant : https://monsite.com/article-super
Après : https://monsite.com/article-super?version=2

➡️ Les commentaires ne s’afficheront plus car l’URL n’est plus exactement la même.

Cas fréquents à problème : Google Sites, iframes, etc.

Certains outils comme Google Sites ou l’usage d’iframes compliquent le bon fonctionnement de la liaison entre page et commentaires.

🔍 Une iframe est une page web intégrée à l’intérieur d’une autre page. C’est comme une fenêtre dans une fenêtre.

Pourquoi c’est problématique ?

L’URL vue par l’utilisateur n’est pas forcément celle utilisée dans l’iframe.
Certaines pages (notamment sur Google Sites) contiennent des iframes imbriquées, ce qui rend le suivi très difficile.

✅ Dans ces cas, il est obligatoire d’utiliser un UID personnalisé pour assurer la fiabilité du système.

Que faire si les commentaires ne s'affichent plus sur ma page ?

Vous avez déplacé un article, changé de CMS, ou modifié l’URL ? Les commentaires peuvent sembler « perdus » mais ne le sont pas forcément.

Dans votre interface d’administration GraphComment, l’onglet PAGES vous permet de voir toutes les pages détectées par le système, ainsi que les commentaires associés.

Voici ce que vous pouvez faire :

Rechercher une ancienne page avec ses anciens identifiants (UID ou URL).
Modifier manuellement l'UID ou l'URL de la page pour rétablir la liaison avec les bons commentaires.

Attention ⚠️

Ne donnez jamais le même UID à deux pages différentes, sinon les commentaires seront mélangés.
Si vous avez beaucoup de pages, la modification manuelle est possible mais fastidieuse.

Exemple en cas de migration de site :

Allez dans l’onglet PAGES de l’admin GraphComment.
Cherchez la page concernée (avec l’ancien UID ou l’ancienne URL).
Cliquez sur ✏️ pour modifier les infos.
Renseignez le nouvel UID ou la nouvelle URL utilisée.
Enregistrez avec Save.

✅ Les commentaires réapparaîtront instantanément.

⚠️ Il n’est pas encore possible de fusionner deux fils de commentaires de deux pages différentes.

Exemples pratiques avancés : insérer dynamiquement un UID

En PHP (ex. WordPress) :

behaviour: {
  uid: "<?php echo 'article-' . $post->ID; ?>",
},

En JavaScript :

var articleId = "123456";
var __semio__params = {
  graphcommentId: "demo-gc",
  behaviour: {
    uid: "article-" + articleId,
  },
};

➡️ Ces méthodes permettent d’automatiser l’attribution des UID pour chaque page, ce qui est très utile sur des sites dynamiques ou lors d’une intégration dans un CMS personnalisé.

En résumé

Utilisez de préférence un UID pour chaque page.
Le GUID WordPress est fiable si vous utilisez notre plugin.
Évitez de vous baser uniquement sur l’URL, surtout si votre site est amené à évoluer.
En cas de besoin, l’onglet PAGES de votre interface vous permet de rétablir les liens manuellement.

Besoin d’aide ? N’hésitez pas à contacter notre support 😊