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

Початок роботи

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

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

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

Документація

Блоки віджетів
Багатомовність
Дозволи
Як це працює
Вимоги

Add Comments to Your Drupal Site

Це офіційний модуль Drupal для FastComments.

Модуль Drupal, який інтегрує FastComments у Drupal 10/11, надаючи блоки віджетів, інтеграцію полів сутностей, SSO та детальні дозволи.

Репозиторій

Переглянути на GitHub

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

  1. Розмістіть цей модуль у каталозі вашого сайту Drupal modules/custom/fastcomments/ (або встановіть його через Composer: composer require drupal/fcom).
  2. Увімкніть модуль:
    drush en fastcomments
    Або увімкніть через адміністративний інтерфейс у розділі Розширення (/admin/modules).

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

Навігація до Адміністрування > Конфігурація > Вміст > FastComments (/admin/config/content/fastcomments).

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

  • Tenant ID (обов'язково) - Ваш Tenant ID FastComments. Знайдіть це в розділі Налаштування > API/SSO (ЄС).
  • API Secret - Необхідно для Secure SSO, перевірки webhook та синхронізації сторінок. Знаходиться в розділі Налаштування > API/SSO (ЄС).
  • SSO Mode - Інтеграція Single Sign-On:
    • None - Без SSO, користувачі коментують як гості або створюють облікові записи FastComments.
    • Simple - Передає інформацію користувача Drupal (ім'я, email, аватар) до FastComments без серверної перевірки.
    • Secure - Використовує перевірку HMAC-SHA256 для безпечної автентифікації користувачів Drupal у FastComments (рекомендується).
  • Commenting Style - Тип віджета для відображення:
    • Live Comments - Коментарі в реальному часі, впорядковані у нитки.
    • Streaming Chat - Інтерфейс живого чату.
    • Collab Chat - Спільна анотація вибраного тексту на головній області вмісту.
    • Collab Chat + Comments - І collab chat, і стандартні коментарі.
  • CDN URL - URL CDN FastComments (за замовчуванням: https://cdn.fastcomments.com).
  • Site URL - URL сайту FastComments (за замовчуванням: https://fastcomments.com).
  • Email notifications - Надсилати електронний лист авторам вмісту, коли на їхній вміст додається новий коментар.

Додавання коментарів до типів вмісту

Додайте поле FastComments до ваших типів вмісту через Структура > Типи вмісту > [type] > Керувати полями. Поле має перемикач статусу та необов'язковий власний ідентифікатор для кожного об'єкта.

Розміщення даних у ЄС

Для розміщення даних у ЄС оновіть:

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

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

Багатомовність Internal Link

Модуль автоматично передає поточну мову сайту Drupal усім віджетам.

Дозволи Internal Link

  • Адмініструвати FastComments - Доступ до форми налаштувань FastComments.
  • Перегляд FastComments - Необхідно для перегляду віджета коментарів.
  • Увімкнення/вимкнення FastComments - Дозволяє користувачам вмикати/вимикати коментарі для кожної сутності через віджет поля.

Як це працює Internal Link

Коли користувач відвідує сутність з увімкненим полем FastComments:

  1. JavaScript-виджет FastComments завантажується з CDN.
  2. Якщо налаштовано SSO, ідентичність користувача Drupal передається в FastComments.
  3. Резервний механізм <noscript> забезпечує серверно-згенеровані коментарі для користувачів без JavaScript (лише в режимах Live Comments та Streaming Chat).

Вимоги Internal Link

  • Drupal 10 або 11
  • PHP 8.1+
  • Обліковий запис FastComments

Потрібна допомога?

Якщо у вас виникли проблеми або є питання щодо модуля Drupal, будь ласка:

Участь у розробці

Внески вітаються! Будь ласка, відвідайте репозиторій GitHub для інструкцій щодо внесків.

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