
Sprache 🇩🇪 Deutsch
Erste Schritte
Dokumentation
Verwendung
FastComments React Native Library
Dies ist die offizielle React Native-Bibliothek für FastComments.
FastComments-Kommentar-Widgets für React Native
Repository
Installation 
npm install react-native-webview@13.6.4 --save
npm install fastcomments-react-native --save
Hinweis: Stand Juli 2024 scheint react-native-webview einen Fehler zu haben, daher ist es am besten, auf 13.6.4 zu pinnen - verwenden Sie nicht ^, um die neueste Patch-Version zu erhalten.
Das native SDK berücksichtigen 
Diese Bibliothek verwendet eine Webview um die VanillaJS-Bibliothek herum.
FastComments unterstützt jetzt eine vollständig native Implementierung unseres Clients als Teil von fastcomments-react-native-sdk. Wenn Sie eine vollständig native Implementierung wünschen, sollten Sie sich das dort ansehen.
Verwendung - Live-Kommentar-Widget 
Die API unterscheidet sich leicht von fastcomments-react. Bei der nativen Version übergeben wir ein Konfigurationsobjekt, das dieser Struktur folgt.
import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Ihre Tenant-ID. Kann von https://fastcomments.com/auth/my-account/api-secret abgerufen werden
const myAppPageId = 'native-test'; // Die ID oder URL des Kommentar-Threads in Ihrer App.
const myAppPageUrl = 'https://example.com/external-page'; // optional können Sie eine URL zu einer externen Seite angeben
const myAppPageTitle = 'Example Title'; // ... und Sie möchten wahrscheinlich einen Titel für diesen Inhalt
const [config, setConfig] = useState({
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
});
// Durch Aufrufen von setConfig() können wir z. B. die aktuelle Seite oder den aktuell angemeldeten Benutzer ändern
// Siehe example/src/App.tsx
return (
<FastCommentsCommentWidget config={config}/>
);
Verwendung - Live-Chat-Widget 
import { FastCommentsLiveChatWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Ihre Tenant-ID. Kann von https://fastcomments.com/auth/my-account/api-secret abgerufen werden
const myAppPageId = 'native-test'; // Die ID oder URL des Kommentarthreads in Ihrer App.
const myAppPageUrl = 'https://example.com/external-page'; // Sie können optional eine URL zu einer externen Seite angeben
const myAppPageTitle = 'Example Title'; // ... und Sie möchten wahrscheinlich einen Titel für diesen Inhalt
const config = {
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
};
return (
<FastCommentsLiveChatWidget config={config}/>
);
Verwendung - SSO 
FastComments verwendet HMAC für sicheres SSO. Um es zu verwenden, lassen Sie Ihr Backend das SSO-Objekt (sso Konfigurations-Eigenschaft) erstellen und übergeben Sie es
an das Kommentar-Widget.
Sie können Beispiele für verschiedene Backends finden, hier: https://github.com/FastComments/fastcomments-code-examples/tree/master/sso
Peer-Abhängigkeiten 
fastcomments-react-native benötigt react-native-webview. Folgen Sie daher den Installationsschritten für react-native-webview.
Kontoregion (ACHTUNG: EU-Kunden)
Wenn Ihr Konto in der EU angesiedelt ist, setzen Sie region = 'eu' in der Widget-Konfiguration.
Andernfalls müssen Sie region nicht definieren.
Benötigen Sie Hilfe?
Wenn Sie auf Probleme stoßen oder Fragen zur React Native-Bibliothek haben, bitte:
Mitwirken
Beiträge sind willkommen! Bitte besuchen Sie das GitHub-Repository für Richtlinien zur Mitarbeit.