
Язык 🇺🇦 Русский (Украина)
Начало работы
Документация
Использование
Add Comment Widgets to Your React Native App
Это официальная библиотека React Native для FastComments.
Виджеты комментариев FastComments для React Native
Репозиторий
Установка 
npm install react-native-webview@13.6.4 --save
npm install fastcomments-react-native --save
Примечание: по состоянию на июль 2024 года, похоже, в react-native-webview есть ошибка, поэтому лучше закрепить версию на 13.6.4 — не используйте ^, чтобы получать последнюю патч-версию.
Рассмотрите нативный SDK 
Эта библиотека использует webview поверх библиотеки VanillaJS.
FastComments теперь поддерживает полностью нативную реализацию нашего клиента в составе fastcomments-react-native-sdk. Если вам нужна полностью нативная реализация, вам стоит посмотреть туда.
Использование - виджет живых комментариев 
API немного отличается по сравнению с fastcomments-react. В нативной версии мы передаём объект config, который соответствует этой структуре.
import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Ваш tenant id. Можно получить с https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // ID или URL потока комментариев в вашем приложении.
const myAppPageUrl = 'https://example.com/external-page'; // вы можете опционально задать url внешней страницы
const myAppPageTitle = 'Example Title'; // ... и, вероятно, вам нужен заголовок для этого контента
const [config, setConfig] = useState({
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
});
// вызывая setConfig(), мы можем делать такие вещи, как смена текущей страницы или текущего вошедшего пользователя
// Смотрите example/src/App.tsx
return (
<FastCommentsCommentWidget config={config}/>
);
Использование - виджет живого чата 
import { FastCommentsLiveChatWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // Ваш tenant id. Его можно получить с https://fastcomments.com/auth/my-account/api-secret
const myAppPageId = 'native-test'; // ID или URL потока комментариев в вашем приложении.
const myAppPageUrl = 'https://example.com/external-page'; // можно при желании указать URL внешней страницы
const myAppPageTitle = 'Example Title'; // ... и, вероятно, вы захотите заголовок для этого контента
const config = {
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
};
return (
<FastCommentsLiveChatWidget config={config}/>
);
Использование - SSO 
FastComments использует HMAC для безопасного SSO. Чтобы использовать, пусть ваш бэкенд создаст объект SSO (sso свойство конфигурации) и передаст его виджету комментариев.
Вы можете найти примеры для различных бэкендов здесь: https://github.com/FastComments/fastcomments-code-examples/tree/master/sso
Peer-зависимости 
fastcomments-react-native требует react-native-webview. Поэтому выполните шаги установки для react-native-webview.
Регион аккаунта (ВНИМАНИЕ: клиенты из ЕС)
Если ваш аккаунт находится в ЕС, установите region = 'eu' в конфигурации виджета.
В противном случае вам не нужно определять region.
Нужна помощь?
Если вы столкнулись с какими-либо проблемами или у вас есть вопросы по библиотеке React Native, пожалуйста:
Участие
Вклады приветствуются! Пожалуйста, посетите репозиторий на GitHub для ознакомления с руководством по внесению вкладов.