
Język 🇵🇱 Polski
Pierwsze kroki
Dokumentacja
Użycie
Add Comment Widgets to Your React Native App
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.