Personnalisations et configuration
Contexte
Vous trouverez ici une documentation approfondie sur chacune des fonctionnalités et options que prend en charge le widget de commentaires.
Cette documentation couvre les concepts de base et approfondira chaque domaine de fonctionnalité, avec des guides pratiques et les pièges courants.
Des exemples de code seront fournis, avec les lignes pertinentes mises en évidence. Des captures d'écran des pages de configuration seront fournies lorsque cela s'applique.
Les exemples de code utiliseront notre bibliothèque JavaScript vanilla ; toutefois, les options de configuration utilisent exactement les mêmes noms pour toutes les versions du widget de commentaires (React, Vue, etc.).
La plupart des configurations et fonctionnalités décrites dans ce guide ne nécessitent pas d'écrire du code.
Identifier votre compte 
Vous remarquerez que le widget de commentaires peut être utilisé avec un Tenant ID de "demo", par exemple:
Run 
Ceci est uniquement destiné à tester et à s'amuser avec le widget de commentaires. En production, vous transmettriez votre Tenant ID, de la manière suivante:
Run Votre Tenant ID est déjà appliqué sur le widget de commentaires extrait de code dans votre compte.
Vous pouvez aussi trouver votre Tenant ID et gérer vos clés API sur la page des identifiants API.
À partir de ce point, si vous êtes connecté à FastComments, les exemples de code utiliseront votre vrai Tenant ID (si vous êtes connecté sur https://fastcomments.com).
Comment les commentaires sont associés aux pages et aux articles
Lors du rendu d'un fil de commentaires, ou lorsque vous laissez un commentaire, FastComments doit savoir à quelle page, article ou produit ces commentaires appartiennent.
Pour cela, nous utilisons ce que nous appelons le "URL ID". Il s'agit soit d'un identifiant, comme une chaîne ou un nombre, soit d'une URL.
Par défaut, si vous ne spécifiez pas le urlId, il deviendra l'URL de la page. Nous prendrons l'URL actuelle de la page et la nettoierons pour supprimer les paramètres marketing courants ou les identifiants de suivi.
Dans le cas des intégrations tierces, comme WordPress, notre plugin utilisera généralement l'identifiant représentant l'information consultée comme le URL ID, par exemple l'id de l'article/de la page.
Run Un élément auquel nous faisons souvent référence dans ce document est l'Interface de personnalisation du widget.
Cette interface peut être utilisée pour effectuer de nombreuses modifications du widget de commentaires sans écrire de code.
Lorsque vous créez une règle de personnalisation, nous souhaitons souvent qu'elle s'applique à toutes les pages de notre site. Cependant, dans certains cas, nous voulons personnaliser le widget de commentaires sur une page particulière, soit pour appliquer un style personnalisé, soit peut-être pour rendre les commentaires de cette page particuliers anonymes. Vous pouvez aussi, par exemple, afficher les commentaires en direct immédiatement sur certaines pages, tout en les masquant sous des boutons de notification sur d'autres.
Tout cela est possible via le champ URL ID sur cette page, qui ressemble à ceci :
La valeur de ce champ doit correspondre au paramètre urlId passé au widget de commentaires. Si vous souhaitez que votre règle de personnalisation soit indifférente au urlId, laissez ce champ vide ou saisissez *.
Depuis 2023, le champ URL ID dans la personnalisation du widget accepte désormais des motifs ! Par exemple, vous pouvez
avoir */blog/* pour ajouter un style spécifique à votre blog et */store/* pour un style spécifique à votre boutique,
tout en utilisant le même domaine.
Points importants
- Si votre page possède des paramètres de hachage (comme example.com#page-1) - ceux-ci feront partie du URL ID, par défaut.
- Lors des migrations, par exemple de WordPress vers Gatsby, il se peut que vous deviez migrer les valeurs URL ID des commentaires après la migration initiale. Pour cela, contactez-nous.
Afficher les mêmes commentaires sur différentes pages
Comme le paramètre urlId nous permet de définir à quelle page, ou quel identifiant, les commentaires sont rattachés, nous pouvons simplement définir urlId avec la même valeur sur ces pages.
Run Styles personnalisés
FastComments est conçu pour être personnalisé. Le widget de commentaires s'exécute dans un iframe pour des raisons de sécurité, donc pour appliquer un style personnalisé vous devez suivre l'une des deux approches.
La première approche, la plus simple et celle que nous privilégions, consiste à utiliser la page de personnalisation du widget.
Dans la page de personnalisation du widget, consultez la section "Afficher les options avancées", sous laquelle se trouve une zone intitulée "Custom CSS" :
Cette approche présente plusieurs avantages :
- Le CSS saisi est minifié avant d'être envoyé à l'utilisateur, et la mise en forme est conservée de manière cohérente dans l'interface d'édition.
- Vous bénéficiez de tous les avantages de l'interface de personnalisation du widget, par exemple la possibilité de personnaliser facilement le widget de commentaires différemment selon les sites.
- Lorsque nous apportons des modifications au widget de commentaires, votre style personnalisé sera testé dans le cadre de notre processus de publication.
La seconde approche consiste à spécifier le paramètre customCSS dans la configuration du widget, comme suit :
Run Cependant, cela présente des limitations :
- Il existe une limite à la quantité de CSS personnalisé pouvant être transmise avant que nos serveurs ne rejettent la requête, en raison de la taille des en-têtes.
- Vous devez gérer le CSS personnalisé dans votre infrastructure et votre système de build. Cela peut être un avantage plutôt qu'un inconvénient.
- Il y a un surcoût supplémentaire lié à l'envoi du CSS personnalisé sur le réseau deux fois dans ce cas d'utilisation, car il doit être envoyé à nos serveurs, puis renvoyé dans le contenu de l'iframe. Cependant, pour la plupart des tailles de charge utile, cela n'est pas perceptible.
- Une optimisation courante consiste à minifier le CSS pour réduire sa taille sur le réseau ; toutefois, avec cette approche, vous devrez vous en charger.
- Votre CSS personnalisé ne sera pas testé lorsque nous effectuerons des modifications.
Fichiers CSS externes
Vous pouvez indiquer au widget de récupérer un fichier externe en utilisant @import !
Il est recommandé d'insérer l' @import dans une règle de personnalisation. De cette façon, si nous devons un jour modifier le widget de commentaires, nous pouvons utiliser nos outils d'automatisation pour vérifier votre configuration. Par exemple, vous créeriez une règle de personnalisation dans l'interface de personnalisation du widget, cliqueriez sur Advanced, et saisiriez dans Custom CSS :
@import url(https://example.com/styles.css);Dans le code - Non recommandé
Vous pouvez aussi charger un fichier CSS externe via la propriété customCSS :
Run Cependant, souvenez-vous que votre CSS ne pourra pas être testé par nos soins si vous procédez ainsi.
Personnalisation des modales de profil utilisateur
Les modales de profil utilisateur peuvent également être stylisées avec du CSS personnalisé. Cependant, pour garantir que le style personnalisé soit appliqué aux profils utilisateur, tous les sélecteurs CSS doivent être préfixés par .user-profile. Sans ce préfixe, le style personnalisé sera ignoré pour les modales de profil utilisateur.
Par exemple :
Run Rétrocompatibilité
Chez FastComments, nous savons que nos clients personnalisent le widget de commentaires. C'est voulu — la dernière chose que nous voulons est que notre produit provoque des incohérences de design dans votre produit.
Comme il s'agit d'une partie importante de notre produit, nous disposons d'un pipeline de build qui nous permet d'examiner les modifications du widget de commentaires, par client, à chaque version.
Si nous constatons des problèmes mineurs, nous mettrons à jour votre compte pour garantir que notre publication se déroule sans accroc. Si nous identifions des changements majeurs et bloquants, cela nous permet d'arrêter la publication.
Polices personnalisées
FastComments est conçu pour être personnalisable, et la police utilisée par ses widgets ne fait pas exception.
Par défaut, FastComments utilise la system font stack pour s'afficher au mieux sur un large éventail d'appareils.
Pour définir vos propres polices, consultez la Documentation sur le CSS personnalisé.
Vous y trouverez une méthode pour définir du CSS personnalisé, ce qui vous permettra de définir les polices de votre choix.
Comment définir la police
Pour remplacer la police, nous recommandons de définir votre CSS en utilisant les sélecteurs .fast-comments, textarea. Par exemple :
Run Suppression du branding
Pour les clients disposant d'un compte Pro ou Enterprise, la marque blanche est autorisée. Il vous suffit de nous contacter et nous serons ravis de vous aider.
Si vous souhaitez simplement supprimer notre logo du widget de commentaires, cela est automatiquement activé sur les plans Flex et Pro.
Ces plans offrent également la même fonctionnalité pour les e-mails envoyés depuis notre plateforme.
Prise en charge des arrière-plans sombres (mode sombre)
Par défaut, le widget de commentaires FastComments détectera automatiquement le mode sombre sur la plupart des sites.
Lorsque le mode sombre est détecté, FastComments passera du texte noir sur fond blanc au texte blanc sur fond noir. Les images changeront également.
Au chargement de la page, le widget essaiera de déterminer la luminosité du fond de la page derrière le widget de commentaires. Cela signifie que la page peut avoir un fond blanc, mais si vous placez le widget de commentaires à l'intérieur d'un conteneur au fond noir, le mode sombre devrait toujours s'activer automatiquement afin de rendre les commentaires lisibles.
Cependant, le mécanisme de détection, qui repose sur la détermination de la « luminance », peut ne pas activer le mode sombre lorsque vous le souhaitez. Pour l'activer de force, définissez le drapeau hasDarkBackground sur true comme suit :
Run Basculer le mode sombre
Pour les sites qui permettent de basculer en mode sombre après le chargement initial de la page, c'est un peu plus complexe.
Tout d'abord, toutes les versions actuelles de la bibliothèque du widget de commentaires (React, Vue) contiennent des exemples de basculement en mode sombre dans leurs dépôts respectifs.
Pour le widget VanillaJS, nous devrons effectuer un peu plus de travail. Premièrement, le FastCommentsUI renvoie un objet avec les fonctions "destroy" et "update".
Nous pouvons simplement appeler la fonction update chaque fois que nous souhaitons mettre à jour la configuration du widget de commentaires, comme suit. Voici un exemple complet et fonctionnel de basculement en mode sombre avec le widget VanillaJS.
Run Remplacer le texte
Avec FastComments, tout le texte du widget de commentaires est personnalisable.
Vous pouvez remplacer un seul élément de texte, comme le bouton d'envoi, ou tous les textes du widget de commentaires.
Par défaut, le texte du widget de commentaires est traduit en fonction de la locale de l'utilisateur. Cependant, nous pouvons remplacer ce texte si nous sommes convaincus que notre base d'utilisateurs utilise la même locale/langue, par exemple :
Run Toutes les traductions personnalisables se trouvent ici sous l'onglet « options avancées ».
Cependant, il existe une méthode plus simple, via l'interface de personnalisation du widget. Là, nous pouvons simplement trouver le texte qui s'affiche dans le widget de commentaires dans la locale EN_US, et spécifier un remplacement.
Toutes les modifications de traduction affectent actuellement toutes les locales.
Modifier l'avatar par défaut
Lorsqu'un utilisateur commente sur FastComments pour la première fois, nous tenterons de récupérer son avatar depuis http://gravatar.com/.
Cependant, si nous ne trouvons pas d'avatar, ou si l'utilisateur n'en définit jamais dans son compte, nous affichons une image d'avatar par défaut statique.
Pour spécifier votre propre image d'avatar statique, nous pouvons utiliser le réglage defaultAvatarSrc.
Run Cela peut également être fait sans code. Dans la page de personnalisation du widget, consultez la section « Avatar par défaut ».
Notez que la définition de l'avatar pour un utilisateur particulier, par exemple via SSO, est traitée dans une section dédiée.
Désactiver les avatars
Les avatars peuvent être complètement supprimés du widget de commentaires, même si les utilisateurs ont défini leur propre avatar.
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget :
Désactiver tous les styles par défaut
Pour des projets de personnalisation de style plus importants, il peut être souhaitable de partir d'une page blanche et de ne pas utiliser du tout le style par défaut.
Il est possible de supprimer tous les styles par défaut en définissant le paramètre noStyles sur true, comme suit :
Run Cela peut être personnalisé sans code, depuis la page de personnalisation du widget, sous Options avancées :
Créer des liens depuis les commentaires vers les pages
Lors de l'envoi d'e-mails de notification, ou du rendu des commentaires dans des interfaces utilisateur comme la page de modération, il est utile de pouvoir faire un lien à partir du commentaire vers la page sur laquelle il se trouve.
Si URL ID n'est pas toujours un ID, alors nous devons stocker l'URL ailleurs. C'est à cela que sert la propriété "url", définie comme suit.
Run Un cas d'utilisation courant est d'associer le fil de commentaires à un identifiant, comme un article, puis de créer un lien vers une page particulière, par exemple :
Run L'URL n'est pas nettoyée des paramètres marketing courants. Par défaut, quelle que soit l'URL de la page actuelle, c'est l'URL qui est enregistrée avec le commentaire.
Replier les réponses par défaut
Par défaut, les réponses aux commentaires de niveau supérieur sont affichées.
Cela peut être configuré pour que l'utilisateur doive cliquer sur "Afficher les réponses" sur les commentaires de niveau supérieur pour voir les réponses.
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget :
Ce paramètre n'affectera pas le nombre de commentaires de niveau supérieur chargés initialement. Si vous avez un commentaire de niveau supérieur, et 29 réponses, avec ce paramètre activé vous allez :
- Voir le commentaire de niveau supérieur.
- Voir Afficher les réponses (29) sous ce commentaire.
Si vous souhaitez afficher tous les commentaires de niveau supérieur en combinaison avec cette option, définissez page de départ à -1.
Activer l'éditeur WYSIWYG
Par défaut, les fonctionnalités de formatage dans FastComments sont réalisées en ajoutant des balises visibles comme <b></b> autour de votre texte. Cliquer sur la barre d'outils
ou utiliser des raccourcis effectue cela pour vous. Cependant, certaines communautés peuvent souhaiter opter pour un formatage sans balises visibles. On appelle cela l'activation de
l'éditeur WYSIWYG (ce que vous voyez est ce que vous obtenez). Cet éditeur a exactement le même aspect que celui par défaut, sauf qu'il charge du
code supplémentaire qui permet aux utilisateurs de mettre le texte en gras, de le souligner, etc. sans balises visibles.
Run Ceci peut aussi être fait sans code. Dans la page de personnalisation du widget, consultez l'option « Activer le formatage avancé ».
Désactiver la barre d'outils
Par défaut, FastComments affiche une barre d'outils lors de la rédaction d'un commentaire afin d'offrir des raccourcis pour la mise en forme du texte et le téléversement d'images.
Cette barre d'outils peut être désactivée dans le code ou via l'interface de personnalisation.
Run Cela peut également être fait sans code. Sur la page de personnalisation du widget, consultez l'option "Désactiver la barre d'outils de réponse".
Désactiver le blocage
Par défaut, FastComments permet aux utilisateurs de bloquer d'autres utilisateurs. Le blocage d'un utilisateur fera en sorte que ses commentaires soient masqués, empêchera les notifications entre les utilisateurs, et ainsi de suite.
Il peut être souhaitable de désactiver cette fonctionnalité. Cela peut se faire de la manière suivante :
Run Cela peut également être fait sans code, ce qui active également une validation côté serveur appropriée, via l'interface de personnalisation du Widget :
Déterminer quelle page afficher
Lors de la récupération et du rendu des commentaires, le widget de commentaires doit savoir sur quelle page commencer. Par défaut, il commence par la première page et n'affiche que cette page.
Si nécessaire, la page exacte à afficher peut être transmise au widget de commentaires via le paramètre startingPage.
Run Notez que la numérotation des pages commence à zéro, donc l'exemple ci-dessus affiche la deuxième page.
Changer de fil de discussion sans recharger la page
Nous avons expliqué comment urlId est l'identifiant de la page ou de l'article auquel les commentaires sont liés.
Aussi, pour récapituler, si elle n'est pas définie, la urlId prendra par défaut l'URL de la page courante.
Qu'en est-il des SPAs, ou Single-Page-Applications, où la page ou le contenu auquel les commentaires sont liés change dynamiquement sans rechargement complet de la page ?
Angular, React, Vue, etc
Avec nos bibliothèques telles qu'Angular et React, il suffit de mettre à jour la propriété urlId passée au widget
pour provoquer le rafraîchissement du widget de commentaires. Vous pouvez voir cela en action pour l'application React, par exemple, ici.
VanillaJS
Si vous utilisez la bibliothèque VanillaJS, c'est un peu plus compliqué car il n'y a pas de framework comme Angular ou React pour gérer la liaison de données ou la propagation d'état.
Lorsque vous instanciez le widget VanillaJS, il renvoie certaines fonctions qui peuvent être appelées pour le mettre à jour.
Voici un exemple fonctionnel où nous changeons le hash de la page et mettons à jour le widget de commentaires :
Run Dates absolues (désactiver les horodatages lisibles)
Par défaut, des dates relatives localisées sont utilisées. Par exemple, à côté d'un commentaire laissé récemment vous pouvez voir "il y a 11 minutes".
Il peut être nécessaire ou souhaitable d'utiliser des dates absolues, auquel cas vous définissez ce paramètre sur true.
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget, dans Options avancées :
Afficher à la fois les dates absolues et relatives
Par défaut, les dates relatives localisées sont utilisées. Par exemple, à côté d'un commentaire récemment laissé, vous pouvez voir "il y a 11 minutes".
Il peut être nécessaire ou souhaitable de conserver ce format de date relative, tout en affichant également la date complète à côté ; dans ce cas, réglez ce paramètre sur true.
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget, dans les Options avancées. Vous devrez d'abord activer les Dates absolues pour voir cette option dans l'interface utilisateur (UI).
Ajouter un texte d'en-tête
Certain texte, comme un en-tête ou un message, peut être affiché sous le nombre de commentaires mais au-dessus du texte indiquant l'état de connexion.
Nous appelons cela l'en-tête, et par défaut il est masqué.
Run Cela peut être personnalisé sans code, depuis la page de personnalisation du widget, dans Options avancées :
Afficher les liens comme du texte
Par défaut, FastComments affichera les liens comme ceci : https://exmaple.com - où l'URL du lien devient cliquable balise d'ancre HTML.
Certains sites peuvent vouloir désactiver cela, par exemple pour décourager les escrocs. Nous fournissons cela en réglant l'option Comment HTML Rendering Option sur Links as Text.
Cela peut être personnalisé sans code, sur la page de personnalisation du widget, pour un domaine entier, ou une page :
Afficher/masquer les commentaires via un bouton
Par défaut, FastComments affichera la zone de saisie des commentaires et le fil de commentaires en même temps. Pour économiser de l'espace vertical, il masquera également tout autre champ requis jusqu'à ce que le widget soit utilisé.
Cependant, le widget de commentaires peut être masqué derrière un bouton, par exemple :
Le bouton utilise différents textes traduits selon que les commentaires sont actuellement affichés ou non. Si les commentaires sont masqués, il utilise translations.SHOW_COMMENTS_BUTTON_TEXT. Si les commentaires sont affichés, il utilise translations.HIDE_COMMENTS_BUTTON_TEXT. Les traductions peuvent contenir le texte [count] qui sera remplacé par le nombre localisé.
Run Ceci est conçu pour remplacer la configuration hideCommentsUnderCountTextFormat.
Le nombre est mis à jour en direct avec le fil de commentaires. Le bouton n'est pas affiché s'il n'y a pas de commentaires.
Cela peut être activé sans code en créant une règle de personnalisation et en activant "Cliquer pour afficher les commentaires":
Personnaliser le texte du compteur de commentaires
Le nombre de commentaires affiché en haut du widget de commentaires peut être personnalisé.
Cela peut être remplacé par n'importe quelle chaîne, et la valeur [count] sera remplacée par la valeur du décompte, localisée pour l'utilisateur.
Run Cela peut être personnalisé sans code, depuis la page de personnalisation du widget :
Désactiver la redirection des images
Par défaut, FastComments permet aux utilisateurs de télécharger des images. Lorsqu'un utilisateur clique sur cette image, FastComments ouvrira, par défaut, un nouvel onglet pour afficher l'image en entier. Définir ce drapeau sur true désactive ce comportement :
Run Si vous ne prévoyez pas de gérer vous-même le clic sur l'image (voir onImageClicked), nous recommandons de combiner cela avec un style pour supprimer l'aspect cliquable de l'image.
Désactiver la création automatique de hashtags
Lorsque les utilisateurs saisissent des hashtags, sous la forme #someexampletag, FastComments créera automatiquement ce HashTag et
le mettra en surbrillance dans leur commentaire.
Dans certains cas, il est souhaitable de désactiver cette fonctionnalité, ou de contrôler quels hashtags peuvent être utilisés via l'API.
Pour ce faire, il suffit d'activer Disable Automatic #hashtag Creation dans l'interface de personnalisation du widget.
Désactiver la cloche de notification
Par défaut, FastComments affichera une cloche de notification en haut à droite de la zone de commentaires.
Cette cloche devient rouge et affiche le nombre de notifications de l'utilisateur. Voici quelques exemples de notifications :
- Un utilisateur vous a répondu.
- Un utilisateur a répondu dans un fil où vous avez commenté.
- Un utilisateur a voté pour votre commentaire.
- Un utilisateur a répondu sur une page à laquelle vous êtes abonné.
La cloche de notification permet également de s'abonner à une page entière.
Cependant, il est possible de désactiver complètement la cloche de notification :
Run Cela peut aussi être fait sans code. Dans la page de personnalisation du widget, consultez la section "Désactiver la cloche de notification".
Désactiver les profils
Par défaut, FastComments affichera le profil de l'utilisateur lorsque vous cliquez sur son avatar.
Cependant, nous pouvons désactiver cette fonctionnalité :
Run Cela peut également être fait sans code. Dans la page de personnalisation du widget, consultez la section "Désactiver les profils".
Désactiver le message de succès
Par défaut, FastComments affichera un message de succès après la publication d'un commentaire. Cela peut être désactivé comme suit :
Run Cela peut également être fait sans code. Dans la page de personnalisation du widget :
Modifier la classification des GIFs
Par défaut, le widget de commentaires FastComments définira un gif rating sur pg.
Les options disponibles sont g, pg, pg-13, et r.
Cela peut être défini dans le code ou via l'interface. Dans le code nous pouvons le faire comme suit :
Run Dans l'interface, vous trouverez ceci sous Gif Picker Rating tant que Disable Image Uploads? n'est pas coché.
Modération du contenu des images
Par défaut, le widget de commentaires FastComments a la modération du contenu des images réglée sur off.
Les options disponibles sont off, low, medium et high.
Dans l'interface de personnalisation du widget, vous trouverez cela sous Image Content Moderation Level tant que Disable Image Uploads? n'est pas coché.
Modifier le style de vote
Par défaut, FastComments affichera des options de vote sous forme de flèches haut et bas, permettant aux utilisateurs de voter pour ou contre un commentaire.
Cependant, il est possible de changer le style de la barre d'outils de vote. Les options actuelles sont les boutons par défaut Haut/Bas, ou d'utiliser un mécanisme de vote de type cœur.
Nous utilisons le paramètre voteStyle comme suit :
Run Nous vous recommandons fortement de le faire sans code car cela active également les validations côté serveur. Sur la page de personnalisation du widget, consultez la section « Style de vote ».
Le vote peut également être désactivé, voir Disable Voting ci-dessus, dans les options de style.
Désactiver la suppression
Par défaut, FastComments permet aux utilisateurs de supprimer leurs commentaires.
Cependant, il est possible d'empêcher cela.
Sur la page de personnalisation du widget, consultez l'option « Désactiver la suppression ».
- Cela n'affecte que les commentateurs réguliers et pas les modérateurs ou administrateurs, qui pourront toujours supprimer des commentaires.
- Cela affectera également les intégrations API lorsque
contextUserIdest passé.
Désactiver la modification
Par défaut, FastComments autorise les utilisateurs à modifier leurs commentaires.
Cependant, il est possible d'empêcher cela.
Dans la page de personnalisation du widget, consultez l'option « Désactiver l'édition ».
- Cela n'affecte que les commentateurs réguliers et pas les modérateurs ou les administrateurs, qui pourront toujours modifier.
- Cela affectera également les intégrations API lorsque
contextUserIdest transmis.
Mettre en évidence les nouveaux commentaires
FastComments propose plusieurs façons de mettre en évidence les nouveaux commentaires.
Tout d'abord, par défaut, les commentaires ayant déclenché une notification dans l'application (réponses, réponses dans le même fil, ou commentaires sur une page
à laquelle vous êtes abonné), seront automatiquement mis en évidence avec l'avatar de l'utilisateur légèrement illuminé. La couleur peut être personnalisée via CSS
en utilisant la classe is-unread.
Les commentaires publiés au cours des dernières 24 heures ont la classe 24hr appliquée qui peut être utilisée pour la mise en forme.
Enfin, tout nouveau commentaire en direct qui apparaît dans la session de l'utilisateur sera mis en évidence pendant plusieurs secondes via une animation. Cela se fait via la
classe CSS is-live et peut également être personnalisée.
Taille des pages
Par défaut, la taille de page de FastComments est 30. Cela inclut les réponses dans les fils.
La taille de page peut être personnalisée dans l'interface de configuration du widget avec des tailles variant de 10 à 200.
Notez que modifier la taille de page nécessite le recalcul de tous les fils de commentaires de votre compte. Cela peut prendre quelques minutes.
Cela ne peut pas être configuré dans le widget côté client car les pages sont calculées côté serveur.
Exemple de configuration est montré ci-dessous :
Les tailles de page peuvent être personnalisées globalement, par domaine ou par page, en créant différentes règles de personnalisation.
Cela affectera tous les clients, intégrations et frameworks que vous utilisez pour afficher les commentaires via notre plateforme.
Modèles d'e-mails
Les e-mails envoyés par FastComments à vos clients peuvent être personnalisés. Le modèle, la logique, et les traductions peuvent tous être modifiés. Le texte peut être personnalisé par locale, et le style peut même être changé par domaine. En savoir plus sur les modèles d'e-mails personnalisés ici.
Formats de nom d'utilisateur
Par défaut, FastComments affichera le nom de l'utilisateur tel qu'il l'a saisi, ou tel qu'il nous a été transmis via SSO.
Cependant, il peut être souhaitable de masquer ou d'afficher le nom de l'utilisateur différemment. Par exemple, si le nom de l'utilisateur est Allen Rex, vous pouvez ne vouloir afficher que "Allen R.".
Cela peut être fait sans code dans l'interface de personnalisation du widget, dans le paramètre appelé Commenter Name Format :
Les formats disponibles sont :
- Capitaliser (display example user as Example User)
- Initiale du nom de famille (display Example User as Example U.)
- Toutes les initiales (display Example User as E. U.)
- Afficher "Anonymous"
L'effet de ce changement est immédiat. Les utilisateurs verront toujours leur nom d'utilisateur complet en haut de la zone de commentaire, pour eux-mêmes, mais leurs commentaires afficheront le nom d'utilisateur modifié.
Les noms d'utilisateur sont masqués côté serveur pour protéger les utilisateurs.
Désactiver le téléversement d'images
Par défaut, FastComments autorise les téléchargements d'images. Cela peut être désactivé en définissant le drapeau noImageUploads sur true.
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget:
Activer la barre de recherche
Par défaut, aucune zone de recherche n'est affichée dans le widget de commentaires.
Cependant, nous pouvons l'activer en définissant le drapeau enableSearch sur true:
Run Cela peut également être fait sans code. Dans la page de personnalisation du widget, consultez l'option "Activer la zone de recherche".
Activer les spoilers
Nous pouvons activer la prise en charge des spoilers en définissant le drapeau enableSpoilers sur true:
Run Cela peut également être fait sans code. Dans la page de personnalisation du widget, consultez l'option "Activer les spoilers".
Lorsqu'un texte est surligné et que l'on clique sur le bouton SPOILER désormais visible, le texte est masqué jusqu'à ce que l'utilisateur le survole avec la souris. Pour le mode sombre, nous procédons de la même manière, en utilisant des couleurs différentes mieux adaptées.
Ceci est également compatible avec l'éditeur WYSIWYG.
Activer le compteur de vues des commentaires
Par défaut, FastComments ne suit pas qui a consulté chaque commentaire ni ne fournit de statistiques à ce sujet.
Cependant, nous pouvons activer cette fonctionnalité, et le système commencera alors à suivre lorsqu'un utilisateur fait défiler jusqu'à un commentaire.
Lorsque cela se produit, un compteur à côté d'une icône en forme d'œil affichée sur chaque commentaire sera incrémenté. Le compteur est mis à jour en temps réel et abrégé selon la locale de l'utilisateur.
Nous pouvons activer cela en définissant le drapeau enableViewCounts sur true :
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget :
Nous enregistrons l'identifiant utilisateur* qui a consulté le commentaire, afin que si vous consultez à nouveau le commentaire, cela n'incrémente pas. Si vous consultez le commentaire à nouveau après deux ans, le compteur s'incrémente à nouveau.
- *Remarque : ou l'identifiant de session anonyme, ou l'IP de l'utilisateur sous forme de valeur hachée.
Afficher les commentaires en direct immédiatement
Par défaut, les commentaires en direct sont activés. Cela signifie que si des commentaires sont ajoutés, supprimés, modifiés ou épinglés, les modifications doivent apparaître pour tous les utilisateurs consultant le fil de commentaires en même temps.
Cependant, par défaut ces nouveaux commentaires apparaîtront sous un bouton affiché dynamiquement avec un texte similaire à "Afficher 2 nouveaux commentaires".
Si les nouveaux commentaires sont des réponses directement à la page, le bouton s'affichera en haut du fil de commentaires. S'il s'agit de réponses à un commentaire particulier, le bouton s'affichera sous ce commentaire.
Cela permet d'éviter que la taille de la page ne change constamment pour l'utilisateur, ce qui pourrait provoquer de la frustration lorsqu'il tente d'attraper la barre de défilement.
Pour certains cas d'utilisation, comme les enchères en direct ou les événements en ligne, ce comportement n'est pas souhaité - vous pouvez préférer que le widget de commentaires soit plus proche d'une "boîte de chat" où les nouveaux commentaires "s'affichent immédiatement".
Donc, le nom du drapeau qui active cette fonctionnalité : showLiveRightAway.
Nous pouvons l'activer comme suit :
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget :
Désactiver les commentaires en direct
Par défaut, FastComments active les commentaires en direct.
Cela signifie que chaque visiteur du fil de commentaires devrait voir le même contenu.
Par exemple, si un commentaire est ajouté, ce commentaire devrait s'afficher. Si un commentaire est modifié ou supprimé, alors ces commentaires seront modifiés ou supprimés pour tous les visiteurs du fil. Il en va de même pour les votes et toutes les actions de modération.
Cependant, nous pouvons désactiver cela :
Run Cela peut également être fait sans code. Dans la page de personnalisation du widget, consultez la section "Désactiver les commentaires en direct".
Placer les nouveaux commentaires en direct en bas
Par défaut, les nouveaux commentaires en direct apparaissent en haut de la liste des commentaires au fur et à mesure qu'ils sont publiés en temps réel.
Lorsque cette option est activée, les nouveaux commentaires en direct sont ajoutés en bas de la liste. Cela affecte la façon dont les commentaires s'affichent lorsqu'ils sont publiés en direct pendant que les utilisateurs consultent le fil de discussion.
Run Avec ce paramètre activé :
- Les nouveaux commentaires en direct publiés par d'autres utilisateurs apparaîtront en bas de la liste des commentaires
- Les utilisateurs verront les nouveaux commentaires s'afficher sous les commentaires existants en temps réel
- Cela n'affecte que les mises à jour des commentaires en direct - pas le chargement initial de la page
- Cela peut aider à maintenir la fluidité de la lecture lorsque les utilisateurs suivent une discussion
Notez que ce paramètre n'affecte que l'emplacement des nouveaux commentaires en direct au moment de leur arrivée en temps réel. Il n'affecte pas l'ordre de tri initial lors du chargement de la page.
Activer le défilement infini
Par défaut, le widget FastComments redimensionnera sa hauteur pour afficher tous les commentaires visibles. La pagination se fait via un bouton "Afficher la suite" à la fin de la page en cours, car nous avons constaté que c'est l'interaction qui convient le mieux à la plupart des utilisateurs.
Cependant, il existe des cas où le défilement infini est préféré. Par exemple, nous utilisons cette fonctionnalité dans notre produit Stream Chat.
Nous pouvons masquer les boutons "Afficher la suite" et passer au défilement infini en définissant le drapeau enableInfiniteScrolling sur true :
Run Cela nécessite également d'ajouter du CSS personnalisé. Ajoutez du CSS personnalisé pour le sélecteur .comments afin d'activer le défilement, par exemple :
Run Un exemple complet et fonctionnel serait :
Run Dans l'exemple ci‑dessus, nous utilisons la propriété customCSS ; cependant, il est recommandé d'utiliser l'interface de configuration du widget à la place pour des raisons de performance. Voir la documentation sur le CSS personnalisé.
Changer la direction de tri par défaut
Par défaut, FastComments triera les commentaires selon la direction de tri "Most Relevant".
Le tri "Most Relevant" prend en compte l'heure à laquelle le commentaire a été laissé et le nombre de votes.
L'utilisateur peut ensuite modifier la direction de tri vers Oldest ou Newest First dans l'interface du widget de commentaires.
Cependant, nous pouvons définir la valeur par défaut sur l'une des trois. Par exemple, si vous souhaitez afficher d'abord les commentaires les plus anciens :
Run Nous définissons la valeur de defaultSortDirection sur "OF" pour définir la direction sur "OF".
Pour la direction de tri Newest First, nous ferions ce qui suit :
Run Les valeurs valides pour defaultSortDirection sont :
- MR: "Most Recent"
- NF: "Newest First"
- OF: "Oldest First"
Cela peut aussi être fait sans code. Sur la page de personnalisation du widget, consultez la section « Default Sort Direction ».
Notez que les commentaires sur chaque page pour chaque direction de tri sont pré-calculés, donc toutes les directions de tri ont les mêmes performances.
Afficher tous les commentaires en une fois - désactiver la pagination
Pour désactiver la pagination et afficher tous les commentaires en une fois, définissez startingPage sur -1.
Run Déplacer la zone de réponse après les commentaires
Par défaut la zone de saisie des commentaires se trouve avant le fil de commentaires. Cependant, en définissant ce paramètre de configuration sur true nous pouvons la déplacer après.
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget :
Limiter la longueur des commentaires
Le nombre maximal de caractères autorisés dans le champ de saisie du commentaire peut être limité par le paramètre maxCommentCharacterLength.
La valeur par défaut est 2000.
Les éléments tels que les URL d'images ne sont pas pris en compte dans le calcul de la longueur.
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget :
Désactiver les commentaires multi-lignes
Par défaut, FastComments permettra à l'utilisateur de saisir un commentaire sur autant de lignes qu'il le souhaite, jusqu'à la limite de caractères par défaut.
Cependant, il peut être souhaitable de limiter l'utilisateur à la saisie d'une seule ligne de texte. Quelques cas d'utilisation incluent les enchères en ligne ou le chat en direct, que FastComments peut être utilisé pour.
Nous activons le drapeau useSingleLineCommentInput comme suit :
Run Ceci peut aussi être fait sans code. Dans la page de personnalisation du widget, voir la section "Enable Single-Line Comment Input".
Notez que les commentaires sur chaque page pour chaque direction de tri sont pré-calculés, donc toutes les directions de tri ont les mêmes performances.
Limiter le nombre de commentaires par utilisateur
Par défaut, chaque utilisateur peut soumettre jusqu'à 5 comments dans la même minute.
Cela est suivi par user id, anon user id, et ip address (hachée).
Cela peut être personnalisé sans code, sur la page de personnalisation du widget :
Remarque : si vous utilisez la comment creation API, vous pouvez vouloir transmettre l'adresse ip originale de l'utilisateur dans la requête vers notre backend afin que le rate limiting soit appliqué
par utilisateur et non globalement à votre compte.
Empêcher les nouveaux commentaires de premier niveau
Définir noNewRootComments sur true fera en sorte que le widget masque la zone de réponse racine, mais permettra toujours aux utilisateurs de répondre
aux commentaires enfants. Vous pouvez, par exemple, définir ceci de façon conditionnelle au chargement de la page pour n'autoriser que certains utilisateurs à laisser des commentaires de niveau supérieur.
Run Profondeur maximale des réponses
Par défaut, FastComments autorise un emboîtement illimité des réponses, créant une structure de fil où les utilisateurs peuvent répondre indéfiniment à des réponses.
L'option maxReplyDepth vous permet de limiter la profondeur des fils de réponses. Lorsque la profondeur maximale est atteinte, les utilisateurs ne verront plus de bouton de réponse sur les commentaires à ce niveau.
Run Avec maxReplyDepth réglé sur 2 :
- Les utilisateurs peuvent commenter au niveau supérieur (profondeur 0)
- Les utilisateurs peuvent répondre aux commentaires de niveau supérieur (profondeur 1)
- Les utilisateurs peuvent répondre à ces réponses (profondeur 2)
- Aucune réponse supplémentaire n'est autorisée au-delà de la profondeur 2
Définir sur 1 n'autoriserait que les réponses aux commentaires de niveau supérieur, créant une structure de discussion plus plate.
Définir maxReplyDepth à 0 désactiverait toutes les réponses, n'autorisant que les commentaires de niveau supérieur. Si non spécifié, les réponses peuvent être imbriquées sans limite.
Présentation du Single Sign-On (SSO)
SSO, ou authentification unique, est un ensemble de conventions utilisé pour vous permettre, à vous ou à vos utilisateurs, d'utiliser FastComments sans avoir à créer un autre compte.
Si vous n'autorisez pas les commentaires anonymes, un compte est requis pour commenter avec FastComments. Nous rendons ce processus d'inscription très simple - l'utilisateur laisse simplement son e-mail lorsqu'il commente. Cependant, nous comprenons que même cela représente une friction supplémentaire que certains sites souhaitent éviter.
Nous pouvons réduire cette friction en n'ayant qu'un seul flux de connexion pour l'ensemble de votre site.
Comment l'obtenir ?
Tous les types de comptes ont actuellement accès au SSO. Cependant, le nombre maximal d'utilisateurs SSO variera en fonction de votre forfait. Comme pour les autres fonctionnalités, les plans Pro et supérieurs offrent un support de développement direct.
Comparons les options, puis examinons les détails de chacune.
Migration des utilisateurs et des commentaires
Lorsque vous migrez depuis une plateforme avec SSO comme Disqus, vous aurez déjà des utilisateurs et leurs commentaires.
Les commentaires sont importés dans le cadre de votre migration, soit via l'API, notre interface d'importation, soit via le support client. L'interface d'importation est préférée si elle prend en charge la plateforme depuis laquelle vous migrez, car elle intègre la gestion des erreurs, l'extraction et le téléversement des avatars et médias, ainsi qu'un système de suivi des tâches par lots.
Les utilisateurs eux-mêmes sont ajoutés automatiquement lorsqu'ils consultent des fils de commentaires pour la première fois. Alternativement, ils peuvent être ajoutés à l'avance via l'API, mais ce travail n'offre pas beaucoup d'avantages.
Si les commentaires sont importés et que les utilisateurs SSO ne sont pas ajoutés manuellement via l'API, alors les commentaires seront automatiquement migrés vers le compte de l'utilisateur la première fois que celui-ci est créé lorsqu'il consulte un fil de commentaires. Ils pourront alors gérer, modifier et supprimer les commentaires qu'ils ont initialement écrits.
La migration automatique se fait via l'email ou le nom d'utilisateur. Certaines plateformes n'indiquent pas les emails lors de l'export, comme Disqus, donc nous revenons au nom d'utilisateur dans ce cas.
- Tant que vous fournissez un nom d'utilisateur correspondant, et un e-mail dans la charge utile SSO, nous ajouterons l'e-mail aux objets de commentaire individuels afin que les notifications et mentions fonctionnent.
Si vous souhaitez importer vos commentaires et utilisateurs en même temps, travaillez avec le support pour migrer les commentaires vers les comptes respectifs des utilisateurs après que les utilisateurs ont été importés via l'API.
Pour résumer, le chemin le plus simple pour la migration est :
- Importer les commentaires.
- Les avatars et autres médias sont migrés automatiquement si vous utilisez l'Import UI dans
Manage Data -> Imports.
- Les avatars et autres médias sont migrés automatiquement si vous utilisez l'Import UI dans
- Configurer Secure ou Simple SSO.
- Laisser la migration s'effectuer automatiquement par utilisateur lorsqu'ils se connectent pour la première fois.
- Cela ajoute généralement moins d'une seconde au temps de chargement de la page si l'utilisateur a moins de 50k commentaires.
Utilisateurs WordPress
Si vous utilisez notre plugin WordPress, il n'y a aucun code à écrire ! Allez simplement sur la page d'administration du plugin, cliquez sur SSO Settings, puis activez.
Cela vous mènera à un assistant en un seul clic qui créera votre clé API, l'enverra à votre installation WordPress et activera le SSO. Nous avons regroupé cela en un seul clic pour vous.
Notez que si vous installez le plugin pour la première fois, vous devrez suivre le processus d'installation avant de voir la page d'administration avec le bouton SSO Settings.
WordPress SSO - Moderators
Notez qu'actuellement pour que le badge "Moderator" apparaisse à côté de vos modérateurs lorsqu'ils commentent avec le plugin FastComments pour WordPress, ils doivent également être ajoutés en tant que Moderator dans le tableau de bord FastComments, et avoir leur e-mail vérifié.
Intégrations personnalisées
Pour les intégrations personnalisées, il existe deux options.
Option One - Secure SSO
Avec Secure SSO, FastComments sait que l'utilisateur qui commente, vote et lit les commentaires est un véritable utilisateur de votre site.
Tant que vous créez une charge utile valide, l'utilisateur aura toujours une expérience de commentaire transparente.
Avec Secure SSO, la charge utile SSO est créée côté serveur en utilisant l'authentification HMAC puis transmise au widget côté client.
Avec Secure SSO, le compte de l'utilisateur est complètement séparé du reste de la base d'utilisateurs FastComments. Cela signifie que si nous avons deux partenaires Company A et Company B, chacun peut avoir un utilisateur SSO avec le nom d'utilisateur "Bob".
Exigences
- Quelques connaissances de base en développement backend.
- Quelques connaissances de base sur la gestion des clés API secrètes.
- Quelques connaissances de base en développement d'API ou en rendu côté serveur.
Avantages
- Sécurisé.
- Expérience de commentaire transparente.
Inconvénients
- Nécessite du développement backend.
Mise à jour des données utilisateur
Avec Secure SSO, chaque fois que vous transmettez la charge utile utilisateur sso, nous mettons à jour leur utilisateur avec les informations les plus récentes. Par exemple, si
l'utilisateur a un nom d'utilisateur X, et que vous transmettez Y dans la charge utile SSO, son nom d'utilisateur deviendra Y.
Si vous souhaitez supprimer des valeurs en utilisant cette approche, définissez-les sur null (pas undefined).
Secure SSO API
Nous fournissons également une API pour interagir avec les utilisateurs SSO. Voir la documentation.
Notez que lors de l'utilisation de Secure SSO, les utilisateurs sont automatiquement créés en coulisses au chargement de la page. Vous n'avez pas à importer massivement vos utilisateurs.
Option Two - Simple SSO
L'alternative à Secure SSO est de simplement transmettre les informations de l'utilisateur au widget de commentaires.
Fournir un e-mail avec Simple SSO n'est pas obligatoire, cependant sans cela leurs commentaires apparaîtront comme "Unverified".
Remarque ! Depuis début 2022, les noms d'utilisateur avec Simple SSO n'ont pas besoin d'être uniques sur tout FastComments.com.
Idéalement, Simple SSO ne devrait être choisi que lors du développement sur une plateforme qui ne fournit pas d'accès backend.
Exigences
- Quelques connaissances de base en développement côté client.
- Il faut connaître au moins l'e-mail de l'utilisateur.
Avantages
- Simple.
- Toute l'activité est toujours vérifiée.
- L'utilisateur ne saisit jamais son nom d'utilisateur ni son e-mail.
Inconvénients
- Moins sécurisé que Secure SSO car la charge utile côté client pourrait être fabriquée pour devenir n'importe quel utilisateur.
Simple SSO API
Les utilisateurs créés automatiquement via le flux Simple SSO sont stockés en tant qu'objets SSOUser. Ils peuvent être consultés et gérés via l'API SSOUser. Voir la documentation.
Intégrations personnalisées - Single Sign-On (SSO) sécurisé
FastComments Secure SSO utilise le chiffrement HMAC-SHA256 comme mécanisme pour implémenter le SSO. Nous allons d'abord passer en revue l'architecture globale, fournir des exemples et des étapes détaillées.
Il existe également une documentation concernant la migration depuis d'autres fournisseurs utilisant des mécanismes SSO similaires, ainsi que les différences.
Le flux ressemble à ceci :
Étant donné que Secure SSO implique un développement full-stack, des exemples de code entièrement fonctionnels en Java/Spring, NodeJS/Express et PHP natif sont actuellement sur GitHub.
Bien que nous utilisions ExpressJS dans l'exemple NodeJS et Spring dans l'exemple Java, aucun framework/bibliothèque n'est requis dans ces environnements pour implémenter FastComments SSO — les packages crypto natifs suffisent.
Vous n'avez pas besoin d'écrire de nouveaux endpoints API avec FastComments SSO. Il suffit de chiffrer les informations de l'utilisateur en utilisant votre clé secrète et de transmettre la payload au widget de commentaires.
Récupérez votre clé secrète API
Votre clé secrète API peut être récupérée depuis cette page. Vous pouvez également accéder à cette page en allant dans Mon compte, en cliquant sur la tuile API/SSO, puis en cliquant sur "Get API Secret Key".
Paramètres du widget de commentaires
La documentation API de haut niveau pour le widget de commentaires se trouve ici.
Voyons plus en détail ce que signifient ces paramètres.
Le widget de commentaires prend un objet de configuration — vous passez déjà cet objet si vous utilisez FastComments pour fournir votre tenantId.
Pour activer le SSO, passez un nouvel objet "sso", qui doit contenir les paramètres suivants. Les valeurs doivent être générées côté serveur.
- userDataJSONBase64: The user's data in JSON format, which is then Base64 encoded.
- verificationHash: The HMAC-SHA256 hash created from UNIX_TIME_MILLIS + userDataJSONBase64.
- timestamp: Epoch timestamp, in milliseconds. Must not be in the future, or more than two days in the past.
- loginURL: A URL that the comment widget can show to log the user in.
- logoutURL: A URL that the comment widget can show to log the user out.
- loginCallback: When provided instead of the login URL, a function that the comment widget will invoke when clicking the login button.
- logoutCallback: When provided instead of the logout URL, a function that the comment widget will invoke when clicking the logout button.
Objet utilisateur
The User object contains the following schema:
Modérateurs et administrateurs
Pour les admins et modérateurs, passez les indicateurs isAdmin ou isModerator respectifs dans l'objet SSOUser.
Notifications
Pour activer ou désactiver les notifications, définissez la valeur de optedInNotifications sur true ou false respectivement. La première fois que l'utilisateur charge la page avec cette valeur dans la payload SSO, ses paramètres de notification seront mis à jour.
De plus, si vous souhaitez que les utilisateurs reçoivent des emails de notification pour l'activité sur les pages auxquelles ils sont abonnés (plutôt que seulement des notifications dans l'application), définissez optedInSubscriptionNotifications sur true.
Utilisateurs VIP et labels spéciaux
Vous pouvez afficher un label spécial à côté du nom de l'utilisateur en utilisant le champ optionnel "displayLabel".
Utilisateurs non authentifiés
Pour représenter un utilisateur non authentifié, ne remplissez simplement pas userDataJSONBase64, verificationHash ou timestamp. Fournissez un loginURL.
Ces utilisateurs ne pourront pas commenter et se verront présenter un message de connexion (message, lien ou bouton, selon la configuration).
Exemples directs de sérialisation et de hachage des données utilisateur
Plus de détails et des exemples sont disponibles ici (js), ici (java) et ici (php).
Nous comprenons que toute intégration peut être un processus compliqué et pénible. N'hésitez pas à contacter votre représentant ou à utiliser la page d'assistance.
Intégrations personnalisées - Single Sign-On (SSO) simple
Avec Simple SSO, nous pouvons fournir au widget de commentaires des informations sur l'utilisateur afin qu'il n'ait pas à saisir son nom d'utilisateur ou son e‑mail pour commenter.
Nous pouvons configurer Simple SSO comme suit :
Run L'utilisateur sera connecté et un utilisateur SSO sera créé en arrière-plan. L'utilisateur aura createdFromSimpleSSO défini sur true si récupéré via l'API.
Remarques :
- L'e-mail est l'identifiant unique pour Simple SSO.
- Fournir un e‑mail avec Simple SSO n'est pas obligatoire ; toutefois, par défaut, leurs commentaires s'afficheront comme "Non vérifié". Si aucun e‑mail n'est fourni, l'utilisateur ne peut pas être entièrement authentifié.
- NOUVEAU Depuis janv. 2022 : les noms d'utilisateur n'ont pas besoin d'être uniques sur l'ensemble de fastcomments.com
- Simple SSO peut créer et mettre à jour automatiquement des utilisateurs SSO si un e‑mail est fourni et que l'utilisateur n'a pas été initialement créé via Secure SSO.
- Vous pouvez spécifier des badges pour l'utilisateur avec la propriété
badgeConfig. Le tableaubadgeIdscontient les identifiants des badges à associer à l'utilisateur. Sioverrideest défini surtrue, cela remplacera tous les badges existants affichés sur les commentaires ; s'il estfalse, cela ajoutera aux badges existants.
Intégrations personnalisées - Migration depuis Disqus SSO
Les principales différences entre Disqus et FastComments Secure SSO sont que Disqus utilise SHA1 pour le chiffrement tandis que nous utilisons SHA256.
Cela signifie que la migration depuis Disqus est simple - changez l'algorithme de hachage utilisé de SHA1 à SHA256 et mettez à jour les noms des propriétés transmis à l'UI.
Intégrations personnalisées - Migration depuis Commento SSO
Commento utilise une approche SSO radicalement différente - ils exigent que vous disposiez d'un endpoint qu'ils invoquent pour authentifier l'utilisateur. FastComments est l'inverse - encodez simplement et hachez les informations de l'utilisateur en utilisant votre clé secrète et transmettez-les.
Protéger les fils de commentaires avec le Single Sign-On
FastComments SSO (détails ici) fournit à vos utilisateurs un moyen de commenter sans avoir à se connecter à une autre plateforme.
Cependant, cela seul ne sécurise pas vos fils de commentaires, car par défaut les données des commentaires sont des informations publiques - toute personne pouvant voir la page peut voir les commentaires.
En modifiant un réglage, nous pouvons restreindre la récupération des commentaires sauf si elle est effectuée par un administrateur ou un utilisateur SSO valide.
Configuration sans code
Nous pouvons empêcher l'affichage et l'interaction avec nos fils de commentaires, lorsque le SSO est configuré, en créant une règle de personnalisation.
Lors de cette opération, recherchez SSO, et vous trouverez cette option :
Activez-la et enregistrez la règle de personnalisation.
Protéger uniquement un domaine ou une page spécifique
Pour ne protéger qu'un certain Domain ou Page, nous configurerons simplement la règle de personnalisation pour le faire.
En haut de l'interface de personnalisation, vous trouverez deux champs, Domain et URL ID.
Pour protéger uniquement un domaine particulier, saisissez le domaine en question dans le champ "domain".
Pour protéger une page particulière, saisissez l'URL de la page dans le champ "URL ID". Si vous avez une intégration personnalisée avec FastComments, vous pouvez entrer un type d'ID ici au lieu d'une URL.
Niveaux de sécurité
Lorsque vous exigez le SSO, vous devrez décider si vous exigez SSO simple ou SSO sécurisé. Si vous exigez SSO simple, alors les deux sont autorisés, mais si vous exigez SSO sécurisé alors le contenu doit être récupéré avec une charge utile SSO sécurisé hachée avec votre clé API afin d'être affiché.
L'option de niveau de sécurité apparaîtra lorsque vous sélectionnez "Require SSO To View Comments".
Protection au-delà de la lecture
L'activation de cette option protégera la page ou le domaine contre les commentaires, sauf si l'utilisateur est connecté via SSO.
Pièges
Les utilisateurs qui ont créé des commentaires avant votre intégration SSO ne pourront pas les voir, à moins qu'ils ne se connectent via votre intégration SSO.
Autoriser les commentaires anonymes
Par défaut, FastComments exigera une adresse e-mail pour commenter. Elle n'a pas besoin d'être valide, cependant jusqu'à ce que l'utilisateur clique sur le lien qui lui a été envoyé, son commentaire affichera une étiquette "Commentaire non vérifié".
Cependant, nous pouvons supprimer l'obligation d'indiquer une adresse e-mail. Le champ de saisie de l'adresse e-mail restera visible, mais ne sera plus obligatoire.
Cela peut être configuré via l'interface de personnalisation du widget :
Empêcher l'expiration des commentaires anonymes
FastComments peut être configuré pour supprimer les commentaires non vérifiés après un nombre de jours souhaité. Cela aide à lutter contre le spam.
Par défaut, il ne le fait pas.
Cela peut être configuré, ou désactivé, via la page Paramètres de modération.
Désactiver les champs e-mail
Lorsque les utilisateurs commentent et qu'ils ne sont pas connectés, on leur demandera de fournir leur adresse e-mail.
Cela créera une "session non vérifiée" pour cet utilisateur, et nous leur demanderons de vérifier cette session par e-mail.
Pour certains sites ou applications, il est souhaitable de ne pas demander l'adresse e-mail à l'utilisateur lorsqu'il commente ou vote.
Activer les commentaires anonymes rend le champ d'adresse e-mail optionnel. Cependant, nous pouvons le désactiver complètement. D'abord, activez les commentaires anonymes, puis l'option pour désactiver les champs d'adresse e-mail apparaîtra.
Avec cette option activée, les champs d'adresse e-mail ne s'afficheront pas du tout dans tous nos produits de commentaires.
Notez qu'avec cette configuration, tous les commentaires seront non vérifiés à moins que l'utilisateur ne crée un compte et ne se connecte à https://fastcomments.com.
Vous pouvez envisager de désactiver le label non vérifié.
Désactiver l'étiquette non vérifiée
Par défaut, FastComments affichera un label "Commentaire non vérifié" pour les commentaires qui ont été laissés pour un utilisateur qui a une session de navigateur non vérifiée. En savoir plus sur les commentaires non vérifiés ici.
Run De plus, cette fonctionnalité peut être utilisée, sans écrire de code, dans l'interface de personnalisation :
Autoriser le vote anonyme
Lorsque les utilisateurs tentent de voter sur un commentaire, et qu'ils ne sont pas connectés, il leur sera demandé de fournir leur nom d'utilisateur et leur adresse e-mail.
Nous pouvons supprimer cette exigence, permettant à quiconque de voter sur un commentaire sans laisser aucune information.
Définir un nom d'utilisateur par défaut
Lorsque les utilisateurs commentent ou votent et qu'ils ne sont pas connectés, on leur demandera de fournir leur adresse e-mail et leur nom d'utilisateur.
Dans le cas de commentaires anonymes, il est parfois souhaitable de définir un nom d'utilisateur par défaut pour réduire la friction lors de la publication d'un commentaire. Cela peut être fait depuis l'interface de personnalisation. Le commentaire anonyme doit d'abord être activé.
Fonctions de rappel
Toutes les bibliothèques pour le widget de commentaires (actuellement Angular, React, Vue) prennent en charge les callbacks.
Les callbacks sont spécifiés dans l'objet de configuration, avec la même signature pour chaque bibliothèque.
Les callbacks pris en charge sont :
- onInit
- onAuthenticationChange
- onRender
- commentCountUpdated
- onReplySuccess
- onVoteSuccess
- onImageClicked
- onOpenProfile
- onCommentSubmitStart
- onCommentsRendered
Les signatures exactes se trouvent dans les définitions TypeScript.
Voici un exemple avec tous les callbacks utilisés :
Run Définir manuellement la locale de l'utilisateur
Par défaut, FastComments affichera le widget de commentaires dans la locale déterminée par le système et le navigateur de l'utilisateur.
Lorsqu'un utilisateur commente ou se connecte, nous mettons à jour sa dernière locale utilisée et l'utilisons également pour l'envoi des e-mails.
Cela affecte la manière dont le widget de commentaires est traduit pour l'utilisateur. La locale se compose de la langue et de la région de l'utilisateur ; configurer la locale modifiera généralement la langue utilisée pour afficher le texte à l'utilisateur.
Via l'interface utilisateur
Cela peut être défini à l'aide de l'interface de personnalisation du widget. Voir l'option "Locale / Language" :
Via le code
Cela peut être remplacé par la locale souhaitée.
Run Langues et codes de locale pris en charge
Remarque SSO
Si vous utilisez SSO, vous souhaiterez peut-être passer la locale de l'utilisateur dans l'objet utilisateur, afin que les e-mails et autres éléments soient correctement localisés pour cet utilisateur.
Limiter les langues autorisées
Par défaut, FastComments ne limite pas les langues utilisées pour commenter.
Il peut être souhaitable de limiter les langues qu'utilise une communauté.
Cela peut être configuré sans code, sur la page de personnalisation du widget :
Le système analysera leur commentaire et déterminera sa langue, puis la comparera à la liste autorisée.
Si le commentaire est rédigé dans une langue qui n'est pas autorisée, un message d'erreur localisé s'affiche.
Titres de page
Le titre actuel de la page est associé à l'urlId spécifié et enregistré pour être utilisé dans les outils de modération.
Par défaut, il est récupéré depuis document.title.
Si vous le souhaitez, vous pouvez spécifier votre propre titre de page comme suit :
Run Empêcher les nouvelles réponses et désactiver les votes
Il est possible de verrouiller les commentaires afin qu'aucun nouveau commentaire ou vote ne puisse être laissé en définissant le drapeau readonly sur true.
Les commentaires ne pourront également pas être modifiés ou supprimés.
Run Cela peut être personnalisé sans code, sur la page de personnalisation du widget, pour un domaine entier ou une page :
Mise à jour !
Depuis novembre 2022, les fils peuvent être verrouillés ou déverrouillés en direct par les administrateurs et les modérateurs via le menu à trois points au-dessus de la zone de réponse.
Cela empêchera les nouveaux commentaires, tout en permettant le vote et en autorisant les utilisateurs à supprimer leurs commentaires s'ils le souhaitent, alors que readonly n'autorise pas ces actions.
Cela correspond au champ isClosed dans l'API Page.
Restreindre les domaines des liens
Par défaut, FastComments permet de lier vers n'importe quel site externe.
Cela peut être restreint à une liste souhaitée de sites ou de domaines. Toute tentative de publier un lien vers un site ou domaine qui ne figure pas dans la liste définie provoquera l'affichage d'une erreur à l'utilisateur.
Cette validation ne concerne que le widget de commentaires et l'API. Les imports ne sont pas affectés.
Cela se fait sans code, depuis la page de personnalisation du widget :
Le nombre de commentaires et le comptage de toutes les réponses imbriquées
Le nombre de commentaires affiché en haut du widget de commentaires peut soit afficher tous les commentaires "de premier niveau", c'est-à-dire les réponses qui sont des réponses directement à la page ou à l'article lui-même, soit il peut s'agir d'un décompte de tous les commentaires imbriqués.
Par défaut, c'est true — il s'agit du décompte de ce dernier cas — tous les commentaires. Dans les anciennes versions du widget de commentaires la valeur par défaut est false.
Nous pouvons modifier le comportement, de sorte qu'il s'agisse d'un décompte de tous les commentaires imbriqués en définissant le drapeau countAll sur true.
Run Si nous voulions que le décompte reflète uniquement les commentaires de premier niveau, nous réglons le drapeau sur false.
Run Cela ne peut actuellement pas être personnalisé sans modifications du code.
Activer les liens des commentateurs
Par défaut, FastComments ne demandera à l'utilisateur que son commentaire, son nom d'utilisateur et son adresse e-mail.
Cependant, dans certains cas, vous pouvez souhaiter que l'utilisateur laisse un lien vers son propre blog ou site web.
Vous pouvez activer l'affichage d'un champ supplémentaire pour saisir l'URL du site web de l'utilisateur en définissant le flag enableCommenterLinks sur true:
Run Lorsque cette URL est fournie, le compte de l'utilisateur sera mis à jour et le nom d'utilisateur affiché sur tous ses commentaires passés et futurs renverra vers cette URL.
Cela peut être personnalisé sans code, depuis la page de personnalisation du widget :
Groupes de modération
Une liste d'identifiants générés depuis la page Groupes de modération.
Si elle est spécifiée, les commentaires laissés en utilisant la configuration spécifiée contiendront le même ensemble de moderationGroupIds.
Si un Moderator a un ou plusieurs Groupes de modération définis, il/elle
ne verra que les commentaires de la page Moderate Comments associés à son ou ses groupe(s).
Run Identifiants de groupes pour mentions
Une liste d'ids à utiliser pour l'autocomplétion des @mentions. Utile lorsque vous souhaitez empêcher de taguer des utilisateurs qui n'ont pas de groupes communs.
Si spécifié, seuls les utilisateurs appartenant à d'autres groupes seront proposés dans l'autocomplétion après avoir tapé le caractère @.
Run Contournement des cookies tiers
Pour l'authentification, FastComments dépend de l'activation des cookies tiers dans votre navigateur. Sans eux, les utilisateurs devront toujours laisser leur adresse e-mail pour commenter (à moins que le champ de saisie de l'e-mail soit masqué), et leurs commentaires apparaîtront toujours comme non vérifiés (par défaut).
Pour contourner cela, vous pouvez activer le contournement des cookies tiers.
Lorsque ce paramètre est activé, un petit popup apparaît affichant un message indiquant que l'utilisateur est en cours de connexion. Ce popup s'affiche chaque fois que l'utilisateur interagit avec le widget de commentaires ; par exemple, lorsqu'il laisse un commentaire.
Nous pouvons le faire dans le code en définissant le flag enableThirdPartyCookieBypass à true :
Run Nous pouvons également configurer cela via l'interface de personnalisation du widget, sous Enable Third-Party Cookie Popup :
Suppression des commentaires avec réponses
Par défaut, les utilisateurs peuvent supprimer leurs propres commentaires. De plus, la suppression de leur commentaire supprime automatiquement tous les commentaires enfants et transitoires du fil. Ce comportement est également actif.
Vous pouvez restreindre cela de la manière suivante :
- À la place, anonymiser le commentaire supprimé (définir name et text sur
[deleted]ou une valeur personnalisée). - Ne pas autoriser la suppression de commentaires lorsqu'il y a des réponses. Un message d'erreur personnalisable est affiché.
- Restreindre la suppression lorsqu'un commentaire a des réponses uniquement aux administrateurs et modérateurs.
Cela peut être configuré via la section Comment Thread Deletion dans l'UI de personnalisation du widget.
Afficher les badges dans la barre supérieure
Par défaut, FastComments n'affiche les badges des utilisateurs que sur leurs commentaires dans le fil de discussion.
Cependant, nous pouvons afficher les badges des utilisateurs à côté de leur nom, au-dessus du formulaire de commentaire, en activant cette fonctionnalité dans la page de personnalisation du widget :
Cela affichera les badges de l'utilisateur à côté de son nom dans la zone de la barre supérieure, rendant ses réalisations et son statut plus visibles lorsqu'il rédige un commentaire.
Notez que cette fonctionnalité doit être activée dans l'interface de personnalisation du widget pour fonctionner. Vous pouvez éventuellement définir le flag showBadgesInTopBar sur false dans votre configuration de code pour la désactiver sélectivement, même si elle est activée côté serveur :
Run