Add Comments to Your React App
Ceci est la bibliothèque React officielle pour FastComments.
Intégrez des widgets de commentaires en direct, de chat et de revue dans votre application React.
Dépôt
Démo en direct 
Essayez chaque widget en direct sur https://fastcomments.com/commenting-system-for-react.
Installation
NPM
npm install --save fastcomments-reactYarn
yarn add fastcomments-reactPrésentation en direct
Pour voir tous les widgets et flux s'exécutant localement contre le locataire public demo, clonez le dépôt et lancez :
cd examples/example-showcase
npm install
npm startChaque widget/flux a sa propre vue sous examples/example-showcase/src/views/ que vous pouvez copier directement dans votre propre application React.
Exemples
Les cas d'utilisation individuels (mode sombre, pagination, etc.) se trouvent dans leurs propres dossiers sous examples/. Chacun peut être configuré avec npm install et démarré avec npm start.
Utilisation
Le composant principal du widget
Le composant FastCommentsCommentWidget contient le widget de commentaires FastComments en direct.
Remplacez "demo" ci‑dessous par votre "tenantId" - disponible ici dans la zone d'administration FastComments.
Le widget prend en charge de nombreuses options - voir FastCommentsCommentWidgetConfig dans src/index.tsx.
import React, { Component } from 'react'
import {FastCommentsCommentWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentWidget tenantId="demo" />
}
}Mettre à jour la page courante (pour les SPAs)
Pour mettre à jour la page/article auquel le fil de commentaires est lié, vous devez mettre à jour les paramètres de configuration "urlId" et "url". Voir l'exemple et l'explication ici.
Région du compte (ATTENTION : clients UE)
Si vous êtes dans l'UE, vous devrez indiquer aux widgets clients dans quelle région vous vous trouvez. Voir examples/example-eu;
Sinon, vous n'avez pas à définir region.
Le widget de comptage des commentaires
Le composant FastCommentsCommentCountWidget contient le widget de comptage des commentaires FastComments en direct.
Remplacez "demo" ci‑dessous par votre "tenantId" - disponible ici dans la zone d'administration FastComments.
Voir FastCommentsCommentCountConfig dans src/index.tsx pour les options de configuration prises en charge.
import React, { Component } from 'react'
import {FastCommentsCommentCountWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentCountWidget tenantId="demo" urlId="https://example.com/some-page-or-id" />
}
}Natif
Pour une implémentation entièrement native de FastComments, voir fastcomments-react-native-sdk.
Pour un wrapper React Native de cette bibliothèque, utilisant une webview, voir fastcomments-react-native.
Statut de maintenance
Ces composants sont des enveloppes autour de nos composants VanillaJS de base. Nous pouvons mettre à jour automatiquement ces composants (corriger des bugs, ajouter des fonctionnalités) sans publier cette bibliothèque, donc, même s'il se peut qu'elle ne soit pas publiée pendant un certain temps, cela ne signifie pas que FastComments n'est pas en développement actif ! N'hésitez pas à consulter notre blog pour les mises à jour. Les changements majeurs d'API ou les nouvelles fonctionnalités ne seront jamais intégrés à la bibliothèque de base sous-jacente sans une incrémentation de version dans cette bibliothèque.
Besoin d'aide ?
Si vous rencontrez des problèmes ou avez des questions concernant la bibliothèque React, veuillez :
Contribuer
Les contributions sont les bienvenues ! Veuillez consulter le dépôt GitHub pour les directives de contribution.