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 из Settings > 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, проверки webhook и синхронизации страниц. Находится в 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, или single-sign-on. Ваши пользователи входят на ваш сайт Drupal, и модуль автоматически передаёт их идентификационные данные в FastComments. Не нужно создавать дополнительные аккаунты, не нужно запускать начальную синхронизацию.

Модуль поддерживает три режима SSO, задаваемые в 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.

  • Администрирование FastComments - Доступ к форме настроек FastComments по адресу /admin/config/content/fastcomments.
  • Просмотр FastComments - Требуется, чтобы видеть виджет комментариев. Без этого разрешения виджет не отображается.
  • Переключение 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 по-прежнему работают в браузерах с отключенными скриптами.

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