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 (ЄС).
  5. Додайте поле FastComments до будь-якого типу вмісту через Structure > Content types > [type] > Manage fields.

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

Встановлення Internal Link

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

Існує два способи його встановлення.

Install with Composer

composer require drupal/fcom
drush en fastcomments

Install manually

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

Примітка! Модуль залежить лише від ядра Drupal (user і field). Інші модулі або бібліотеки Drupal не потрібні.

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

Налаштування Internal Link

Усі налаштування знаходяться в Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Required

Commenting Style

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

  • Live Comments - Потокові коментарі в режимі реального часу з відповідями (threaded).
  • Streaming Chat - Інтерфейс живого чату, підходить для подій та трансляцій.
  • Collab Chat - Анотації на вибраному тексті в основній області контенту. Відвідувачі виділяють текст і починають обговорення в контексті.
  • Collab Chat + Comments - Одночасно collab chat і стандартні коментарі на одній сторінці.

SSO Mode

  • None - Без SSO. Користувачі коментують як гості або створюють обліковий запис FastComments.
  • Simple - Передає інформацію користувача Drupal (ім'я, електронна пошта, аватар) до FastComments без перевірки на стороні сервера.
  • Secure - Використовує HMAC-SHA256 для перевірки користувачів Drupal у FastComments. Рекомендується, якщо у вас налаштовано API Secret.

Дивіться розділ Single Sign-On (SSO) для деталей.

Other Settings

  • 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 field, тому на одній сторінці не з'являться дублікати віджетів.
  • 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 і додайте це поле.

Кожна сутність, яка має це поле, отримує:

  • A перемикач статусу щоб редактори могли увімкнути або вимкнути коментування для кожної сутності.
  • A необов'язковий користувацький ідентифікатор щоб ви могли використовувати стабільний ідентифікатор, який не прив'язаний до шляху сутності Drupal.

Головний блок FastComments Widget знає про це поле і пропускатиме сутності, до яких воно вже прикріплене. Так ви можете поєднувати коментарі на рівні окремих сутностей і блок, не побачивши віджет двічі на одній сторінці.

Єдиний вхід (SSO) Internal Link

FastComments інтегрується з системою користувачів Drupal через SSO, або єдиний вхід. Ваші користувачі входять на ваш сайт Drupal, а модуль автоматично передає їхню ідентичність у FastComments. Немає додаткових облікових записів для створення, немає початкової синхронізації для запуску.

Модуль підтримує три режими SSO, які налаштовуються в Administration > Configuration > Content > FastComments.

Немає

Без SSO. Користувачі коментують як гості або створюють обліковий запис FastComments. Використовуйте це, якщо ваш сайт публічний і вам не потрібно пов'язувати коментарі з користувачами Drupal.

Простий

Передає ім'я, електронну пошту та аватар користувача Drupal у 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 налаштований для кількох мов, інтерфейс коментування відобразиться відповідною мовою без додаткової конфігурації.

Це стосується всіх типів віджетів: Живі коментарі, Потоковий чат, Спільний чат, Чат із зображеннями, Останні коментарі та Найпопулярніші сторінки.

Зберігання даних у ЄС 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).

A <noscript> fallback provides server-rendered comments for visitors without JavaScript, so Live Comments and Streaming Chat still work on browsers with scripting disabled.

Зробити внесок у цей посібник