
Језик 🇧🇦 Српски (БиХ)
Укратко
Инсталација Drupala
Add Live Commenting to Drupal Sites
Брзи почетак 
Ovo je TL;DR (skraćena) verzija uputstava za Drupal.
- Instalirajte modul sa
composer require drupal/fcom, ili ga stavite umodules/custom/fastcomments/. - Omogućite ga sa
drush en fastcomments, ili iz administratorskog UI na/admin/modules. - Idite na
Administration > Configuration > Content > FastComments(/admin/config/content/fastcomments). - Unesite vaš Tenant ID i API Secret iz Postavke > API/SSO (EU).
- Dodajte polje
FastCommentsu bilo koji tip sadržaja putemStructure > Content types > [type] > Manage fields.
Modul je objavljen na drupal.org/project/fcom.
Инсталација 
The FastComments Drupal modul zamjenjuje ugrađene Drupal komentare brzim sistemom komentiranja u realnom vremenu. Modul je objavljen na drupal.org i radi sa Drupal 10 i 11.
Postoje dva načina za instalaciju.
Instalacija pomoću Composer-a
composer require drupal/fcom
drush en fastcommentsRučna instalacija
Preuzmite modul sa drupal.org/project/fcom i postavite ga u direktorij vaše stranice modules/custom/fastcomments/. Zatim ga omogućite pomoću drush en fastcomments, ili iz administratorskog sučelja na Extend (/admin/modules).
Napomena! Modul zavisi samo od Drupal core-a (user i field). Nisu potrebni drugi Drupal moduli ili biblioteke.
Kada je modul omogućen, idite u sekciju Configuration da podesite vaš Tenant ID i API Secret.
Конфигурација 
Sva podešavanja se nalaze u Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
Обавезно
- Tenant ID - Ваш FastComments Tenant ID. Проналаже се под Подешавања > API/SSO (EU).
- API Secret - Потребно за Secure SSO, верификацију webhook-а и синхронизацију страница. Налази се под Подешавања > API/SSO (EU).
Стил коментарисања
Изаберите видџет који одговара начину на који желите да људи комуницирају на вашем сајту.
- Live Comments - Коментари у реалном времену са уткнутим нитима.
- Streaming Chat - Интерфејс за ћаскање уживо, погодан за догађаје и преносе уживо.
- Collab Chat - Анотације одабиром текста у главном садржају. Посетиоци означе текст и покрену дискусију у контексту.
- Collab Chat + Comments - И Collab Chat и стандардни коментари на истој страници.
SSO режим
- None - Нема SSO. Корисници коментаришу као гости или направе FastComments налог.
- Simple - Прослеђује Drupal информације о кориснику (name, email, avatar) FastComments без верификације на serverskoj strani.
- Secure - Користи HMAC-SHA256 да верификује Drupal кориснике са FastComments. Препоручено када имате конфигурисани API Secret.
Погледајте оделjak Single Sign-On (SSO) за детаље.
Остала подешавања
- CDN URL - Подразумевано је
https://cdn.fastcomments.com. - Site URL - Подразумевано је
https://fastcomments.com. - Email notifications - Шаље е-поруку аутору садржаја када је објављен нови коментар на њиховом садржају.
За пребивалиште података у ЕУ, погледајте одeljak EU Data Residency.
Блокови виџета 
Модул долази са неколико блокова које можете поставити преко Structure > Block layout (/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) аутоматски детектују тренутни ентитет, а на страницама које нису ентитети користе идентификатор заснован на путањи. То значи да раде на страницама таксономије, views, и прилагођеним рутама без додатног подешавања.
Поља типа садржаја 
Za većinu sajtova, najlakši način za dodavanje komentara je da prikačite polje FastComments na vaše tipove sadržaja. Idite na Structure > Content types > [type] > Manage fields i dodajte polje.
Svaki entitet koji ima ovo polje dobija:
- prekidač statusa koji omogućava urednicima da uključuju ili isključuju komentarisanje po entitetu.
- Opcionalni prilagođeni identifikator tako da možete koristiti stabilan ID koji nije vezan za Drupal entitetski put.
Glavni blok FastComments Widget zna za ovo polje, i preskočiće entitete koji ga već imaju prikačenog. Na taj način možete kombinovati komentare po entitetu sa blokom bez da vidite widget dvaput na istoj stranici.
Једнократно пријављивање (SSO) 
FastComments se integriše sa Drupal-ovim sistemom korisnika putem SSO, odnosno jedinstvene prijave. Vaši korisnici se prijavljuju na vaš Drupal sajt, a modul automatski prosleđuje njihov identitet na FastComments. Nema dodatnih naloga za kreiranje, nema početne sinhronizacije koju treba pokrenuti.
Modul podržava tri SSO režima, podešena pod Administration > Configuration > Content > FastComments.
Nijedno
Bez SSO. Korisnici komentarišu kao gosti ili kreiraju FastComments nalog. Koristite ovo ako je vaš sajt javni i ne trebate vezati komentare za Drupal korisnike.
Jednostavno
Prosleđuje ime Drupal korisnika, e-mail i avatar na FastComments bez provjere na serverskoj strani. Nije potreban API Secret. Pogodno za interne ili niskorizične sajtove.
Sigurno (preporučeno)
Koristi HMAC-SHA256 za verifikaciju identiteta svakog korisnika sa FastComments. Ovo je režim koji želite kada imate konfigurisan API Secret, i jedini je režim koji sprječava posjetilaca da se predstavlja kao drugi korisnik.
Identitet korisnika se prosleđuje FastComments svaki put kada korisnik pregleda nit komentara. Nema početne ili kontinuirane sinhronizacije koja treba da se pokrene.
(Neobavezno) Dodajte svoje administratore u Korisnici i administratori i moderatore u Moderatori komentara kako biste poboljšali njihovo iskustvo i omogućili praćenje statistike za moderatore.
Za dublji uvid u kako SSO funkcioniše, pogledajte odjeljak SSO u dokumentaciji za prilagođavanje.
Дозволе 
Modul dodaje tri Drupal dozvole koje možete dodijeliti po ulozi pod People > Permissions.
- Administer FastComments - Pristup formi za postavke FastComments na
/admin/config/content/fastcomments. - View FastComments - Potrebno za prikaz widgeta za komentare. Bez ove dozvole widget se ne prikazuje.
- Toggle FastComments - Omogućava korisnicima da omoguće ili onemoguće komentare za svaki entitet koristeći widget polja.
Po zadanim postavkama, samo korisnici sa dozvolom administer site configuration mogu mijenjati postavke FastComments. Dodijelite View FastComments anonimnim i prijavljenim korisnicima ako želite da posjetioci vide widget.
Вишејезичност 
Модул аутоматски прослеђује тренутни језик Drupal сајта сваком FastComments виџету. Ако је ваш Drupal сајт конфигурисан за више језика, интерфејс за коментарисање ће се приказати на одговарајућем језику без додатне конфигурације.
Ово се односи на све типове виџета: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments и Top Pages.
Резиденција података у ЕУ 
Ако је ваш FastComments налог хостован у ЕУ, ажурирајте двије поставке у Administration > Configuration > Content > FastComments:
- CDN URL -
https://cdn-eu.fastcomments.com - Site URL -
https://eu.fastcomments.com
Такође ћете желети да преузмете ваш Tenant ID и API Secret са ЕУ контролне табле на eu.fastcomments.com/auth/my-account/api уместо са подразумеване US контролне табле. Све остало у модулу ради на исти начин.
Прилагођавање 
FastComments je dizajniran da se prilagodi vašem sajtu.
Ako želite dodati prilagođeni stil ili podesiti konfiguraciju, Pogledajte našu dokumentaciju o prilagođavanju da saznate kako.
Захтеви 
- Drupal 10 ili 11
- PHP 8.1 ili noviji
- Nalog na FastComments
Ovaj modul ne zahtijeva nikakve druge Drupal module ili biblioteke trećih strana. Zavisi samo od Drupal core (user, field).
Fallback <noscript> pruža server-renderirane komentare za posjetioce bez JavaScripta, tako da Live Comments i Streaming Chat i dalje rade u preglednicima sa onemogućenim skriptama.