FastComments.com
Menu Icon

Langue 🇨🇦 Français (Canada)
🇺🇸 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)
Autorisations
Multilingue
Résidence des données dans l'UE
Personnalisation
Exigences

Add Live Commenting to Drupal Sites

Démarrage rapide Internal Link

Voici la version « trop long ; pas lu » des instructions Drupal.

  1. Installez le module avec composer require drupal/fcom, ou placez-le dans modules/custom/fastcomments/.
  2. Activez-le avec drush en fastcomments, ou depuis l'interface d'administration à /admin/modules.
  3. Allez à Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Saisissez votre Tenant ID et API Secret depuis Paramètres > 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 le système de commentaires intégré 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 façons de l'installer.

Installer avec Composer

composer require drupal/fcom
drush en fastcomments

Installer manuellement

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 via l'interface d'administration à Extend (/admin/modules).

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

Une fois le module activé, allez à 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 - Requis 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 manière dont vous voulez que les gens échangent sur votre site.

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

Mode SSO

  • None - Aucun SSO. Les utilisateurs commentent en tant qu'invités ou créent un compte FastComments.
  • Simple - Transmet les informations utilisateur Drupal (nom, courriel, avatar) à FastComments sans vérification côté serveur.
  • Secure - Utilise HMAC-SHA256 pour vérifier les utilisateurs Drupal avec FastComments. Recommandé si 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.
  • Notifications par courriel - Envoyer un courriel à 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 inclut plusieurs blocs que vous pouvez placer depuis Structure > Block layout (/admin/structure/block).

  • FastComments Widget - Le widget principal de commentaires. Détecte automatiquement l'entité courante. Il ignorera les entités qui ont déjà le champ FastComments attaché, donc 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 commentaires 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 spécifiques.
  • FastComments Recent Comments - Affiche les commentaires récents sur l'ensemble de votre site. Le nombre affiché est configurable sur le bloc.
  • FastComments Top Pages - Affiche les pages de votre site ayant le plus de commentaires.

Les blocs axés sur le contenu (Live Chat, Collab Chat, Image Chat) détectent automatiquement l'entité courante, et reviennent à un identifiant basé sur le chemin pour les pages non liées à 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 à Structure > Content types > [type] > Manage fields et ajoutez le champ.

Chaque entité qui possède le champ obtient :

  • Un commutateur d'état permettant aux éditeurs d'activer ou de désactiver les commentaires par entité.
  • Un identifiant personnalisé facultatif vous permettant d'utiliser un ID stable qui n'est pas lié au chemin de l'entité Drupal.

Le bloc principal FastComments Widget reconnaît ce champ et ignorera les entités qui y sont déjà rattachées. Ainsi, vous pouvez combiner 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 à exécuter.

Le module prend en charge trois modes SSO, configurables dans Administration > Configuration > Content > FastComments.

Aucun

Aucun 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 requis. Convient pour des sites internes ou à faible risque.

Sécurisé (recommandé)

Utilise HMAC-SHA256 pour vérifier chaque identité utilisateur avec FastComments. C'est le mode à utiliser 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 à effectuer.

(Optionnel) Ajoutez vos administrateurs à Utilisateurs et 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 en savoir plus sur le fonctionnement du SSO, consultez la section SSO de la documentation sur les personnalisations.

Autorisations Internal Link

Le module ajoute trois permissions 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 - Nécessaire pour voir le widget de commentaires. Sans cette permission, le widget ne s'affiche pas.
  • Toggle FastComments - Permet aux utilisateurs d'activer ou de désactiver les commentaires pour chaque entité à l'aide du widget de champ.

Par défaut, seuls les utilisateurs disposant de la permission administer site configuration peuvent modifier les paramètres de FastComments. Accordez la permission 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 à Administration > Configuration > Content > FastComments:

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

Vous voudrez également récupérer votre Tenant ID et votre API Secret depuis le tableau de bord de l'UE à eu.fastcomments.com/auth/my-account/api au lieu du tableau de bord US 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 un style personnalisé ou modifier la configuration, Consultez notre documentation de personnalisation pour savoir comment.

Exigences 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 dépend uniquement du noyau Drupal (user, field).

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

Contribuer à ce guide