
Langue 🇨🇦 Français (Canada)
Premiers pas
Configuration
Documentation
Add Comments to Your Drupal Site
Ceci est le module Drupal officiel pour FastComments.
Un module Drupal qui intègre FastComments à Drupal 10/11, offrant des blocs de widget, une intégration des champs d'entité, le SSO et des autorisations granulaires.
Dépôt
Installation 
- Placez ce module dans le répertoire
modules/custom/fastcomments/de votre site Drupal (ou installez-le via Composer :composer require drupal/fcom). - Activez le module :
Ou activez-le via l'interface d'administration à Étendre (drush en fastcomments/admin/modules).
Configuration 
Accédez à Administration > Configuration > Contenu > FastComments (/admin/config/content/fastcomments).
Paramètres
- ID du locataire (requis) - Votre Tenant ID FastComments. Trouvez-le sous Paramètres > API/SSO (EU).
- API Secret - Requis pour le SSO sécurisé, la vérification des webhooks et la synchronisation des pages. Trouvé sous Paramètres > API/SSO (EU).
- Mode SSO - Intégration d'authentification unique :
- Aucun - Pas de SSO, les utilisateurs commentent en tant qu'invités ou créent des comptes FastComments.
- Simple - Transmet les infos utilisateur Drupal (nom, courriel, avatar) à FastComments sans vérification côté serveur.
- Sécurisé - Utilise la vérification HMAC-SHA256 pour authentifier de façon sécurisée les utilisateurs Drupal auprès de FastComments (recommandé).
- Style de commentaire - Le type de widget à afficher :
- Commentaires en direct - Commentaires en fil en temps réel.
- Chat en streaming - Interface de chat en direct.
- Chat collaboratif - Annotation collaborative par sélection de texte sur la zone de contenu principale.
- Chat collaboratif + commentaires - À la fois chat collaboratif et commentaires standards.
- URL CDN - URL du CDN FastComments (par défaut :
https://cdn.fastcomments.com). - URL du site - URL du site FastComments (par défaut :
https://fastcomments.com). - Notifications par courriel - Envoyer un courriel aux auteurs du contenu lorsqu’un nouveau commentaire est publié sur leur contenu.
Ajout de commentaires aux types de contenu
Ajoutez le champ FastComments à vos types de contenu via Structure > Types de contenu > [type] > Gérer les champs. Le champ possède un commutateur d'état et un identifiant personnalisé optionnel par entité.
Résidence des données (UE)
Pour la résidence des données dans l'UE, mettez à jour :
- URL CDN vers
https://cdn-eu.fastcomments.com - URL du site vers
https://eu.fastcomments.com
Blocs de widgets 
Plusieurs blocs sont disponibles via Structure > Block layout (/admin/structure/block):
- FastComments Widget - Le widget principal de commentaires. Détecte automatiquement l'entité courante. Ignore les entités qui ont déjà le FastComments field (pour éviter les doublons).
- FastComments Live Chat - Messagerie 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.
- FastComments Recent Comments - Affiche les commentaires récents sur l'ensemble de votre site. Nombre de commentaires configurable.
- FastComments Top Pages - Affiche les pages 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 se rabattent sur un identifiant basé sur le chemin pour les pages qui ne correspondent pas à une entité.
Multilingue 
Le module transmet automatiquement la langue actuelle du site Drupal à tous les widgets.
Autorisations 
- Administrer FastComments - Accès au formulaire de paramètres de FastComments.
- Voir FastComments - Nécessaire pour voir le widget de commentaires.
- Activer/Désactiver FastComments - Permet aux utilisateurs d'activer/désactiver les commentaires par entité via le widget de champ.
Comment ça fonctionne 
Lorsqu'un utilisateur visite une entité pour laquelle le champ FastComments est activé :
- Le widget JavaScript FastComments est chargé depuis le CDN.
- Si SSO est configuré, l'identité Drupal de l'utilisateur est transmise à FastComments.
- Un repli
<noscript>fournit des commentaires rendus côté serveur pour les utilisateurs sans JavaScript (uniquement en modes Live Comments et Streaming Chat).
Besoin d'aide?
Si vous rencontrez des problèmes ou avez des questions au sujet du module Drupal, veuillez :
Contributions
Les contributions sont les bienvenues ! Veuillez visiter le dépôt GitHub pour les directives de contribution.