
Язык 🇺🇦 Русский (Украина)
Начало работы
Документация
Использование
FastComments React Native Library
Это официальная библиотека 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 для ознакомления с руководством по внесению вкладов.