Add Comments to Your React App
Ceci est la bibliothèque React officielle pour FastComments.
Intégrez des widgets de commentaires en direct, de clavardage et de revue dans votre application React.
Répertoire
Démonstration 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-reactVitrine en direct
Pour voir tous les widgets et flux s'exécuter localement contre le locataire public demo, clonez le dépôt et exécutez :
cd examples/example-showcase
npm install
npm startChaque widget/flux possède 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 - consultez FastCommentsCommentWidgetConfig dans src/index.tsx.
import React, { Component } from 'react'
import {FastCommentsCommentWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentWidget tenantId="demo" />
}
}Mise à jour de la page actuelle (pour les SPA)
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 de l'UE)
Si vous êtes dans l'UE, vous devrez indiquer aux widgets client dans quelle région vous vous trouvez. Voir examples/example-eu;
Sinon, vous n'avez pas à définir region.
Le widget du compteur de 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.
Consultez 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, consultez fastcomments-react-native-sdk.
Pour un wrapper React Native de cette bibliothèque, utilisant une webview, consultez fastcomments-react-native.
Statut de maintenance
Ces composants sont des wrappers autour de nos composants VanillaJS principaux. Nous pouvons mettre à jour automatiquement ces composants (corriger des bogues, ajouter des fonctionnalités) sans publier cette bibliothèque, donc même si elle peut ne pas être 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 blogue pour les mises à jour. Les changements d'API incompatibles ou les nouvelles fonctionnalités ne seront jamais intégrés à la bibliothèque principale sous-jacente sans une mise à jour de version de 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.