FastComments.com
Menu Icon

Langue 🇫🇷 Français (France)
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇺🇸 English (US) 🇨🇦 Français (Canada) 🇫🇷 Français (France) 🇩🇪 Deutsch 🇨🇾 Ελληνικά (Κύπρος) 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇺🇦 Русский (Украина) 🇧🇦 Српски (БиХ) 🇷🇸 Srpski (Latinica) 🇲🇪 Српски (Црна Гора) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

En bref

Démarrage rapide

Installation de Drupal

Installation
Configuration
Blocs de widgets
Champs des types de contenu
Authentification unique (SSO)
Permissions
Multilingue
Résidence des données dans l'UE
Personnalisation
Prérequis

Add Live Commenting to Drupal Sites

Démarrage rapide Internal Link

Ceci est la version « trop longue ; pas lu » des instructions pour Drupal.

  1. Installez le module avec composer require drupal/fcom, ou déposez-le dans modules/custom/fastcomments/.
  2. Activez-le avec drush en fastcomments, ou depuis l'interface d'administration à /admin/modules.
  3. Allez dans Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Saisissez votre Tenant ID et API Secret depuis Settings > API/SSO (EU).
  5. Ajoutez le champ FastComments à n'importe quel type de contenu via Structure > Content types > [type] > Manage fields.

Le module est publié sur drupal.org/project/fcom.

Installation Internal Link

Le module FastComments pour Drupal remplace les commentaires intégrés de Drupal par un système de commentaires rapide et en temps réel. Le module est publié sur drupal.org et fonctionne avec Drupal 10 et 11.

Il existe deux manières de l'installer.

Installation avec Composer

composer require drupal/fcom
drush en fastcomments

Installation manuelle

Téléchargez le module depuis drupal.org/project/fcom et placez-le dans le répertoire modules/custom/fastcomments/ de votre site. Ensuite, activez-le avec drush en fastcomments, ou depuis l'interface d'administration à Extend (/admin/modules).

Remarque ! Le module ne dépend que du noyau de Drupal (user et field). Aucun autre module Drupal ou bibliothèque n'est requis.

Une fois le module activé, rendez-vous dans la section Configuration pour configurer votre Tenant ID et API Secret.

Configuration Internal Link

Tous les paramètres se trouvent sous Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Requis

  • Tenant ID - Votre Tenant ID FastComments. Trouvez-le sous Settings > API/SSO (EU).
  • API Secret - Nécessaire pour le SSO sécurisé, la vérification des webhooks et la synchronisation des pages. Trouvé sous Settings > API/SSO (EU).

Style de commentaires

Choisissez le widget qui correspond à la façon dont vous voulez que les gens discutent sur votre site.

  • Live Comments - Commentaires filaires en temps réel.
  • Streaming Chat - Interface de chat en direct, idéale pour les événements et les livestreams.
  • Collab Chat - Annotation par sélection de texte sur la zone de contenu principale. Les visiteurs surlignent le texte et démarrent une discussion dans son contexte.
  • Collab Chat + Comments - À la fois collab chat et commentaires standard sur la même page.

Mode SSO

  • None - Pas de SSO. Les utilisateurs commentent en tant qu’invités ou créent un compte FastComments.
  • Simple - Transmet les infos utilisateur Drupal (nom, email, avatar) à FastComments sans vérification côté serveur.
  • Secure - Utilise HMAC-SHA256 pour vérifier les utilisateurs Drupal avec FastComments. Recommandé lorsque vous avez configuré un API Secret.

Voir la section Single Sign-On (SSO) pour les détails.

Autres paramètres

  • CDN URL - Par défaut https://cdn.fastcomments.com.
  • Site URL - Par défaut https://fastcomments.com.
  • Email notifications - Envoyer un email à l’auteur du contenu lorsqu’un nouveau commentaire est publié sur son contenu.

Pour la résidence des données dans l’UE, voir la section EU Data Residency.

Blocs de widgets Internal Link

Le module propose plusieurs blocs que vous pouvez placer depuis Structure > Block layout (/admin/structure/block).

  • FastComments Widget - Le widget de commentaires principal. Il détecte automatiquement l'entité actuelle. Il ignore les entités qui ont déjà le champ FastComments attaché, de sorte que vous ne verrez pas de widgets en double sur la même page.
  • FastComments Live Chat - Chat en streaming en temps réel. Peut être placé à côté du champ de commentaire sur la même page.
  • FastComments Collab Chat - Annotation et discussion par sélection de texte.
  • FastComments Image Chat - Annotation basée sur des coordonnées sur les images. Les visiteurs cliquent sur une image pour laisser des commentaires liés à des emplacements précis.
  • FastComments Recent Comments - Affiche les commentaires récents sur votre site. Le nombre est configurable sur le bloc.
  • FastComments Top Pages - Affiche les pages de votre site ayant le plus de commentaires.

Les blocs centrés sur le contenu (Live Chat, Collab Chat, Image Chat) détectent automatiquement l'entité courante et utilisent un identifiant basé sur le chemin pour les pages qui ne correspondent pas à une entité. Cela signifie qu'ils fonctionnent sur les pages de taxonomie, les vues et les routes personnalisées sans configuration supplémentaire.

