
Język 🇵🇱 Polski
Dokumentacja
Pierwsze kroki
Użycie
Add Comments to Your React App
To jest oficjalna biblioteka React dla FastComments.
Osadź w swojej aplikacji React widżety komentowania na żywo, czatu i recenzji.
Repozytorium
Demo na żywo 
Wypróbuj wszystkie widżety na żywo pod adresem https://fastcomments.com/commenting-system-for-react.
Prezentacja na żywo 
Aby zobaczyć wszystkie widżety i przepływy działające lokalnie wobec publicznego tenanta demo, sklonuj repozytorium i uruchom:
cd examples/example-showcase
npm install
npm start
Każdy widżet/przepływ ma własny widok w examples/example-showcase/src/views/, który możesz skopiować bezpośrednio do swojej aplikacji React.
Przykłady 
Pojedyncze przypadki użycia (tryb ciemny, paginacja itp.) znajdują się w swoich własnych folderach pod examples/. Każdy z nich można skonfigurować poleceniem npm install i uruchomić poleceniem npm start.
Użycie 
Główny komponent widgetu
Komponent FastCommentsCommentWidget zawiera działający widget komentarzy FastComments.
Zastąp "demo" poniżej swoim "tenantId" - dostępnym tutaj w panelu administracyjnym FastComments.
Widget obsługuje wiele opcji - zobacz FastCommentsCommentWidgetConfig w src/index.tsx.
import React, { Component } from 'react'
import {FastCommentsCommentWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentWidget tenantId="demo" />
}
}
Aktualizowanie bieżącej strony (dla SPA)
Aby zaktualizować stronę/artykul, do której powiązany jest wątek komentarzy, musisz zaktualizować parametry konfiguracji "urlId" i "url". Zobacz przykład i wyjaśnienie tutaj.
Region konta (UWAGA: klienci z UE)
Jeżeli znajdujesz się w UE, powinieneś poinformować widgety klienckie, w jakim regionie się znajdujesz. Zobacz examples/example-eu;
w przeciwnym razie nie musisz definiować region.
Widget licznika komentarzy
Komponent FastCommentsCommentCountWidget zawiera działający widget licznika komentarzy FastComments.
Zastąp "demo" poniżej swoim "tenantId" - dostępnym tutaj w panelu administracyjnym FastComments.
Zobacz FastCommentsCommentCountConfig w src/index.tsx, aby poznać obsługiwane opcje konfiguracji.
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" />
}
}
Natywne
Dla całkowicie natywnej implementacji FastComments zobacz fastcomments-react-native-sdk.
Dla wrappera tej biblioteki dla React Native, używającego webview, zobacz fastcomments-react-native.
Status utrzymania 
Te komponenty są nakładkami na nasze podstawowe komponenty VanillaJS. Możemy automatycznie aktualizować te komponenty (naprawiać błędy, dodawać funkcje) bez publikowania tej biblioteki, więc choć może ona nie być opublikowana przez jakiś czas, nie oznacza to, że FastComments nie jest aktywnie rozwijany! Zachęcamy do odwiedzenia naszego bloga w celu uzyskania informacji o aktualizacjach. Zmiany łamiące API lub nowe funkcje nigdy nie zostaną wprowadzone do podstawowej biblioteki bez podniesienia wersji w tej bibliotece.
Potrzebujesz pomocy?
Jeśli napotkasz jakiekolwiek problemy lub masz pytania dotyczące biblioteki React, prosimy:
Współtworzenie
Wkład jest mile widziany! Odwiedź repozytorium na GitHub po wytyczne dotyczące kontrybucji.