FastComments.com
Menu Icon

Језик 🇷🇸 Српски
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇫🇷 Français (France) 🇩🇪 Deutsch 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇷🇸 Srpski (Latinica) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

TLDR

Brzi početak

Instalacija Drupala

Instalacija
Konfiguracija
Widget blokovi
Polja tipa sadržaja
Jedinstvena prijava (SSO)
Dozvole
Višejezičnost
Rezidencija podataka EU
Prilagođavanje
Zahtevi

Ankete

Dodajte ankete na vaš Drupal sajt

Dodajte komentarisanje u realnom vremenu na Drupal sajtove

Brzi početak Internal Link

Ово је „превише дуго; нисам читао“ (TL;DR) верзија Drupal упутстава.

  1. Инсталирајте модул помоћу composer require drupal/fcom, или га ставите у modules/custom/fastcomments/.
  2. Омогућите га помоћу drush en fastcomments, или из админ интерфејса на /admin/modules.
  3. Идите на Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Унесите ваш Tenant ID и API Secret са Подешавања > API/SSO (EU).
  5. Додајте поље FastComments у било који тип садржаја преко Structure > Content types > [type] > Manage fields.

Модул је објављен на drupal.org/project/fcom.

Instalacija Internal Link

The FastComments модул за Drupal замењује уграђене коментаре Drupala брзим системом за коментаре у реалном времену. Модул је објављен на drupal.org и ради са Drupal 10 и 11.

Постоје два начина за инсталирање.

Инсталирање помоћу 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 модуле или библиотеке.

Када је модул омогућен, идите у одељак Configuration да подесите ваш Tenant ID и API Secret.

Konfiguracija Internal Link

Сва подешавања се налазе под Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Обавезно

  • Tenant ID - Ваш FastComments Tenant ID. Пронађите га под Settings > API/SSO (EU).
  • API Secret - Обавезан за Secure SSO, верификацију webhook-ова и синхронизацију страница. Налази се под Settings > API/SSO (EU).

Чување API Secret-а

Модул чита API Secret из првог од ових извора који има вредност:

  1. Key модул - Инсталирајте Key, креирајте Authentication кључ и изаберите га под API Secret key на форми за подешавања. Кључ може бити подржан променљивом окружења или фајлом изван web root-а.
  2. settings.php - Додајте $config['fastcomments.settings']['api_secret'] = 'your-secret'; у settings.php или settings.local.php. Тајна никада не улази у извезену конфигурацију.
  3. Форма за подешавања - Унесите је у поље API Secret. Ово чува вредност у fastcomments.settings, тако да завршава у извозима конфигурације. Drupal извештај о статусу упозорава када је ово активни извор.

Форма приказује који је извор активан. Остављање поља празним задржава сачувану тајну. Штиклирајте Remove the API Secret stored in configuration да је обришете након премештања тајне у Key модул или settings.php.

Стил коментарисања

Изаберите виџет који одговара начину на који желите да људи комуницирају на вашем сајту.

  • Live Comments - Коментари у реалном времену са гранањем.
  • Streaming Chat - Интерфејс за живи ћаскање, добар за догађаје и преносе уживо.
  • Collab Chat - Анотација изабраног текста на главном подручју садржаја. Посетиоци истичу текст и покрећу дискусију у контексту.
  • Collab Chat + Comments - И collab ћаскање и стандардни коментари на истој страници.

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, погледајте одељак EU Data Residency.

Widget blokovi Internal Link

Модул испоручује неколико блокова које можете поставити из 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 и прилагођеним рутама без додатног подешавања.

Polja tipa sadržaja Internal Link

За већину сајтова, најлакши начин да додате коментаре је да приложите поље FastComments вашим типовима садржаја. Идите на Structure > Content types > [type] > Manage fields и додајте поље.

Свакој ентитету који има то поље се додаје:

  • прекидач статуса који омогућава уредницима да по ентитету укључе или искључе коментарисање.
  • Опционални прилагођени идентификатор да бисте могли да користите стабилан ID који није везан за Drupal путању ентитета.

Главни блок FastComments Widget зна за ово поље и прескочиће ентитете који га већ имају прикључено. На тај начин можете комбиновати коментаре по ентитету и блок, а да не видите виџет два пута на истој страници.