Champs des types de contenu Internal Link

Pour la plupart des sites, la façon la plus simple d'ajouter des commentaires est d'attacher le champ FastComments à vos types de contenu. Allez dans Structure > Content types > [type] > Manage fields et ajoutez le champ.

Chaque entité qui possède ce champ reçoit :

  • Une bascule d'état permettant aux éditeurs d'activer ou de désactiver les commentaires pour chaque entité.
  • Un identifiant personnalisé optionnel afin que vous puissiez utiliser un ID stable qui n'est pas lié au chemin de l'entité Drupal.

Le bloc principal FastComments Widget connaît ce champ et ignorera les entités qui l'ont déjà attaché. De cette façon, vous pouvez mélanger des commentaires par entité avec le bloc sans voir le widget deux fois sur la même page.

Authentification unique (SSO) Internal Link

FastComments s'intègre au système d'utilisateurs de Drupal via SSO, ou authentification unique. Vos utilisateurs se connectent à votre site Drupal, et le module transmet automatiquement leur identité à FastComments. Aucun compte supplémentaire à créer, aucune synchronisation initiale à effectuer.

Le module prend en charge trois modes SSO, configurés sous Administration > Configuration > Content > FastComments.

Aucun

Pas de SSO. Les utilisateurs commentent en tant qu'invités ou créent un compte FastComments. Utilisez ceci si votre site est public et que vous n'avez pas besoin d'associer les commentaires aux utilisateurs Drupal.

Simple

Transmet le nom, l'email et l'avatar de l'utilisateur Drupal à FastComments sans vérification côté serveur. Aucun API Secret n'est nécessaire. Adapté aux sites internes ou à faible risque.

Sécurisé (recommandé)

Utilise HMAC-SHA256 pour vérifier chaque identité utilisateur avec FastComments. C'est le mode recommandé lorsque vous avez configuré un API Secret, et c'est le seul mode qui empêche un visiteur d'usurper l'identité d'un autre utilisateur.

L'identité de l'utilisateur est transmise à FastComments chaque fois qu'un utilisateur consulte un fil de commentaires. Il n'y a pas de synchronisation initiale ou continue à exécuter.

(Optionnel) Ajoutez vos administrateurs à Utilisateurs & Administrateurs et vos modérateurs à Modérateurs de commentaires pour améliorer leur expérience et activer le suivi des statistiques pour les modérateurs.

Pour une analyse plus approfondie du fonctionnement du SSO, consultez la section SSO de la documentation sur les personnalisations.

Permissions Internal Link

Le module ajoute trois autorisations Drupal que vous pouvez attribuer par rôle sous People > Permissions.

  • Administer FastComments - Accès au formulaire de configuration de FastComments à /admin/config/content/fastcomments.
  • View FastComments - Requise pour voir le widget de commentaires. Sans cette autorisation, le widget ne s'affiche pas.
  • Toggle FastComments - Permet aux utilisateurs d'activer ou de désactiver les commentaires au niveau de chaque entité en utilisant le widget de champ.

Par défaut, seuls les utilisateurs disposant de l'autorisation administer site configuration peuvent modifier les paramètres de FastComments. Accordez View FastComments aux utilisateurs anonymes et authentifiés si vous voulez que les visiteurs voient le widget.

Multilingue Internal Link

Le module transmet automatiquement la langue actuelle du site Drupal à chaque widget FastComments. Si votre site Drupal est configuré pour plusieurs langues, l'interface de commentaires s'affichera dans la langue correspondante sans configuration supplémentaire.

Cela s'applique à tous les types de widgets : Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, et Top Pages.

Résidence des données dans l'UE Internal Link

Si votre compte FastComments est hébergé dans l'UE, mettez à jour deux paramètres dans Administration > Configuration > Content > FastComments:

  • CDN URL - https://cdn-eu.fastcomments.com
  • Site URL - https://eu.fastcomments.com

Vous devrez également récupérer votre Tenant ID et API Secret depuis le tableau de bord UE à eu.fastcomments.com/auth/my-account/api plutôt que depuis le tableau de bord américain par défaut. Tout le reste du module fonctionne de la même manière.

Personnalisation Internal Link

FastComments est conçu pour être personnalisé afin de s'adapter à votre site.

Si vous souhaitez ajouter des styles personnalisés, ou ajuster la configuration, Consultez notre documentation sur la personnalisation et la configuration pour savoir comment.

Prérequis Internal Link

  • Drupal 10 ou 11
  • PHP 8.1 ou plus récent
  • Un compte FastComments

Le module ne nécessite aucun autre module Drupal ni bibliothèque tierce. Il ne dépend que du noyau Drupal (user, field).

Une solution de repli <noscript> fournit des commentaires rendus côté serveur pour les visiteurs sans JavaScript, de sorte que Live Comments et Streaming Chat fonctionnent toujours sur les navigateurs avec le scripting désactivé.

Contribuer à ce guide