Add Comment Widgets to Your React Native App
Ovo je zvanična React Native biblioteka za FastComments.
Ugradite widgete za komentarisanje uživo, chat i recenzije u vašu React Native aplikaciju.
Repozitorijum
Prikaz uživo 
Da biste videli sve widgete i tokove koji rade lokalno protiv javnog demo tenant-a, klonirajte repo i pokrenite:
yarn bootstrap
cd example
yarn ios # or: yarn android, yarn webUlazna tačka showcase-a 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 renderuje WebView kao iframe). Korisno za brze vizuelne smoke testove u pregledaču; nativni WebView API-ji koji su samo za native, kao što su 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 nativni SDK
Ova biblioteka koristi webview oko VanillaJS biblioteke.
FastComments sada podržava potpuno nativnu implementaciju našeg klijenta u okviru fastcomments-react-native-sdk. Ako želite potpuno nativnu implementaciju, možda biste želeli da tamo pogledate.
Upotreba - Vidžet za komentare uživo
The API je neznatno drugačiji u odnosu na fastcomments-react. U native verziji prosleđujemo config objekat koji odgovara ovoj strukturi.
import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Vaš tenant id. Može se preuzeti sa 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 ka eksternoj stranici
const myAppPageTitle = 'Example Title'; // ... i verovatno želite naslov za ovaj sadržaj
const [config, setConfig] = useState({
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
});
// pozivanjem setConfig(), možemo raditi stvari kao što su promena trenutne stranice ili trenutno prijavljenog korisnika
// Pogledajte example/src/App.tsx
return (
<FastCommentsCommentWidget config={config}/>
);Upotreba - Vidžet za ćaskanje uživo
import { FastCommentsLiveChatWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Vaš tenant id. Može se preuzeti sa https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // ID ili URL nita komentara u vašoj aplikaciji.
const myAppPageUrl = 'https://example.com/external-page'; // Neobavezno možete postaviti URL ka eksternoj stranici
const myAppPageTitle = 'Example Title'; // ... i verovatno ćete želeti 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 kreira SSO objekat (konfiguraciono svojstvo sso) i prosledi ga
komentarskom vidžetu.
Primeri za različite backende možete pronaći ovde: https://github.com/FastComments/fastcomments-code-examples/tree/master/sso
Peer zavisnosti
fastcomments-react-native zahteva react-native-webview. Stoga treba da sledite korake instalacije za react-native-webview.
Regija naloga (PAŽNJA: Kupci iz EU)
Ako se vaš nalog nalazi u EU, postavite region = 'eu' u konfiguraciji widgeta.
U suprotnom, ne morate definisati region.
Status održavanja
Ove komponente su omotači oko naših osnovnih VanillaJS komponenti. Možemo automatski ažurirati ove komponente (ispraviti greške, dodati funkcionalnosti) bez objavljivanja ove biblioteke, pa iako možda neće biti objavljena neko vreme, to ne znači da FastComments nije u aktivnom razvoju! Slobodno pogledajte naš blog za ažuriranja. Prelomne izmene API-ja ili nove funkcionalnosti nikada neće biti isporučene osnovnoj biblioteci bez povećanja verzije ove biblioteke.
Trebate pomoć?
Ako naiđete na bilo kakve probleme ili imate pitanja u vezi React Native biblioteke, molimo:
Doprinosi
Doprinosi su dobrodošli! Molimo posetite GitHub repozitorijum za smernice za doprinos.