
Језик 🇲🇪 Српски (Црна Гора)
Укратко
Инсталација Drupala
Add Live Commenting to Drupal Sites
Брзи почетак 
Ово је верзија Drupal упутстава „превише дуго, нисам читао“.
- Инсталирајте модул са
composer require drupal/fcom, или га поставите уmodules/custom/fastcomments/. - Омогућите га са
drush en fastcomments, или преко админ интерфејса на/admin/modules. - Идите на
Administration > Configuration > Content > FastComments(/admin/config/content/fastcomments). - Унесите ваш Tenant ID и API Secret из Подешавања > API/SSO (ЕУ).
- Додајте поље
FastCommentsу било који тип садржаја прекоStructure > Content types > [type] > Manage fields.
Модул је објављен на drupal.org/project/fcom.
Инсталација 
The FastComments Drupal модул замењује уграђене Drupal коментаре брзим, коментарским системом у реалном времену. Модул је објављен на drupal.org и ради са Drupal 10 и 11.
There are two ways to install it.
Инсталирање помоћу Composer
composer require drupal/fcom
drush en fastcommentsРучна инсталација
Преузмите модул са drupal.org/project/fcom и поставите га у ваш modules/custom/fastcomments/ директоријум сајта. Затим га омогућите помоћу drush en fastcomments, или из администраторског интерфејса у Extend (/admin/modules).
Напомена! Модул зависи само од Drupal core-а (user и field). Не захтевају се додатни Drupal модули или библиотеке.
Once the module is enabled, head to the Configuration section to set up your Tenant ID and API Secret.
Подешавање 
Сва подешавања се налазе под Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
Обавезно
- Tenant ID - Ваш FastComments Tenant ID. Пронађите га под Подешавања > API/SSO (ЕУ).
- API Secret - Потребан за Secure SSO, верификацију webhook-а и синхронизацију страница. Налази се под Подешавања > API/SSO (ЕУ).
Стил коментарисања
Изаберите видгет који одговара начину на који желите да људи комуницирају на вашем сајту.
- 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.
Блокови виџета 
Модул долази са неколико блокова које можете поставити из 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) аутоматски детектују тренутни ентитет и на страницама које нису ентитет користе идентификатор заснован на путањи. То значи да раде на taxonomy pages, views, и custom routes без додатног подешавања.
Поља типова садржаја 
Za većinu sajtova, najlakši način za dodavanje komentara је да priložite polje FastComments вашим типовима садржаја. Идите на Structure > Content types > [type] > Manage fields и додајте поље.
Сваки ентитет који има то поље добија:
- Преклопник статуса који омогућава уредницима да укључе или искључе коментаре за сваки ентитет.
- Опциона прилагођена идентификација која вам омогућава коришћење стабилног ID-а који није везан за путању Drupal ентитета.
Главни блок FastComments Widget препознаје ово поље и прескочиће ентитете који га већ имају прикљученог. На тај начин можете комбиновати коментаре по ентитету са блоком, а да не видите видџет двапут на истој страници.
Једнократно пријављивање (SSO) 
FastComments се интегрише са корисничким системом Drupala преко SSO-а, односно једнократног пријављивања. Ваши корисници се пријављују на ваш Drupal сајт, а модул аутоматски прослеђује њихов идентитет FastComments-у. Нема додатних налога за креирање, нема почетне синхронизације за покретање.
The module supports three SSO modes, set under Administration > Configuration > Content > FastComments.
Ниједно
Без SSO-а. Корисници коментаришу као гости или креирају FastComments налог. Користите ово ако је ваш сајт јаван и ако не треба да повежете коментаре са Drupal корисницима.
Једноставно
Прослеђује име Drupal корисника, имејл и аватар на FastComments без верификације на серверској страни. Нема потребе за API Secret-ом. Погодно за интерне или ниско-ризичне сајтове.
Безбједно (препоручено)
Користи HMAC-SHA256 за верификацију идентитета сваког корисника са FastComments. Ово је режим који желите када имате конфигурисан API Secret, и то је једини режим који спречава посетилаца да се претварају да су други корисник.
Идентитет корисника се прослеђује FastComments-у сваки пут када корисник погледа нит коментара. Нема почетне или континуиране синхронизације која се мора покренути.
(Optional) Додајте своје администраторе у Users & Administrators и модераторе у Comment Moderators да побољшате њихово искуство и омогућите праћење статистике за модераторе.
За детаљнији увид у то како SSO функционише, погледајте SSO section у документацији за прилагођавања.
Дозволе 
Модул додаје три Drupal дозволе које можете доделити по улози под People > Permissions.
- Administer FastComments - Приступ формулару за подешавање FastComments на
/admin/config/content/fastcomments. - View FastComments - Потребно да бисте видели коментарски виџет. Без ове дозволе виџет се не приказује.
- Toggle FastComments - Омогућава корисницима да омогуће или онемогуће коментаре за појединачне ентитете користећи виџет поља.
Подразумевано, само корисници са дозволом administer site configuration могу да мењају подешавања FastComments. Доделите View FastComments анонимним и пријављеним корисницима ако желите да посетиоци виде виџет.
Вишејезично 
Модул аутоматски прослеђује тренутни језик Drupal сајта сваком FastComments видџету. Ако је ваш Drupal сајт подешен за више језика, кориснички интерфејс за коментаре ће се приказати на одговарајућем језику без додатне конфигурације.
Ово важи за све типове видџета: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments и Top Pages.
Резиденција података у ЕУ 
Ако је ваш FastComments налог хостован у EU, ажурирајте двије поставке у Administration > Configuration > Content > FastComments:
- CDN URL -
https://cdn-eu.fastcomments.com - Site URL -
https://eu.fastcomments.com
Такође ћете желети да преузмете ваш Tenant ID и API Secret са EU контролне табле на eu.fastcomments.com/auth/my-account/api уместо са подразумеване US контролне табле. Све остало у модулу ради на исти начин.
Прилагођавање 
FastComments је дизајниран да се прилагоди вашем сајту.
Ако желите да додате прилагођени стил или подесите конфигурацију, Погледајте нашу документацију о прилагођавању и конфигурацији да бисте сазнали како.
Захтјеви 
- Drupal 10 или 11
- PHP 8.1 или новији
- Налог на FastComments
Модул не захтијева друге Drupal модуле или библиотеке трећих страна. Он зависи само од Drupal core (user, field).
Резервна опција <noscript> обезбјеђује серверски рендероване коментаре за посјетиоце без JavaScript-а, тако да Live Comments и Streaming Chat и даље раде у прегледачима са онемогућеним скриптама.