Add Comments to Your Drupal Site
Ово је званични Drupal модул за FastComments.
Drupal модул који интегрише FastComments са Drupal 10/11, пружајући видџет блокове, интеграцију поља ентитета, SSO и грануларне дозволе.
Репозиторијум
Инсталација 
- Поставите овај модул у директоријум вашег Drupal сајта
modules/custom/fastcomments/(или инсталирајте преко Composer-а:composer require drupal/fcom). - Омогућите модул:
Или га омогућите преко административног интерфејса на Extend (drush en fastcomments/admin/modules).
Конфигурација
Идите на Администрација > Конфигурација > Садржај > FastComments (/admin/config/content/fastcomments).
Подешавања
- Tenant ID (обавезно) - Ваш FastComments Tenant ID. Пронађите га у Подешавања > API/SSO (EU).
- API Secret - Потребан за Secure SSO, верификацију webhook-а и синхронизацију страница. Налази се у Подешавања > API/SSO (EU).
- SSO Mode - Интеграција Single Sign-On:
- None - Нема SSO; корисници коментаришу као гости или креирају FastComments налоге.
- Simple - Prosleđuje информације о Drupal кориснику (име, имејл, аватар) FastComments-у без верификације на страни сервера.
- Secure - Користи HMAC-SHA256 верификацију за сигурну аутентификацију Drupal корисника са FastComments-ом (препоручено).
- Commenting Style - Тип видгета који ће се приказати:
- Live Comments - Коментари у реалном времену са нитном структуром.
- Streaming Chat - Интерфејс за ћаскање у реалном времену.
- Collab Chat - Колаборативне анотације избора текста у главном делу садржаја.
- Collab Chat + Comments - И колаб разговор и стандардни коментари.
- CDN URL - FastComments CDN URL (подразумевано:
https://cdn.fastcomments.com). - Site URL - FastComments URL сајта (подразумевано:
https://fastcomments.com). - Email notifications - Пошаљите е-поруку ауторима садржаја када је на њиховом садржају објављен нови коментар.
Додавање коментара у типове садржаја
Додајте поље FastComments у своје типове садржаја преко Структура > Типови садржаја > [type] > Управљање пољима. Поље има прекидач статуса и опционални прилагођени идентификатор по ентитету.
Резиденција података у ЕУ
За резиденцију података у ЕУ, ажурирајте:
- CDN URL на
https://cdn-eu.fastcomments.com - Site URL на
https://eu.fastcomments.com
Видгет блокови
Неколико блокова је доступно путем Структура > Распоред блокова (/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) аутоматски детектују тренутни ентитет и, на страницама које нису ентитети, се ослањају на идентификатор заснован на путањи.
Вишејезично
Модул аутоматски прослеђује тренутни језик Drupal сајта свим видгетима.
Дозволе
- Administer FastComments - Приступ формулару за подешавања FastComments.
- View FastComments - Потребно да бисте видели виџет за коментаре.
- Toggle FastComments - Омогућава корисницима да по ентитету укључе/искључе коментаре преко виџета поља.
Како функционише
Када корисник посети ентитет са омогућеним FastComments пољем:
- FastComments JavaScript виџет се учитава са CDN-а.
- Ако је SSO конфигурисан, Drupal идентитет корисника се прослеђује FastComments-у.
- Резервни
<noscript>механизам обезбеђује коментаре рендероване на серверу за кориснике без JavaScript-а (само у режимима Live Comments и Streaming Chat).
Захтеви
Потребна помоћ?
Ако наиђете на било какве проблеме или имате питања у вези са Drupal модулом, молимо вас:
Допринеси
Допринеси су добродошли! Молимо вас посетите репозиторијум на GitHub-у за смернице о доприносу.