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).
Конфигурација
Идите на Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
Подешавања
- Tenant ID (обавезно) - Ваш FastComments Tenant ID. Пронађите ово у Подешавања > API/SSO (ЕУ).
- API Secret - Потребно за Secure SSO, верификацију webhook-а и синхронизацију страница. Налази се у Подешавања > API/SSO (ЕУ).
- SSO Mode - Интеграција Single Sign-On:
- None - Без SSO-а, корисници коментаришу као гости или креирају FastComments налоге.
- Simple - Прослеђује Drupal информације о кориснику (име, имејл, аватар) ка FastComments без серверске верификације.
- Secure - Користи HMAC-SHA256 верификацију за сигурну аутентикацију Drupal корисника са FastComments (препоручено).
- Commenting Style - Тип виџета који ће бити приказан:
- Live Comments - Реално-временски нитовани коментари.
- Streaming Chat - Интерфејс за уживо чет.
- Collab Chat - Сарадничко означавање текста на главном садржају.
- Collab Chat + Comments - И collab chat и стандардни коментари.
- CDN URL - FastComments CDN URL (подразумевано:
https://cdn.fastcomments.com). - Site URL - FastComments Site URL (подразумевано:
https://fastcomments.com). - Email notifications - Пошаљи имејл ауторима садржаја када је нови коментар објављен на њиховом садржају.
Додавање коментара у типове садржаја
Додајте поље FastComments у ваше типове садржаја преко Structure > Content types > [type] > Manage fields. Поље има прекидач статуса и опциони прилагођени идентификатор по ентитету.
Резиденција података за ЕУ
За резиденцију података у ЕУ, ажурирајте:
- CDN URL на
https://cdn-eu.fastcomments.com - Site URL на
https://eu.fastcomments.com
Видџет блокови
Неколико блокова је доступно преко Структура > Распоред блокова (/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) аутоматски детектују тренутни ентитет и на страницама које нису ентитет користе идентификатор заснован на путањи.
Вишејезичност
Модул аутоматски прослеђује тренутни језик Drupal сајта свим виџетима.
Дозволе
- Administer FastComments - Pristup obrascu za podešavanja FastComments.
- View FastComments - Potrebno za prikaz vidžeta za komentare.
- Toggle FastComments - Omogućava korisnicima da uključe/isključe komentare po entitetu putem vidžeta polja.
Како функционише
Када корисник посети ентитет са омогућеним FastComments пољем:
- FastComments JavaScript видџет се учитава са CDN-а.
- Ако је SSO конфигурисан, Drupal идентитет корисника се прослеђује FastComments-у.
- Надокнада
<noscript>обезбеђује серверски рендероване коментаре за кориснике без JavaScript-а (само у режимима Live Comments и Streaming Chat).
Захтјеви
Потребна помоћ?
Ако наиђете на било какве проблеме или имате питања у вези Drupal модула, молимо вас:
Допринос
Допринеси су добродошли! Молимо посетите GitHub репозиторијум за упутства за допринос.