
Langue 🇫🇷 Français (France)
Premiers pas
Documentation
Utilisation
FastComments React Native Library
Ceci est la bibliothèque officielle React Native pour FastComments.
Widgets de commentaires FastComments pour React Native
Dépôt
Installation 
npm install react-native-webview@13.6.4 --save
npm install fastcomments-react-native --save
Remarque : En juillet 2024, il semble que react-native-webview ait un bug, il est donc préférable d'épingler la version à 13.6.4 — n'utilisez pas ^ pour récupérer la dernière version patch.
Prendre en compte le SDK natif 
Cette bibliothèque utilise une webview autour de la bibliothèque VanillaJS.
FastComments prend désormais en charge une implémentation entièrement native de notre client dans le cadre de fastcomments-react-native-sdk.
Si vous souhaitez une implémentation entièrement native, vous pouvez consulter ce dépôt.
Utilisation - Widget de commentaires en direct 
L'API est légèrement différente par rapport à fastcomments-react. Avec la version native, nous passons un objet de configuration qui suit cette structure.
import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Votre tenant id. Peut être récupéré depuis https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // L'ID ou l'URL du fil de commentaires dans votre application.
const myAppPageUrl = 'https://example.com/external-page'; // Vous pouvez éventuellement définir une URL vers une page externe
const myAppPageTitle = 'Example Title'; // ... et vous voudrez probablement un titre pour ce contenu
const [config, setConfig] = useState({
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
});
// en appelant setConfig(), nous pouvons par exemple changer la page courante, ou l'utilisateur actuellement connecté
// Voir example/src/App.tsx
return (
<FastCommentsCommentWidget config={config}/>
);
Utilisation - Widget de chat en direct 
import { FastCommentsLiveChatWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Votre tenant id. Peut être récupéré depuis https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // L'ID ou l'URL du fil de commentaires dans votre application.
const myAppPageUrl = 'https://example.com/external-page'; // vous pouvez éventuellement définir une url vers une page externe
const myAppPageTitle = 'Example Title'; // ... et vous voudrez probablement un titre pour ce contenu
const config = {
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
};
return (
<FastCommentsLiveChatWidget config={config}/>
);
Utilisation - SSO 
FastComments utilise HMAC pour le SSO sécurisé. Pour l'utiliser, faites en sorte que votre backend crée l'objet SSO (sso propriété de configuration) et le transmette
au widget de commentaires.
Vous pouvez trouver des exemples pour différents backends ici : https://github.com/FastComments/fastcomments-code-examples/tree/master/sso
Dépendances peer 
fastcomments-react-native nécessite react-native-webview. Vous devez donc suivre les étapes d'installation de react-native-webview.
Région du compte (ATTENTION : clients de l'UE)
Si votre compte est situé dans l'UE, définissez region = 'eu' dans la configuration du widget.
Sinon, vous n'avez pas besoin de définir region.
Besoin d'aide ?
Si vous rencontrez des problèmes ou avez des questions concernant la bibliothèque React Native, veuillez :
Contribuer
Les contributions sont les bienvenues ! Veuillez consulter le dépôt GitHub pour les directives de contribution.