
Langue 🇨🇦 Français (Canada)
Premiers pas
Documentation
Utilisation
FastComments React Native Library
Il s'agit de 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 présente un bogue, il est donc préférable d'épingler la version à 13.6.4 - n'utilisez pas ^ pour obtenir la dernière version de correctif.
Envisager le SDK natif 
Cette bibliothèque utilise une webview autour de la bibliothèque VanillaJS.
FastComments prend maintenant 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 voudrez peut-être consulter ce dépôt.
Utilisation - le widget de commentaires en direct 
L'API est légèrement différente comparée à 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(), on peut, par exemple, changer la page courante ou l'utilisateur actuellement connecté
// Voir example/src/App.tsx
return (
<FastCommentsCommentWidget config={config}/>
);
Utilisation - le widget de clavardage en direct 
import { FastCommentsLiveChatWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Votre identifiant de locataire. 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 (authentification unique) 
FastComments utilise HMAC pour le SSO sécurisé. Pour l'utiliser, faites en sorte que votre backend crée l'objet SSO (propriété de configuration sso) 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 requiert react-native-webview. Par conséquent, vous devez suivre les étapes d'installation pour 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 à 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.