Add Comment Widgets to Your React Native App
Ovo je službena React Native biblioteka za FastComments.
FastComments widgeti za komentiranje za React Native
Repozitorij
Prikaz uživo 
Da biste vidjeli svaki widget i flow koji se izvršava lokalno u javnom demo tenantu, klonirajte repozitorij i pokrenite:
yarn bootstrap
cd example
yarn ios # or: yarn android, yarn webUlazna točka pokazne aplikacije je example/src/ShowcaseApp.tsx — jedna aplikacija koja prikazuje sve widgete, teme i tokove.
Cilj yarn web koristi react-native-web + react-native-web-webview (koji prikazuje WebView kao iframe). Korisno za brze vizualne smoke testove u pregledniku; WebView API-ji koji su samo za native, poput injectJavaScript i onShouldStartLoadWithRequest, neće se u potpunosti ponašati na webu.
Instalacija
npm install react-native-webview --save
npm install fastcomments-react-native --saveRazmotrite izvorni SDK
Ova biblioteka koristi webview kao omotač oko knjižnice VanillaJS.
FastComments sada podržava potpuno nativnu implementaciju našeg klijenta kao dio fastcomments-react-native-sdk. Ako želite potpuno nativnu implementaciju, možda biste htjeli pogledati tamo.
Upotreba - widget za komentare uživo
API je nešto drugačiji u odnosu na fastcomments-react. U native verziji prosljeđujemo konfiguracijski objekt koji slijedi ovu strukturu.
import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Vaš tenant id. Može se dohvatiti s https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // ID ili URL niti komentara u vašoj aplikaciji.
const myAppPageUrl = 'https://example.com/external-page'; // možete opcionalno postaviti URL na vanjsku stranicu
const myAppPageTitle = 'Example Title'; // ... i vjerojatno želite naslov za ovaj sadržaj
const [config, setConfig] = useState({
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
});
// pozivom setConfig() možemo raditi stvari poput promjene trenutne stranice ili trenutno prijavljenog korisnika
// Pogledajte example/src/App.tsx
return (
<FastCommentsCommentWidget config={config}/>
);Upotreba - widget za chat uživo
import { FastCommentsLiveChatWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Vaš tenant id. Može se dohvatiti s https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // ID ili URL niti komentara u vašoj aplikaciji.
const myAppPageUrl = 'https://example.com/external-page'; // Opcionalno možete postaviti URL na vanjsku stranicu
const myAppPageTitle = 'Example Title'; // ... i vjerojatno želite naslov za ovaj sadržaj
const config = {
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
};
return (
<FastCommentsLiveChatWidget config={config}/>
);Upotreba - SSO
FastComments koristi HMAC za siguran SSO. Da biste ga koristili, neka vaš backend stvori SSO objekt (sso konfiguracijsko svojstvo) i proslijedi ga
widgetu za komentare.
Primjere za različite backende možete pronaći ovdje: https://github.com/FastComments/fastcomments-code-examples/tree/master/sso
Peer ovisnosti
fastcomments-react-native zahtijeva react-native-webview. Stoga biste trebali slijediti korake instalacije za react-native-webview.
Regija računa (PAŽNJA: kupci iz EU)
Ako se vaš račun nalazi u EU, postavite region = 'eu' u konfiguraciji widgeta.
U suprotnom, ne morate definirati region.
Status održavanja
Te komponente su omotači oko naših temeljnih VanillaJS komponenti. Možemo automatski ažurirati ove komponente (ispraviti greške, dodati značajke) bez objavljivanja ove biblioteke, pa iako možda neće biti objavljena neko vrijeme, to ne znači da FastComments nije u aktivnom razvoju! Slobodno provjerite naš blog za ažuriranja. Promjene koje naruše API ili nove značajke nikada neće biti dodane u temeljnu biblioteku bez povećanja verzije u ovoj biblioteci.
Trebate pomoć?
Ako naiđete na bilo kakve probleme ili imate pitanja u vezi s React Native bibliotekom, molimo:
Doprinosi
Doprinosi su dobrodošli! Molimo posjetite GitHub repozitorij za smjernice za doprinos.