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.

  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, проверка на webhook и синхронизация на страници. Намира се в 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 предупреждава, когато това е активният източник.

Формулярът показва кой източник е активен. Оставянето на полето празно запазва съхранената тайна. Поставете отметка на Премахнете API Secret, съхранен в конфигурацията, за да я изтриете след преместване на тайната към 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.

Блокове с уиджети 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 и добавете полето.

Всяка единица (entity), която има това поле, получава:

  • Превключвател на състоянието, с който редакторите могат да включват или изключват коментарите за всяка единица поотделно.
  • Незадължителен персонализиран идентификатор, така че да можете да използвате стабилен ID, който не е обвързан с пътя на 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, които можете да присвоите 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 все още работят в браузъри с деактивиран скрипт.

Добавете анкети към вашия Drupal сайт Internal Link

След като FastComments е на вашия Drupal сайт, можете също да провеждате живи анкети директно в коментарите. Включете Enable Polls в настройките за персонализиране на вашия уиджет и бутон за анкета се появява в лентата с инструменти на коментарите. Анкетите поддържат от 2 до 10 опции, резултатите се актуализират в реално време за всички на страницата, а вие избирате кой може да създава анкети и дали гласуването изисква влизане. Няма нищо друго, което да се инсталира в Drupal.

Опитайте демонстрацията на живи анкети или прочетете документацията за анкети, за да ги настроите.

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