Add Comment Widgets to Your React Native App
To je uradna knjižnica React Native za FastComments.
Vdelajte gradnike za komentiranje v živo, klepet in recenzije v vašo aplikacijo React Native.
Repozitorij
Predstavitev v živo 
Za ogled vseh pripomočkov in tokov, ki tečejo lokalno proti javnemu demo najemniku, sklonirajte repozitorij in zaženite:
yarn bootstrap
cd example
yarn ios # ali: yarn android, yarn webVstopna točka predstavitve je example/src/ShowcaseApp.tsx — ena aplikacija, ki prikaže vse pripomočke, teme in tokove.
Cilj yarn web uporablja react-native-web + react-native-web-webview (ki WebView upodobi kot iframe). Uporabno za hitre vizualne smoke teste v brskalniku; API-ji WebView, ki so na voljo samo v nativen okolju, kot so injectJavaScript in onShouldStartLoadWithRequest, se v brskalniku ne bodo v celoti obnašali.
Namestitev
npm install react-native-webview --save
npm install fastcomments-react-native --saveRazmislite o uporabi izvornega SDK-ja
Ta knjižnica uporablja webview okoli knjižnice VanillaJS.
FastComments zdaj podpira popolnoma nativno implementacijo našega odjemalca kot del fastcomments-react-native-sdk. Če želite popolnoma nativno implementacijo, si jo oglejte tam.
Uporaba - pripomoček za komentarje v živo
API se nekoliko razlikuje v primerjavi z fastcomments-react. Pri native različici posredujemo konfiguracijski objekt, ki sledi tej strukturi.
import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Vaš tenant id. Lahko ga pridobite s https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // ID ali URL nitke komentarjev v vaši aplikaciji.
const myAppPageUrl = 'https://example.com/external-page'; // Neobvezno lahko nastavite URL do zunanje strani
const myAppPageTitle = 'Example Title'; // ... in verjetno želite naslov za to vsebino
const [config, setConfig] = useState({
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
});
// Z klicem setConfig() lahko naredimo stvari, kot so sprememba trenutne strani ali trenutno prijavljenega uporabnika
// Oglejte si example/src/App.tsx
return (
<FastCommentsCommentWidget config={config}/>
);Uporaba - pripomoček za klepet v živo
import { FastCommentsLiveChatWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // ID vašega najemnika. Lahko ga pridobite na https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // ID ali URL niti komentarjev v vaši aplikaciji.
const myAppPageUrl = 'https://example.com/external-page'; // Neobvezno lahko nastavite URL do zunanje strani
const myAppPageTitle = 'Example Title'; // ... in verjetno boste želeli naslov za to vsebino
const config = {
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
};
return (
<FastCommentsLiveChatWidget config={config}/>
);Uporaba - SSO (enotna prijava)
FastComments uporablja HMAC za varno SSO. Za uporabo naj vaš strežniški del ustvari SSO objekt (sso konfiguracijska lastnost) in ga
posreduje widgetu za komentarje.
Primeri za različne backende najdete tukaj: https://github.com/FastComments/fastcomments-code-examples/tree/master/sso
Peer odvisnosti
fastcomments-react-native zahteva react-native-webview. Zato sledite korakom za namestitev react-native-webview.
Regija računa (POZOR: stranke iz EU)
Če je vaš račun v EU, nastavite region = 'eu' v konfiguraciji widgeta.
V nasprotnem primeru ni potrebno definirati region.
Stanje vzdrževanja
Te komponente so ovitki okoli naših osnovnih VanillaJS komponent. Te komponente lahko samodejno posodobimo (odpravimo napake, dodamo funkcionalnosti) brez objave te knjižnice, zato čeprav morda ne bo objavljena nekaj časa, to ne pomeni, da FastComments ni v aktivnem razvoju! Vabljeni, da preverite naš blog za posodobitve. Prelomne spremembe API-ja ali nove funkcionalnosti nikoli ne bodo vključene v osnovno jedrno knjižnico brez povišanja različice v tej knjižnici.
Potrebujete pomoč?
Če naletite na kakršnekoli težave ali imate vprašanja glede knjižnice React Native, prosimo:
Prispevanje
Prispevki so dobrodošli! Prosimo, obiščite GitHub repozitorij za navodila za prispevanje.