Jedinstvena prijava (SSO) Internal Link

FastComments се интегрише са Drupal-овим системом корисника преко SSO, односно једнократног пријављивања (single sign-on). Ваши корисници се пријављују на ваш Drupal сајт, а модул аутоматски прослеђује њихов идентитет FastComments-у. Нема додатних налога за креирање, нема потребе за покретањем иницијалне синхронизације.

Модул подржава три режима SSO, која се подешавају у Administration > Configuration > Content > FastComments.

Без SSO

Нема SSO. Корисници коментаришу као гости или креирају FastComments налог. Користите ово ако је ваш сајт јавни и не морате повезивати коментаре са Drupal корисницима.

Једноставан

Прослеђује име, имејл и аватар Drupal корисника FastComments-у без верификације на серверу. Није потребан API Secret. Погодно за интерне или сајтове са ниским ризиком.

Сигуран (препоручује се)

Користи HMAC-SHA256 за верификацију идентитета сваког корисника са FastComments-ом. Ово је режим који желите када имате конфигурисан API Secret, и то је једини режим који спречава посетиоца да се представља као други корисник.

Идентитет корисника се прослеђује FastComments-у сваки пут када корисник погледа дискусију коментара. Нема иницијалне или континуиране синхронизације која треба да се покреће.

(Опционо) Додајте своје администраторе у Корисници и администратори и модераторе у Модератори коментара да побољшате њихово искуство и омогућите праћење статистике за модераторе.

За детаљнији увид у то како SSO ради, погледајте одељак о SSO у документацији за прилагођавање.

Dozvole Internal Link

Модул додаје три Drupal дозволе које можете доделити по улози под People > Permissions.

  • Administer FastComments - Приступ формулару за подешавања FastComments на /admin/config/content/fastcomments.
  • View FastComments - Потребно да бисте видели видгет за коментаре. Без ове дозволе видгет се не приказује.
  • Toggle FastComments - Омогућава корисницима да укључе или искључе коментаре по ентитету користећи видгет поља.

По подразумеваној вредности, само корисници који имају дозволу administer site configuration могу да промене подешавања FastComments. Доделите View FastComments анонимним и пријављеним корисницима ако желите да посетиоци виде видгет.

Višejezičnost Internal Link

Модул аутоматски прослеђује тренутни језик Drupal сајта сваком FastComments видгету. Ако је ваш Drupal сајт конфигурисан за више језика, кориснички интерфејс за коментаре биће приказан на одговарајућем језику без додатне конфигурације.

Ово се примењује на све врсте видгета: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments и Top Pages.

Rezidencija podataka EU Internal Link

Ако је ваш FastComments налог хостован у ЕУ, ажурирајте две поставке на 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 контролне табле. Све остало у модулу ради исто.

Prilagođavanje Internal Link

FastComments је дизајниран да се прилагоди вашем сајту.

Ако желите да додате прилагођени стил, или прилагодите конфигурацију, Погледајте нашу документацију за прилагођавање и конфигурацију да бисте сазнали како.

Zahtevi Internal Link

  • Drupal 10 или 11
  • PHP 8.1 или новији
  • Налог на FastComments account

Овај модул не захтева друге Drupal модуле или библиотеке трећих страна. Он зависи само од Drupal језгра (user, field).

Резервна опција <noscript> обезбеђује коментаре рендероване на серверу за посетиоце без JavaScript-а, тако да Live Comments и Streaming Chat и даље раде у прегледачима са онемогућеним скриптовањем.

Dodajte ankete na vaš Drupal sajt Internal Link

Када је FastComments на вашој Drupal страници, можете такође покретати живе анкете директно у коментарима. Укључите Enable Polls у подешавањима прилагођавања вашег виџета и дугме за анкету ће се појавити у траци са алаткама за коментаре. Анкете подржавају од 2 до 10 опција, резултати се ажурирају уживо за све на страници, а ви одлучујете ко може да прави анкете и да ли гласање захтева пријављивање. Нема потребе за додатном инсталацијом на Drupal-у.

Пробајте демо живих анкета или прочитајте документацију о анкетама да их подесите.

Допринесите овом водичу