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.

  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).

Задължително

Стил на коментиране

Изберете уиджета, който отговаря на начина, по който искате хората да общуват на вашия сайт.

  • Live Comments - Коментари с нишки в реално време.
  • Streaming Chat - Интерактивен чат на живо, подходящ за събития и излъчвания на живо.
  • Collab Chat - Анотации чрез маркиране на текст в основното съдържание. Посетителите маркират текст и стартират дискусия в контекста.
  • Collab Chat + Comments - Както collab chat, така и стандартни коментари на една и съща страница.

Режим SSO

  • None - Без SSO. Потребителите коментират като гости или създават акаунт във FastComments.
  • Simple - Предава информация за потребителя в Drupal (име, имейл, аватар) към FastComments без верификация от страна на сървъра.
  • Secure - Използва HMAC-SHA256 за верификация на потребителите от Drupal с FastComments. Препоръчва се, когато имате конфигуриран API Secret.

See the Single Sign-On (SSO) section for details.

Други настройки

  • CDN URL - По подразбиране: https://cdn.fastcomments.com.
  • Site URL - По подразбиране: https://fastcomments.com.
  • Email notifications - Изпраща имейл до автора на съдържанието, когато е публикуван нов коментар по тяхното съдържание.

For EU data residency, see the EU Data Residency section.

Уиджет блокове Internal Link

Модулът включва няколко блока, които можете да разположите от Structure > Block layout (/admin/structure/block).

  • FastComments Widget - Основният commenting widget. Автоматично разпознава текущия entity. Ще пропусне entity-та, към които вече е прикрепено полето FastComments, така че няма да виждате дублирани widget-и на една и съща страница.
  • FastComments Live Chat - Чат в реално време със стрийминг. Може да се постави заедно с полето за коментари на същата страница.
  • FastComments Collab Chat - Анотации и дискусии чрез маркиране на текст.
  • FastComments Image Chat - Анотации върху изображения, базирани на координати. Посетителите кликват върху изображение, за да оставят коментари, свързани с конкретни места.
  • FastComments Recent Comments - Показва последните коментари в целия сайт. Броят е конфигурируем в настройките на блока.
  • FastComments Top Pages - Показва страниците на сайта ви с най-много коментари.

Съдържателно-ориентираните блокове (Live Chat, Collab Chat, Image Chat) автоматично разпознават текущия entity и при страници без entity използват идентификатор, базиран на път (path-based identifier). Това означава, че те работят на таксономични страници, изгледи (views) и персонализирани маршрути без допълнителна конфигурация.

Полета на типа съдържание Internal Link

За повечето сайтове най-лесният начин да добавите коментари е да прикрепите полето FastComments към вашите типове съдържание. Отидете в Structure > Content types > [type] > Manage fields и добавете полето.

Всеки ентитет, който има полето, получава:

  • A превключвател за статус така че редакторите да могат да включват или изключват коментирането за всеки ентитет.
  • An optional персонализиран идентификатор, така че да можете да използвате стабилен ID, който не е обвързан с пътя на Drupal ентитета.

The main FastComments Widget block knows about this field, and will skip entities that already have it attached. That way you can mix per-entity comments with the block without seeing the widget twice on the same page.

Единно влизане (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, които можете да присвоите per role под People > Permissions.

  • Administer FastComments - Достъп до формата за настройки на FastComments на /admin/config/content/fastcomments.
  • View FastComments - Необходимо за виждане на коментарния уиджет. Без това разрешение уиджетът не се рендерира.
  • Toggle 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:

  • URL на CDN - https://cdn-eu.fastcomments.com
  • 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 все още работят в браузъри с деактивиран скрипт.

Допринеси към това ръководство