Commento est une interface de commentaires rapide et légère qui peut être intégrée à votre site web. Il offre une expérience de commentaires moderne aux lecteurs sans le surplomb des plateformes de commentaires plus lourdes.
Intégrer Commento avec Document360 permet aux lecteurs de laisser des commentaires et des discussions directement sur vos articles de base de connaissances.
Avant que tu commences
- Il te faut un compte Commento.
Comment intégrer Commento avec Document360
Il existe deux façons d’intégrer Commento avec Document360.
Intégration native
- Dans le portail Document360, naviguez jusqu’à Connexions () > Intégrations () dans la barre de navigation de gauche.
- Depuis la section Commentaires, sélectionnez Commentaire et cliquez sur Ajouter.
- Dans le panneau Ajouter une nouvelle intégration , saisissez une Description.
- En option, il faut étendre les conditions d’inclusion/exclusion de code pour contrôler quand l’intégration s’exécute en fonction de l’adresse IP, de l’espace de travail ou du langage.
- Cliquez sur Ajouter.
Après la configuration, ouvrez votre compte Commento pour consulter les analyses Commento. Vous pouvez aussi importer des commentaires existants depuis Disqus si vous l’utilisiez auparavant.
Extrait HTML personnalisé
Utilisez cette méthode pour intégrer Commento en utilisant son code Universal Snippet via l’intégration HTML personnalisée dans Document360.
- Dans votre compte Commento, ouvrez l’onglet Staging .
- Cliquez sur Guide d’installation.
- Dans le code HTML affiché sous la section Extraits universels , remplacez l’URL par le domaine de votre projet Document360.
- Copie du extrait de code.
- Dans le portail Document360, naviguez dans Connexions () > Intégrations () dans la barre de navigation de gauche.
- Dans la section HTML personnalisé , cliquez sur Ajouter.
- Collez le code copié dans le champ de code.
- Sous Insérer le code, sélectionnez À la fin du corps (ci-dessous
</body>). - Cliquez sur Ajouter.
Commento est désormais intégré à votre base de connaissances Document360.
Meilleures pratiques
- Utilisez une intégration native pour une configuration plus simple. L’intégration native ne nécessite pas de code, juste une description. Il vous donne également accès directement aux conditions d’inclusion/exclusion du Code dans Document360.
- Utilisez un extrait HTML personnalisé si vous avez besoin de plus de contrôle sur le placement des extraits. L’approche Universal Snippet vous permet de contrôler exactement où Commento se charge sur la page et est utile si vous rencontrez des problèmes avec l’intégration native.
- Importez les commentaires Disqus existants après la configuration. Si vous migrez depuis Disqus, utilisez la fonction d’importation de Commento pour afficher les commentaires existants afin que les lecteurs ne perdent pas les discussions précédentes.
- Utilisez des conditions d’inclusion/exclusion de code pour autoriser les commentaires uniquement sur certains espaces de travail. Si les commentaires ne doivent apparaître que sur certains espaces de travail ou langues, configurez les conditions dans l’intégration native pour limiter l’exécution de l’image.
FAQ
Que dois-je faire lorsque « Ce domaine n’est pas enregistré chez Commento » apparaît sur mon site de base de connaissances ?
Ce message apparaît lorsque l’intégration Commento est active mais que le domaine n’a pas été enregistré dans Commento. Pour empêcher l’apparition du message, allez dans Connexions () > Intégrations () dans le portail Document360 et désactivez le bouton Commento. Ensuite, enregistrez votre domaine dans les paramètres de votre compte Commento avant de réactiver l’intégration.
Quelle est la différence entre l’intégration native et un extrait HTML personnalisé ?
L’intégration native utilise l’intégration native Commento dans Document360, qui est plus simple à configurer et prend en charge les conditions d’inclusion/exclusion du code. Un extrait HTML personnalisé utilise le extrait universel de commentaire via l’intégration HTML personnalisée, ce qui vous donne plus de contrôle sur la manière et l’endroit où le script est intégré sur la page.
Puis-je importer des commentaires de Disqus dans Commento ?
Oui. Après avoir terminé l’intégration Commento, ouvrez votre compte Commento et utilisez sa fonction d’importation pour intégrer les commentaires existants de Disqus. Cela vous permet de migrer les discussions des lecteurs précédents sans les perdre.
Puis-je limiter les espaces de travail ou les langues sur lesquels Commento apparaît ?
Oui, en utilisant une intégration native. Lors de l’ajout ou de la modification de l’intégration Commento, déplacez les conditions d’inclusion/exclusion de code et ajoutez des conditions basées sur l’adresse IP, l’espace de travail ou la langue. Voir les conditions d’inclusion et d’exclusion du Code pour tous les détails.