Aggiungi commenti alla tua app React
Questa è la libreria React ufficiale per FastComments.
Incorpora widget per commenti in tempo reale, chat e revisione nella tua app React.
Repository
Demo dal vivo 
Prova ogni widget dal vivo su https://fastcomments.com/commenting-system-for-react.
Installazione
NPM
npm install --save fastcomments-reactYarn
yarn add fastcomments-reactVetrina live
Per vedere tutti i widget e i flussi in esecuzione localmente contro il tenant pubblico demo, clona il repository e esegui:
cd examples/example-showcase
npm install
npm run devOgni widget/flusso ha la propria vista sotto examples/example-showcase/src/views/ che puoi copiare direttamente nella tua app React.
Esempi
I casi d'uso individuali (modalità scura, paginazione, ecc.) vivono nelle proprie cartelle sotto examples/. Ognuno può essere configurato con npm install e avviato con npm run dev (Vite).
Utilizzo
Il componente principale del widget
Il componente FastCommentsCommentWidget contiene il widget dei commenti FastComments in tempo reale.
Sostituisci "demo" qui sotto con il tuo "tenantId" - disponibile here nell'area di amministrazione FastComments.
Il widget supporta molte opzioni - vedi FastCommentsCommentWidgetConfig in src/index.tsx.
import React, { Component } from 'react'
import {FastCommentsCommentWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentWidget tenantId="demo" />
}
}Aggiornamento della pagina corrente (per le SPA)
Per aggiornare la pagina/articolo a cui è legato il thread dei commenti, devi aggiornare i parametri di configurazione "urlId" e "url". Vedi l'esempio e la spiegazione here.
Regione dell'account (ATTENZIONE: clienti UE)
Se ti trovi nell'UE, dovrai indicare ai widget client in quale regione ti trovi. Vedi examples/example-eu;
Altrimenti, non è necessario definire region.
Il widget del conteggio dei commenti
Il componente FastCommentsCommentCountWidget contiene il widget di conteggio dei commenti FastComments in tempo reale.
Sostituisci "demo" qui sotto con il tuo "tenantId" - disponibile here nell'area di amministrazione FastComments.
Consulta FastCommentsCommentCountConfig in src/index.tsx per le opzioni di configurazione supportate.
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" />
}
}Nativo
Per un'implementazione completamente nativa di FastComments, vedi fastcomments-react-native-sdk.
Per un wrapper React Native di questa libreria, che utilizza una webview, vedi fastcomments-react-native.
Stato di manutenzione
Questi componenti sono wrapper attorno ai nostri componenti core VanillaJS. Possiamo aggiornare automaticamente questi componenti (correggere bug, aggiungere funzionalità) senza pubblicare questa libreria, quindi anche se potrebbe non essere pubblicata per un po' ciò non significa che FastComments non sia in sviluppo attivo! Sentitevi liberi di consultare il nostro blog per aggiornamenti. Modifiche incompatibili dell'API o funzionalità non verranno mai inviate alla libreria core sottostante senza un aumento di versione in questa libreria.
Hai bisogno di aiuto?
Se riscontri problemi o hai domande sulla libreria React, per favore:
Contribuire
I contributi sono benvenuti! Visita il repository GitHub per le linee guida per i contributi.