
Язык 🇷🇺 Русский
Документация
Начало работы
Использование
Add Comments to Your React App
Это официальная библиотека React для FastComments.
Встраивайте виджеты живых комментариев, чата и обзоров в ваше приложение на React.
Репозиторий
Живая демонстрация 
Попробуйте каждый виджет вживую на https://fastcomments.com/commenting-system-for-react.
Демонстрация в реальном времени 
Чтобы увидеть все виджеты и потоки, работающие локально для публичного тенанта demo, клонируйте репозиторий и выполните:
cd examples/example-showcase
npm install
npm start
У каждого виджета/потока есть своё представление в каталоге examples/example-showcase/src/views/, которое вы можете прямо скопировать в своё React-приложение.
Примеры 
Отдельные варианты использования (темная тема, пагинация и т. д.) находятся в собственных папках в каталоге examples/. Каждый из них можно установить с помощью npm install и запустить с помощью npm start.
Использование 
Основной компонент виджета
Компонент FastCommentsCommentWidget содержит виджет комментариев FastComments в режиме реального времени.
Замените "demo" ниже на ваш "tenantId" — он доступен здесь в панели администратора FastComments.
Виджет поддерживает множество опций - см. FastCommentsCommentWidgetConfig в src/index.tsx.
import React, { Component } from 'react'
import {FastCommentsCommentWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentWidget tenantId="demo" />
}
}
Обновление текущей страницы (для SPA)
Чтобы обновить страницу/статью, к которой привязан поток комментариев, вы должны обновить параметры конфигурации "urlId" и "url". См. пример и объяснение здесь.
Регион аккаунта (ВНИМАНИЕ: клиенты из ЕС)
Если вы находитесь в ЕС, вам следует указать клиентским виджетам, в каком вы регионе. Смотрите examples/example-eu;
В противном случае определять region не обязательно.
Виджет количества комментариев
Компонент FastCommentsCommentCountWidget содержит виджет количества комментариев FastComments в режиме реального времени.
Замените "demo" ниже на ваш "tenantId" — он доступен здесь в панели администратора FastComments.
См. FastCommentsCommentCountConfig в src/index.tsx для поддерживаемых параметров конфигурации.
import React, { Component } from 'react'
import {FastCommentsCommentCountWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentCountWidget tenantId="demo" urlId="https://example.com/some-page-or-id" />
}
}
Нативная реализация
Для полностью нативной реализации FastComments см. fastcomments-react-native-sdk.
Для обёртки этой библиотеки для React Native, использующей webview, см. fastcomments-react-native.
Статус поддержки 
Эти компоненты являются оболочками поверх наших основных компонентов VanillaJS. Мы можем автоматически обновлять эти компоненты (исправлять ошибки, добавлять функции) без публикации этой библиотеки, так что хотя она может некоторое время не публиковаться, это не означает, что FastComments не находится в активной разработке! Не стесняйтесь заглядывать в наш блог за обновлениями. Несовместимые изменения API или новые функции никогда не будут добавлены в базовую библиотеку без повышения версии этой библиотеки.
Нужна помощь?
Если вы столкнулись с какими-либо проблемами или у вас есть вопросы о React Library, пожалуйста:
Как внести вклад
Вклады приветствуются! Пожалуйста, посетите репозиторий на GitHub для получения инструкций по внесению вклада.