Add Comments to Your Drupal Site
Ово је званични Drupal модул за FastComments.
Drupal модул који интегрише FastComments са Drupal 10/11, пружајући видџет блокове, интеграцију поља ентитета, SSO и грануларне дозволе.
Репозиторијум
Инсталација 
- Ставите овај модул у директоријум вашег Drupal сајта
modules/custom/fastcomments/(или инсталирајте преко Composer-а:composer require drupal/fcom). - Омогућите модул:
Или омогућите преко административног интерфејса на страници Проширење (drush en fastcomments/admin/modules).
Конфигурација
Navигирајте до Администрација > Конфигурација > Садржај > 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 - И колаб чат и стандардни коментари.
- CDN URL - FastComments CDN URL (подразумевано:
https://cdn.fastcomments.com). - Site URL - FastComments site URL (подразумевано:
https://fastcomments.com). - Email notifications - Слање е-поште ауторима садржаја када се на њиховом садржају појави нови коментар.
Додавање коментара у типове садржаја
Додајте поље FastComments у своје типове садржаја преко Структура > Типови садржаја > [type] > Управљање пољима. Поље има прекидач статуса и опциони прилагођени идентификатор по ентитету.
Резиденција података у ЕУ
За резиденцију података у ЕУ, ажурирајте:
- CDN URL на
https://cdn-eu.fastcomments.com - Site URL на
https://eu.fastcomments.com
Видџет блокови
Nekoliko blokova je dostupno putem Structure > Block layout (/admin/structure/block):
- FastComments Widget - Glavni widget za komentare. Automatski otkriva trenutni entitet. Preskače entitete koji već imaju FastComments polje (da bi se spriječilo dupliciranje).
- FastComments Live Chat - Chat u realnom vremenu. Može se postaviti pored polja za komentare na istoj stranici.
- FastComments Collab Chat - Označavanje teksta i diskusija.
- FastComments Image Chat - Anotacija zasnovana na koordinatama na slikama.
- FastComments Recent Comments - Prikazuje najnovije komentare na vašem sajtu. Broj komentara se može konfigurirati.
- FastComments Top Pages - Prikazuje stranice s najviše komentara.
Blokovi usmjereni na sadržaj (Live Chat, Collab Chat, Image Chat) automatski otkrivaju trenutni entitet i na stranicama koje nisu entitet koriste identifikator zasnovan na putanji.
Вишејезично
Модул аутоматски прослеђује тренутни језик Drupal сајта свим видџетима.
Дозволе
- Upravljanje FastComments - Pristup obrascu za podešavanja FastComments.
- Pregled FastComments - Potrebno za prikaz widgeta za komentare.
- Uključivanje/isključivanje FastComments - Omogućava korisnicima da po entitetu uključe ili isključe komentare putem polja widgeta.
Како функционише
Када корисник посјети ентитет са омогућеним FastComments пољем:
- FastComments JavaScript виџет се учитава са CDN-а.
- Ако је SSO конфигурисан, Drupal идентитет корисника се преноси на FastComments.
- Резервна опција
<noscript>обезбјеђује коментаре рендероване на серверу за кориснике без JavaScript-а (само у режимима Live Comments и Streaming Chat).
Захтеви
Требате помоћ?
Ако наиђете на било какве проблеме или имате питања у вези са Drupal модулом, молимо вас:
Допринеси
Допринеси су добродошли! Посјетите GitHub репозиториј за смјернице о доприносима.