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

Начало работы

Установка

Конфигурация

Конфигурация

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

Блоки виджетов
Многоязычность
Разрешения
Как это работает
Требования

Add Comments to Your Drupal Site

Это официальный модуль Drupal для FastComments.

Модуль Drupal, который интегрирует FastComments с Drupal 10/11, предоставляя блоки виджетов, интеграцию полей сущностей, SSO и тонкую систему прав доступа.

Репозиторий

Посмотреть на GitHub

Установка Internal Link

  1. Поместите этот модуль в директорию вашего сайта Drupal modules/custom/fastcomments/ (или установите через Composer: composer require drupal/fcom).
  2. Включите модуль:
    drush en fastcomments
    Или включите через административный интерфейс в Extend (/admin/modules).

Конфигурация Internal Link

Перейдите в Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Настройки

  • Tenant ID (обязательно) - Ваш FastComments Tenant ID. Найдите это в Настройки > API/SSO (ЕС).
  • API Secret - Требуется для Secure SSO, проверки вебхуков и синхронизации страниц. Находится в Настройки > API/SSO (ЕС).
  • SSO Mode - Интеграция Single Sign-On:
    • None - Без SSO, пользователи комментируют как гости или создают аккаунты FastComments.
    • Simple - Передаёт информацию о пользователе Drupal (имя, email, аватар) в FastComments без проверки на стороне сервера.
    • Secure - Использует HMAC-SHA256 для безопасной аутентификации пользователей Drupal в FastComments (рекомендуется).
  • Commenting Style - Тип виджета для отображения:
    • Live Comments - Комментарии в реальном времени с ветвлением.
    • Streaming Chat - Потоковый чат.
    • Collab Chat - Совместная аннотация текста (выделение) в основной области контента.
    • Collab Chat + Comments - И совместный чат, и стандартные комментарии.
  • CDN URL - URL CDN FastComments (по умолчанию: https://cdn.fastcomments.com).
  • Site URL - URL сайта FastComments (по умолчанию: https://fastcomments.com).
  • Email notifications - Отправлять письмо авторам контента при появлении нового комментария на их контенте.

Добавление комментариев к типам содержимого

Добавьте поле FastComments к вашим типам содержимого через Structure > Content types > [type] > Manage fields. Поле имеет переключатель статуса и необязательный пользовательский идентификатор для каждой сущности.

Хранение данных в ЕС

Для хранения данных в ЕС обновите:

  • CDN URL на https://cdn-eu.fastcomments.com
  • Site URL на https://eu.fastcomments.com

Блоки виджетов Internal Link

Несколько блоков доступны через Структура > Расположение блоков (/admin/structure/block):

  • FastComments Widget - Основной виджет комментариев. Автоматически определяет текущую сущность. Пропускает сущности, которые уже имеют поле FastComments (чтобы избежать дубликатов).
  • FastComments Live Chat - Чат в реальном времени с потоковой передачей. Может быть размещён рядом с полем комментариев на той же странице.
  • FastComments Collab Chat - Аннотации и обсуждения по выделению текста.
  • FastComments Image Chat - Аннотации на изображениях на основе координат.
  • FastComments Recent Comments - Отображает недавние комментарии по всему сайту. Число комментариев настраивается.
  • FastComments Top Pages - Показывает страницы с наибольшим количеством комментариев.

Контент-ориентированные блоки (Live Chat, Collab Chat, Image Chat) автоматически определяют текущую сущность и при отсутствии сущности на странице используют идентификатор, основанный на пути.

Многоязычность Internal Link

Модуль автоматически передаёт текущий язык сайта Drupal всем виджетам.

Разрешения Internal Link

  • Администрирование FastComments - Доступ к форме настроек FastComments.
  • Просмотр FastComments - Требуется для просмотра виджета комментариев.
  • Переключение FastComments - Позволяет пользователям включать/отключать комментарии для каждой сущности через виджет поля.

Как это работает Internal Link

Когда пользователь посещает сущность, для которой включено поле FastComments:

  1. JavaScript-виджет FastComments загружается с CDN.
  2. Если настроен SSO, идентификация пользователя Drupal передаётся в FastComments.
  3. Резервный вариант <noscript> предоставляет комментарии, сформированные на сервере, для пользователей без JavaScript (только в режимах Live Comments и Streaming Chat).

Требования Internal Link

Нужна помощь?

Если вы столкнулись с проблемами или у вас есть вопросы по модулю Drupal, пожалуйста:

Вклад

Вклады приветствуются! Пожалуйста, посетите репозиторий на GitHub для получения руководства по внесению вкладов.

Внести вклад в это руководство