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

Prise en main

Installation

Configuration

Configuration

Documentation

Blocs de widgets
Multilingue
Autorisations
Comment cela fonctionne
Prérequis

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é, SSO et des autorisations granulaires.

Repository

Voir sur GitHub

Installation Internal Link

  1. Placez ce module dans le répertoire modules/custom/fastcomments/ de votre site Drupal (ou installez-le via Composer : composer require drupal/fcom).
  2. Activez le module :
    drush en fastcomments
    Ou activez-le via l'interface d'administration à la page Extend (/admin/modules).

Configuration Internal Link

Accédez à Administration > Configuration > Contenu > FastComments (/admin/config/content/fastcomments).

Paramètres

  • ID du locataire (requis) - Votre ID de locataire FastComments. Retrouvez-le dans Paramètres > API/SSO (EU).
  • Secret API - 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 Single Sign-On :
    • Aucun - Pas de SSO, les utilisateurs commentent en tant qu'invités ou créent des comptes FastComments.
    • Simple - Transmet les informations de l'utilisateur Drupal (nom, e-mail, avatar) à FastComments sans vérification côté serveur.
    • Sécurisé - Utilise une vérification HMAC-SHA256 pour authentifier de manière sécurisée les utilisateurs Drupal auprès de FastComments (recommandé).
  • Style de commentaires - Le type de widget à afficher :
    • Commentaires en direct - Commentaires filaires 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 principal.
    • Chat collaboratif + commentaires - À la fois chat collaboratif et commentaires standard.
  • 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 e-mail - Envoyer un e-mail 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 dispose d'un interrupteur d'état et d'un identifiant personnalisé optionnel par entité.

Résidence des données dans l'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 Internal Link

Plusieurs blocs sont disponibles via Structure > Disposition des blocs (/admin/structure/block) :

  • FastComments Widget - Le composant principal de commentaires. Détecte automatiquement l'entité courante. Ignore les entités qui possèdent déjà le champ FastComments (pour éviter les doublons).
  • 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 par sélection de texte et discussion.
  • FastComments Image Chat - Annotation par 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 utilisent, sur les pages sans entité, un identifiant basé sur le chemin.

Multilingue Internal Link

Le module transmet automatiquement la langue actuelle du site Drupal à tous les widgets.

Autorisations Internal Link

  • Administer FastComments - Accès au formulaire des paramètres de FastComments.
  • View FastComments - Nécessaire pour voir le widget de commentaires.
  • Toggle FastComments - Permet aux utilisateurs d'activer/désactiver les commentaires par entité via le widget du champ.

Comment cela fonctionne Internal Link

Lorsqu'un utilisateur visite une entité avec le champ FastComments activé :

  1. Le widget JavaScript de FastComments est chargé depuis le CDN.
  2. Si SSO est configuré, l'identité Drupal de l'utilisateur est transmise à FastComments.
  3. Un mécanisme de secours <noscript> fournit des commentaires rendus côté serveur pour les utilisateurs sans JavaScript (uniquement dans les modes Live Comments et Streaming Chat).

Prérequis Internal Link

Besoin d'aide ?

Si vous rencontrez des problèmes ou avez des questions concernant le module Drupal, veuillez :

Contribuer

Les contributions sont les bienvenues ! Veuillez consulter le dépôt GitHub pour les consignes de contribution.

Contribuer à ce guide