FastComments.com
Menu Icon

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

Сажетак

Брзи почетак

Инсталација Drupal-а

Инсталација
Конфигурација
Видгет блокови
Поља типа садржаја
Једнократно пријављивање (SSO)
Дозволе
Вишезичност
Резиденција података у ЕУ
Прилагођавање
Захтеви

Add Live Commenting to Drupal Sites

Брзи почетак 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.

Инсталација 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.

Конфигурација Internal Link

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

Обавезно

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

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

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

SSO режим

  • None - Нема SSO. Корисници коментаришу као гости или креирају FastComments налог.
  • Simple - Прослеђује Drupal корисничке податке (име, имејл, аватар) FastComments-у без верификације на серверу.
  • Secure - Користи HMAC-SHA256 за верификацију Drupal корисника са FastComments-om. Препоручује се када имате конфигурисан API Secret.

Погледајте одељак Single Sign-On (SSO) за детаље.

Остала подешавања

  • CDN URL - Подразумевано: https://cdn.fastcomments.com.
  • Site URL - Подразумевано: https://fastcomments.com.
  • Email notifications - Шаље е-поруку аутору садржаја када је постављен нов коментар на њихов садржај.

За резидентност података у ЕУ, погледајте одељак EU Data Residency.

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

Поља типа садржаја Internal Link

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

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

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

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

Једнократно пријављивање (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 у документацији за прилагођавање.

Дозволе Internal Link

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

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

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

Вишезичност Internal Link

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

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

Резиденција података у ЕУ 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 контролне табле. Све остало у модулу ради исто.

Прилагођавање Internal Link

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

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

Захтеви Internal Link

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

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

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

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