
Język 🇵🇱 Polski
Pierwsze kroki
Dokumentacja
Użycie
FastComments React Native Library
To jest oficjalna biblioteka React Native dla FastComments.
Widżety komentarzy FastComments dla React Native
Repozytorium
Instalacja 
npm install react-native-webview@13.6.4 --save
npm install fastcomments-react-native --save
Uwaga: Na lipiec 2024 wydaje się, że react-native-webview ma błąd, więc najlepiej przypiąć do 13.6.4 - nie używaj ^ aby uzyskać najnowszą poprawkę.
Rozważ użycie natywnego SDK 
Ta biblioteka używa webview wokół biblioteki VanillaJS.
FastComments teraz obsługuje w pełni natywną implementację naszego klienta w ramach fastcomments-react-native-sdk. Jeśli chcesz całkowicie natywnej implementacji, warto tam zajrzeć.
Użycie - widżet komentarzy na żywo 
The API jest nieco inne w porównaniu do fastcomments-react. W wersji natywnej przekazujemy obiekt konfiguracyjny, który ma tę strukturę.
import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Twój tenant id. Można go pobrać z https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // ID lub URL wątku komentarzy w Twojej aplikacji.
const myAppPageUrl = 'https://example.com/external-page'; // opcjonalnie możesz ustawić URL prowadzący do zewnętrznej strony
const myAppPageTitle = 'Example Title'; // ... i prawdopodobnie chcesz tytuł dla tej treści
const [config, setConfig] = useState({
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
});
// wywołując setConfig(), możemy robić rzeczy takie jak zmiana aktualnej strony lub aktualnie zalogowanego użytkownika
// Zobacz example/src/App.tsx
return (
<FastCommentsCommentWidget config={config}/>
);
Użycie - widżet czatu na żywo 
import { FastCommentsLiveChatWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Twój tenant id. Można go pobrać z https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // ID lub URL wątku komentarzy w Twojej aplikacji.
const myAppPageUrl = 'https://example.com/external-page'; // możesz opcjonalnie ustawić URL do zewnętrznej strony
const myAppPageTitle = 'Example Title'; // ... i prawdopodobnie będziesz chciał tytuł dla tej treści
const config = {
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
};
return (
<FastCommentsLiveChatWidget config={config}/>
);
Użycie - SSO 
FastComments używa HMAC do bezpiecznego SSO. Aby korzystać, skonfiguruj swój backend tak, aby utworzył obiekt SSO (sso właściwość konfiguracyjna) i przekaż go
do widżetu komentarzy.
Możesz znaleźć przykłady dla różnych backendów tutaj: https://github.com/FastComments/fastcomments-code-examples/tree/master/sso
Zależności peer 
fastcomments-react-native wymaga react-native-webview. Należy więc wykonać kroki instalacyjne dla react-native-webview.
Region konta (UWAGA: klienci z UE)
Jeśli Twoje konto znajduje się w UE, ustaw region = 'eu' w konfiguracji widżetu.
W przeciwnym razie nie musisz definiować region.
Potrzebujesz pomocy?
Jeśli napotkasz jakiekolwiek problemy lub masz pytania dotyczące biblioteki React Native, prosimy:
Współtworzenie
Zachęcamy do współpracy! Odwiedź repozytorium GitHub po wytyczne dotyczące współtworzenia.