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 з Налаштування > API/SSO (ЄС).
  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. The settings form – Введіть його у поле API Secret. Це зберігає значення в fastcomments.settings, тому воно потрапляє у експорт конфігурації. Звіт стану Drupal попереджає, коли це активне джерело.

Форма показує, яке джерело активне. Якщо залишити поле порожнім, збережений секрет залишиться. Позначте Remove the API Secret stored in configuration, щоб видалити його після переміщення секрету до модуля Key або settings.php.

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

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

  • Live Comments – Коментарі в реальному часі з деревовидною структурою.
  • Streaming Chat – Інтерфейс живого чату, підходить для подій та прямих трансляцій.
  • Collab Chat – Анотація виділеного тексту в основній області контенту. Відвідувачі виділяють текст і починають обговорення в контексті.
  • Collab Chat + Comments – І чат‑колаборація, і стандартні коментарі на одній сторінці.

Режим SSO

  • None – Без SSO. Користувачі коментують як гості або створюють обліковий запис FastComments.
  • Simple – Передає інформацію про користувача Drupal (ім'я, електронна пошта, аватар) у 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 section.

Блоки віджетів 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).

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

Додайте опитування до вашого сайту Drupal Internal Link

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

Спробуйте демо живих опитувань або прочитайте Документацію по опитуванням, щоб налаштувати їх.

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