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

Кратко

Быстрый старт

Установка Drupal

Установка
Настройка
Блоки виджетов
Поля типов контента
Единый вход (SSO)
Права доступа
Многоязычность
Хранение данных в ЕС
Кастомизация
Требования

Add Live Commenting to Drupal Sites

Быстрый старт Internal Link

Это краткая версия инструкций для Drupal (TL;DR).

  1. Установите модуль с помощью composer require drupal/fcom, или поместите его в modules/custom/fastcomments/.
  2. Включите его с помощью drush en fastcomments, или через интерфейс администратора по адресу /admin/modules.
  3. Перейдите в Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Введите ваш Tenant ID и API Secret из Настройки > API/SSO (EU).
  5. Добавьте поле FastComments в любой тип содержимого через Structure > Content types > [type] > Manage fields.

Модуль опубликован на drupal.org/project/fcom.

Установка Internal Link

Модуль FastComments для Drupal заменяет встроенные комментарии Drupal на быструю систему комментирования в реальном времени. Модуль опубликован на drupal.org и работает с Drupal 10 и 11.

Существует два способа установки.

Установка через Composer

composer require drupal/fcom
drush en fastcomments

Установка вручную

Download the module from drupal.org/project/fcom and place it in your site's modules/custom/fastcomments/ directory. Then enable it with drush en fastcomments, or from the admin UI at Extend (/admin/modules).

Примечание! Модуль зависит только от ядра Drupal (user и field). Другие модули Drupal или библиотеки не требуются.

После включения модуля перейдите в раздел Configuration, чтобы настроить ваш Tenant ID и API Secret.

Настройка Internal Link

Все настройки находятся в разделе Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Обязательные

  • Tenant ID - Ваш FastComments Tenant ID. Найдите его в разделе Settings > API/SSO (EU).
  • API Secret - Требуется для Secure SSO, проверки вебхуков и синхронизации страниц. Находится в разделе Settings > API/SSO (EU).

Стиль комментирования

Выберите виджет, который соответствует тому, как вы хотите, чтобы посетители общались на вашем сайте.

  • Live Comments - Древовидные комментарии в реальном времени.
  • Streaming Chat - Интерфейс живого чата, подходит для мероприятий и прямых трансляций.
  • Collab Chat - Аннотации по выделению текста в основном контенте. Посетители выделяют текст и начинают обсуждение в контексте.
  • Collab Chat + Comments - И collab chat, и стандартные комментарии на одной странице.

Режим SSO

  • None - Без SSO. Пользователи комментируют как гости или создают аккаунт FastComments.
  • Simple - Передаёт информацию пользователя Drupal (name, email, avatar) в FastComments без серверной проверки.
  • Secure - Использует HMAC-SHA256 для проверки пользователей Drupal с FastComments. Рекомендуется при настроенном API Secret.

См. раздел Single Sign-On (SSO) для подробностей.

Другие настройки

  • CDN URL - По умолчанию https://cdn.fastcomments.com.
  • Site URL - По умолчанию https://fastcomments.com.
  • Email notifications - Отправлять уведомление по электронной почте автору контента, когда на его материале появляется новый комментарий.

Для размещения данных в ЕС см. раздел EU Data Residency.

Блоки виджетов 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) автоматически определяют текущую сущность и на не-сущностных страницах используют идентификатор, основанный на пути. Это означает, что они работают на страницах таксономии, в представлениях (views) и на пользовательских маршрутах без дополнительной настройки.

Поля типов контента Internal Link

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

Каждая сущность, к которой добавлено это поле, получает:

  • переключатель состояния, позволяющий редакторам включать или отключать комментарии для каждой сущности.
  • Необязательный пользовательский идентификатор, чтобы вы могли использовать стабильный ID, не привязанный к пути сущности Drupal.

Главный блок FastComments Widget распознаёт это поле и будет пропускать сущности, к которым оно уже прикреплено. Таким образом вы можете комбинировать комментарии для отдельных сущностей с блоком, не видя виджет дважды на одной и той же странице.

Единый вход (SSO) Internal Link

FastComments интегрируется с системой пользователей Drupal через SSO (единого входа). Ваши пользователи входят на ваш сайт на Drupal, и модуль автоматически передаёт их идентификацию в FastComments. Не нужно создавать дополнительные аккаунты и запускать первоначальную синхронизацию.

The module supports three SSO modes, set under Administration > Configuration > Content > FastComments.

Нет

Нет SSO. Пользователи комментируют как гости или создают аккаунт FastComments. Используйте это, если ваш сайт публичный и вам не нужно привязывать комментарии к пользователям Drupal.

Простой

Передаёт имя пользователя Drupal, email и аватар в FastComments без серверной верификации. API Secret не нужен. Подходит для внутренних или сайтов с низким уровнем риска.

Защищённый (рекомендуется)

Использует HMAC-SHA256 для подтверждения личности каждого пользователя в FastComments. Это режим, который следует использовать, когда у вас настроен API Secret, и это единственный режим, который предотвращает выдачу посетителем себя за другого пользователя.

Идентичность пользователя передаётся в FastComments каждый раз, когда пользователь просматривает ветку комментариев. Нет необходимости запускать первоначальную или постоянную синхронизацию.

(Необязательно) Добавьте ваших администраторов в Пользователи и администраторы и модераторов в Модераторы комментариев, чтобы улучшить их опыт и включить отслеживание статистики для модераторов.

Для более детального объяснения того, как работает SSO, см. раздел SSO в документации по кастомизации.

Права доступа Internal Link

Модуль добавляет три права Drupal, которые вы можете назначать для каждой роли в разделе People > Permissions.

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

По умолчанию только пользователи с правом administer site configuration могут изменять настройки FastComments. Предоставьте View FastComments анонимным и аутентифицированным пользователям, если вы хотите, чтобы посетители видели виджет.

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

Модуль автоматически передаёт текущий язык сайта Drupal каждому виджету FastComments. Если ваш сайт на Drupal настроен для нескольких языков, интерфейс комментирования будет отображаться на соответствующем языке без дополнительных настроек.

Это относится ко всем типам виджетов: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments и Top Pages.

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

Если ваша учётная запись FastComments размещена в ЕС, обновите два параметра в Administration > Configuration > Content > FastComments:

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

Вам также следует получить ваш Tenant ID и API Secret из панели управления ЕС по адресу eu.fastcomments.com/auth/my-account/api вместо панели управления США по умолчанию. Всё остальное в модуле работает так же.

Кастомизация Internal Link

FastComments разработан так, чтобы его можно было настроить под ваш сайт.

Если вы хотите добавить пользовательские стили или изменить конфигурацию, Ознакомьтесь с нашей документацией по настройке, чтобы узнать, как.

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

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

Модуль не требует никаких других модулей Drupal или сторонних библиотек. Он зависит только от ядра Drupal (user, field).

Резервный вариант с <noscript> обеспечивает комментарии, отрендеренные на сервере, для посетителей без JavaScript, поэтому Live Comments и Streaming Chat продолжают работать в браузерах с отключённым выполнением скриптов.

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