
Язык 🇺🇦 Русский (Украина)
Документация
Начало работы
Использование
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" — он доступен here в административной панели 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". Смотрите пример и объяснение here.
Регион аккаунта (ВНИМАНИЕ: клиенты из ЕС)
Если вы в ЕС, рекомендуется указать клиентским виджетам ваш регион. Смотрите examples/example-eu;
В противном случае указывать region не нужно.
Виджет счётчика комментариев
Компонент FastCommentsCommentCountWidget содержит живой виджет подсчёта комментариев FastComments.
Замените "demo" ниже на ваш "tenantId" — он доступен here в административной панели 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, пожалуйста:
Участие
Вклады приветствуются! Пожалуйста, посетите репозиторий на GitHub для получения правил внесения вклада.