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
Зависности вршњака
Статус одржавања

Почетак рада

Инсталација

Употреба

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

Add Comment Widgets to Your React Native App

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

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

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

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

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

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

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). Корисно за брзе визуелне провјере у прегледачу; 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 верзији прослеђујемо конфигурациони објекат који прати ову структуру.

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'; // Ваш идентификатор тенанта. Може се преузети са https://fastcomments.com/auth/my-account/api-secret
  const myAppPageId = 'native-test'; // ИД или 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 config property) и прослиједите га коментарском видџету.

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

Зависности вршњака Internal Link

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

Регион налога (ПАЖЊА: КУПЦИ ИЗ ЕУ)

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

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

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

Требате помоћ?

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

Допринеси

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

Доприни овом водичу