FastComments.com
Menu Icon

Язык 🇷🇺 Русский
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇫🇷 Français (France) 🇩🇪 Deutsch 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇷🇸 Srpski (Latinica) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

Кратко

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

Установка Drupal

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

Опросы

Добавьте опросы на ваш сайт Drupal

Добавьте живой комментарий на сайты Drupal

Быстрый старт 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

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

Скачайте модуль со страницы drupal.org/project/fcom и поместите его в каталог modules/custom/fastcomments/ вашего сайта. Затем включите его с помощью drush en fastcomments или через административный интерфейс в разделе Extend (/admin/modules).

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

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

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

All settings live under 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).

Хранение API Secret

Модуль читает API Secret из первого из этих источников, у которого есть значение:

  1. Key module — установите Key, создайте ключ Authentication и выберите его в поле API Secret key на форме настроек. Ключ может быть основан на переменной окружения или файле вне веб‑корня.
  2. settings.php — добавьте $config['fastcomments.settings']['api_secret'] = 'your-secret'; в settings.php или settings.local.php. Секрет никогда не попадает в экспортированную конфигурацию.
  3. Форма настроек — введите его в поле API Secret. Это сохраняет значение в fastcomments.settings, поэтому оно попадает в экспорт конфигурации. Отчет о статусе Drupal предупреждает, когда этот источник активен.

Форма показывает, какой источник активен. Оставив поле пустым, вы сохраняете сохранённый секрет. Установите флажок Remove the API Secret stored in configuration, чтобы удалить его после перемещения секрета в модуль Key или settings.php.

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

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

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

Режим SSO

  • None — без SSO. Пользователи комментируют как гости или создают аккаунт FastComments.
  • Simple — передаёт информацию о пользователе Drupal (имя, email, аватар) в 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 — отправлять email автору контента, когда к его материалу добавлен новый комментарий.

Для резидентности данных в ЕС см. раздел 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 по-прежнему работают в браузерах с отключенными скриптами.

Добавьте опросы на ваш сайт Drupal Internal Link

Как только FastComments установлен на вашем сайте Drupal, вы также можете проводить живые опросы прямо в комментариях. Включите Enable Polls в настройках настройки виджета, и кнопка опроса появится на панели инструментов комментариев. Опросы могут принимать от 2 до 10 вариантов, результаты обновляются в реальном времени для всех на странице, и вы выбираете, кто может создавать опросы и требуется ли вход в систему для голосования. Больше ничего устанавливать на Drupal не требуется.

Попробуйте демо живых опросов или прочитайте Документацию по опросам, чтобы настроить их.

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