
Език 🇧🇬 Български
Първи стъпки
Документация
Използване
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 за указания относно приноса.