FastComments.com
Menu Icon

Језик 🇷🇸 Српски
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇺🇸 English (US) 🇨🇦 Français (Canada) 🇫🇷 Français (France) 🇩🇪 Deutsch 🇨🇾 Ελληνικά (Κύπρος) 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇺🇦 Русский (Украина) 🇧🇦 Српски (БиХ) 🇷🇸 Srpski (Latinica) 🇲🇪 Српски (Црна Гора) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

Документација

Демонстрација уживо
Размотрите нативни SDK
Peer зависности
Статус одржавања

Почетак

Инсталација

Употреба

Употреба - Видгет за коментаре уживо
Употреба - Видгет за ћаскање уживо
Употреба - SSO

Add Comment Widgets to Your React Native App

Ово је званична React Native библиотека за FastComments.

Уградите видгете за коментарисање уживо, ћаскање и рецензије у вашу React Native апликацију.

Репозиторијум

Погледајте на GitHub

Демонстрација уживо Internal Link

Да бисте видели сваки видгет и ток који се покреће локално против јавног demo tenant-а, клонирајте репозиторијум и покрените:

yarn bootstrap
cd example
yarn ios       # or: yarn android, yarn web

Улазна тачка демонстрације је example/src/ShowcaseApp.tsx — једна апликација која приказује све видгете, теме и токове.

Циљна платформа yarn web користи react-native-web + react-native-web-webview (који приказује WebView као iframe). Корисно за брзе визуелне smoke тестове у прегледачу; нативни WebView API-ји попут injectJavaScript и onShouldStartLoadWithRequest неће се у потпуности понашати на вебу.

Инсталација Internal Link

npm

npm install react-native-webview --save
npm install fastcomments-react-native --save

Размотрите нативни SDK Internal Link

Ова библиотека користи webview око VanillaJS библиотеке.

FastComments сада подржава потпуно нативну имплементацију нашег клијента као део fastcomments-react-native-sdk. Ако желите потпуно нативну имплементацију, можда бисте желели да тамо погледате.

Употреба - Видгет за коментаре уживо Internal Link

API се мало разликује у односу на fastcomments-react. У native окружењу прослеђујемо 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}/>
  );

Употреба - Видгет за ћаскање уживо Internal Link

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 Internal Link

FastComments користи HMAC за безбедни SSO. Да бисте користили, нека ваш бекенд креира SSO објекат (sso конфигурационо својство) и проследи га видгету за коментаре.

Примере за различите бекенде можете наћи овде: https://github.com/FastComments/fastcomments-code-examples/tree/master/sso

Peer зависности Internal Link

fastcomments-react-native захтева react-native-webview. Стога треба да пратите кораке за инсталацију за react-native-webview.

Регион налога (ПАЖЊА: корисници из ЕУ)

Ако је ваш налог лоциран у ЕУ, подесите region = 'eu' у конфигурацији видгета.

У супротном, не морате дефинисати region.

Статус одржавања Internal Link

Ови компоненти су омотачи око наших основних VanillaJS компонента. Можемо аутоматски ажурирати ове компоненте (поправљати грешке, додавати функције) без објављивања ове библиотеке, тако да чињеница да можда неће бити објављена неко време не значи да FastComments није у активној развоју! Слободно погледајте наш блог за ажурирања. Некомпатибилне промене API-ја или нове функције никада неће бити прослеђене основној библиотеци без повећања верзије ове библиотеке.

Потребна помоћ?

Ако наиђете на било какве проблеме или имате питања у вези React Native библиотеке, молимо вас:

Како допринети

Допринеси су добродошли! Молимо посетите GitHub репозиторијум за смернице о доприносу.

Допринесите овом водичу