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. Найдите это в разделе Settings > API/SSO (EU).
  • API Secret - Требуется для Secure SSO, webhook verification и синхронизации страниц. Находится в разделе Settings > API/SSO (EU).
  • SSO Mode - Интеграция Single Sign-On:
    • None - Без SSO: пользователи комментируют как гости или создают аккаунты FastComments.
    • Simple - Передаёт информацию пользователя Drupal (name, email, avatar) в FastComments без проверки на стороне сервера.
    • Secure - Использует HMAC-SHA256 для проверки и безопасной аутентификации пользователей Drupal в FastComments (рекомендуется).
  • Commenting Style - Тип виджета для отображения:
    • Live Comments - Потоковые ветвящиеся комментарии в реальном времени.
    • Streaming Chat - Интерфейс живого чата.
    • Collab Chat - Совместная аннотация выделенного текста в основной области контента.
    • Collab Chat + Comments - И collab chat, и стандартные комментарии.
  • CDN URL - FastComments CDN URL (по умолчанию: https://cdn.fastcomments.com).
  • Site URL - FastComments site URL (по умолчанию: 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

Несколько блоков доступны через Structure > Block layout (/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

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

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

Когда пользователь посещает сущность с включённым полем FastComments:

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

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

  • Drupal 10 или 11
  • PHP 8.1+
  • Учетная запись FastComments

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

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

Участие

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

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