Можете приметити да се видгет за коментаре може користити са Tenant ID-ом "demo", на пример:

Демо Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo"

7}];

8</script>

9

Ово је намењено само за испробавање видгета за коментаре. У продукцији бисте проследили ваш Tenant ID, на следећи начин:

Дефинисање вашег Tenant ID-а

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "aKa2Z4Q="

7}];

8</script>

9

Ваш Tenant ID се већ може пронаћи примењен у видгету за коментаре у кодном исечку у вашем налогу.

Такође можете пронаћи ваш Tenant ID и управљати вашим API кључевима на страници API акредитива.

Од ове тачке, ако сте пријављени у FastComments, примери кода ће користити ваш стварни Tenant ID (ако сте пријављени на https://fastcomments.com).

Када се приказује низ коментара, или се оставља коментар, FastComments мора да зна на коју страницу, чланак или производ ти коментари припадају.

Да бисмо то урадили, користимо нешто што зовемо "URL ID". То је или идентификатор, попут стринга или броја, или URL.

Подразумевано, ако не наведете urlId, он ће постати page URL. Узећемо тренутни URL странице и очистити га да уклонимо уобичајене маркетиншке параметре или идентификаторе за праћење.

У случају интеграција трећих страна, као што је WordPress, наш плагин обично користи идентификатор који представља тренутну информацију која се прегледа као URL ID, на пример article/page id.

Defining a Custom URL ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "urlId": "https://example.com/page"

8}];

9</script>

10

Једна ствар на коју ћемо често упућивати у овом документа је Интерфејс за прилагођавање видгета.

Овај интерфејс се може користити за извршавање многих промена на видгету за коментаре без коришћења кода.

Када креирамо правило прилагођавања, често ћемо желети да се оно примењује на све странице нашег сајта. Међутим, у неким случајевима желимо да прилагодимо видгет за коментаре на одређеној страници, било да применимо прилагођени стил, или можда учинимо коментаре за ту страницу анонимним. На пример, можете имати да се живи коментари појаве одмах на неким страницама, док су на другим скривени испод дугмади за обавештења.

Ово је све могуће преко поља за унос URL ID на овој страници, које изгледа на следећи начин:

URL ID Input in The Widget Customization Page

Вредност у овом пољу треба да одговара параметру urlId који се прослеђује у видгет за коментаре. Ако желите да ваше правило прилагођавања буде непристрасно према urlId, оставите ово поље празно или унесите *.

Од 2023. поље URL ID у прилагођавању видгета сада такође прихвата обрасце! На пример, можете имати */blog/* да додате стилове специфичне за ваш блог и */store/* да имате стилове специфичне за вашу продавницу, све при томе користећи исту домену.

Напомене

1. Ако ваша страница има hash параметре (нпр. example.com#page-1) - ово ће подразумевано постати део URL ID.
2. Током миграција, на пример са WordPress на Gatsby, можда ћете морати да мигрирате вредности коментара URL ID након почетне миграције. За то, обратите нам се.

FastComments је дизајниран да буде прилагодљив. Сам коментарски виџет ради унутар iframe-а из безбедносних разлога, тако да да бисте примењивали прилагођени стил морате да пратите један од два приступа.

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

У страници за прилагођавање виџета, погледајте одељак "Show Advanced Options", у ком се налази област означена као "Custom CSS":

Custom CSS Input Area

Овај приступ има неке предности:

1. Унети CSS се минимизује пре него што се пошаље кориснику, а формат се одржава доследним у уређивачу.
2. Добијате све предности корисничког интерфејса за прилагођавање виџета, на пример лако прилагођавање коментарског виџета другачије за различите сајтове.
3. Када направимо измене у коментарском виџету, ваши прилагођени стилови ће бити тестирани као део нашег процеса издавања.

Други приступ је да наведете параметар customCSS у конфигурацији виџета, на следећи начин:

Passing Custom CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "button { background: red; }"

8}];

9</script>

10

Међутим, ово има ограничења:

1. Постоји ограничење колико прилагођеног CSS-а може бити послато пре него што наши сервери одбију захтев, услед величине заглавља.
2. Морате сами управљати прилагођеним CSS-ом у вашој инфраструктури и систему за изградњу. Ово може бити и предност, а не само мана.
3. Постоји додатни трошак слања прилагођеног CSS-а преко мреже две пута у овом случају употребе, јер мора бити послат на наше сервере, а затим враћен у садржај iframe-а. Међутим, за већину величина payload-а ово није приметно.
4. Уобичајена оптимизација је минимизација CSS-а да би се смањила његова величина преко мреже, међутим са овим приступом морате то сами да обрадите.
5. Ваш прилагођени CSS неће бити тестирани када направимо измене.

External CSS Files

Можете наредити виџету да преузме спољну датотеку коришћењем @import!

Препоручује се да ставите @import у правило за прилагођавање. На овај начин, ако икада будемо морали да направимо измену у коментарском виџету, можемо да користимо наше аутоматске алате да проверимо вашу конфигурацију. Дакле, на пример, креирали бисте правило за прилагођавање у UI за прилагођавање виџета, кликнули на Advanced, и унели у Custom CSS:

@import url(https://example.com/styles.css);

In Code - Not Recommended

Такође можете учитати спољну CSS датотеку преко customCSS својства:

External CSS File

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

Међутим, имајте на уму да ваш CSS неће моћи да буде тестирани од нас ако ово урадите.

User Profile Modal Styling

Модали корисничких профила такође се могу стиловати прилагођеним CSS-ом. Међутим, да би се осигурало да се прилагођени стилови примене на корисничке профиле, сви CSS селектори морају бити префиксни са .user-profile. Без овог префикса, прилагођени стилови ће бити игнорисани за модале корисничких профила.

На пример:

User Profile CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

Backwards Compatibility

У FastComments-у знамо да наши клијенти прилагођавају коментарски виџет. То је по дизајну - последња ствар коју желимо је да наш производ изазове дизајн неусклађености у вашем производу.

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

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

За кориснике са Pro или Enterprise налогима дозвољено је прилагођено брендирање. Једноставно обратите нам се и радо ћемо помоћи.

Ако желите само да уклоните наш логотип из видгета за коментаре, то је аутоматски омогућено на Flex и Pro плановима.

Ови планови такође обезбеђују исту функционалност за е-поруке послате са наше платформе.

За сајтове који омогућавају пребацивање тамног режима након иницијалног учитавања странице, ово је мало сложеније.

Прво, све тренутне верзије библиотеке Comment widget (React, Vue) имају примере пребацивања тамног режима у својим репозиторијумима.

За VanillaJS widget, мораћемо да урадимо још неколико ствари. Прво, FastCommentsUI враћа објекат са функцијама "destroy" и "update".

Једноставно можемо позвати функцију update сваки пут када желимо да ажурирамо конфигурацију widgetа за коментаре, на следећи начин. Ево комплетног функционалног примера пребацивања тамног режима са VanillaJS widget-ом.

Комплетан пример пребацивања тамног режима

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

Са FastComments-ом, сав текст у видгету за коментаре може се прилагодити.

Можете да замените појединачни део текста, као што је дугме за слање, или сав текст у целом видгету за коментаре.

По подразумевању, текст у видгету за коментаре се преводи у складу са локалом корисника. Међутим, можемо да заменимо текст, ако смо сигурни да већина наших корисника користи исти локал/језик, на пример:

Custom Text

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

Све прилагодљиве преводе можете пронаћи овде у картици "напредне опције".

Међутим, постоји једноставнији начин преко корисничког интерфејса за прилагођавање видгета. Тамо можемо једноставно пронаћи текст који се приказује у видгету за коментаре у EN_US локалу и одредити замену.

Custom Text

Све измене превода тренутно утичу на све локале.

Када корисник први пут коментарише помоћу FastComments-а, покушаћемо да преузмемо њихов аватар са http://gravatar.com/.

Међутим, ако не пронађемо аватар или корисник никада не постави један у свом налогу, приказујемо статичну подразумевану слику аватара.

Да бисте навели своју статичну слику аватара, можете користити подешавање defaultAvatarSrc.

Замена подразумеваног аватара

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

Ово се такође може урадити без кода. На страници за прилагођавање видгета, погледајте одељак "Подразумевани аватар".

Прилагођавање подразумеваног аватара

Имајте на уму да је дефинисање аватара за појединачног корисника, као нпр. уз SSO, обрађено у свом засебном одељку.

Аватари се могу потпуно уклонити из коментарског виџета, чак и ако корисници имају сопствени аватар.

Hiding Avatars

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

Ово се може прилагодити без кода, на страници за прилагођавање виџета:

Hiding Avatars

За веће пројекте прилагођавања стилова, може бити пожељно почети с чисте табле и уопште не користити подразумевани стил.

Сви подразумевани стилови могу се уклонити подешавањем параметра noStyles на true, на следећи начин:

Онемогућавање свих подразумеваних стилова

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

Ово се може прилагодити без писања кода, на страници за прилагођавање видгета, у оквиру Напредних опција:

Онемогућавање свих подразумеваних стилова

По подразумевању, одговори на коментаре највишег нивоа се приказују.

Ово се може подесити тако да корисник мора да кликне "Прикажи одговоре" на коментарима највишег нивоа да би видео подкоментаре.

Collapse Replies to Top Level Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

Ово се може прилагодити без кода, на страници за прилагођавање видгета:

Collapse Replies

Ово подешавање неће утицати на број коментара највишег нивоа који се иницијално учитавају. Ако имате један коментар највишег нивоа, и 29 подкоментара, са овим подешавањем укљученим ви ћете:

• Видети коментар највишег нивоа.
• Видети "Прикажи одговоре (29)" испод овог коментара.

Ако желите да прикажете све коментаре највишег нивоа у комбинацији са овом опцијом, подесите почетну страницу на -1.

По подразумевању, форматирање у FastComments се врши додавањем видљивих ознака као што су <b></b> око вашег текста. То се ради кликом на траку са алаткама или коришћењем пречица. Међутим, неке заједнице можда желе да користе форматирање без видљивих ознака. Ово се назива омогућавањем WYSIWYG (оно што видите је оно што добијате) уређивача. Тај уређивач изгледа управо као подразумевани, осим што учитава додатни код који омогућава корисницима да своје текстове подебљају, подвлаче итд. без видљивих ознака.

Enabling WYSIWYG Editing

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

Ово се може урадити и без кода. На страници за прилагођавање виџета, погледајте опцију "Омогући напредно форматирање".

Enable WYSIWYG

По подразумевању, FastComments ће приказати траку са алаткама приликом писања коментара да би обезбедио пречице за форматирање текста и отпремање слика.

Ову траку са алаткама можете онемогућити у коду или помоћу интерфејса за прилагођавање.

Disabling The Toolbar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

Ово се такође може урадити без кода. На страници за прилагођавање виџета погледајте опцију "Онемогући траку са алаткама за одговоре".

Disabling The Toolbar

По подразумеваној вредности, FastComments омогућава корисницима да блокирају друге кориснике. Блокирање корисника ће узроковати да његови коментари буду замагљени, спречити обавештења између корисника, и тако даље.

Може бити пожељно онемогућити ову функционалност. То се може урадити на следећи начин:

Disable Blocking

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

Ово се такође може урадити без кода, што омогућава и исправну валидацију на страни сервера, преко корисничког интерфејса за прилагођавање видгета:

Disable Blocking

По подразумевaњу се користе локализовани релативни датуми. На пример, поред недавно остављеног коментара можете видети "пре 11 минута".

Може бити неопходно или пожељно користити апсолутне датуме, у ком случају подесите овај параметар на true.

Use Absolute Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteDates": true

8}];

9</script>

10

Ово се може прилагодити без кода, на страници за прилагођавање видгета, у оквиру Напредних опција:

Use Absolute Dates

По подразумеваној вредности користе се локализовани релативни датуми. На пример, поред недавно остављеног коментара можете видети „пре 11 минута“.

Може бити потребно или жељено задржати овај формат релативног датука, али истовремено приказати и пун датум уз њега — у том случају подесите овај параметар на true.

Use Both Absolute and Relative Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

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

Use Both Absolute and Relative Dates

Неки текст, као што је заглавље или порука, може бити приказан испод броја коментара, али изнад текста о статусу пријаве.

Ово називамо заглављем, и подразумевано је скривено.

Specifying Header HTML

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

Ово се може прилагодити без писања кода, на страници за прилагођавање виџета, у оквиру Напредне опције:

Specifying Header HTML

По подразумевању, FastComments ће приказивати линкове овако: https://exmaple.com - где URL линка постаје кликабилна HTML ознака.

Неки сајтови могу желети да ово онемогуће, на пример да би одвратили преваранте. Ово обезбеђујемо постављањем Comment HTML Rendering Option на Links as Text.

Ово се може прилагодити без писања кода, на страници за прилагођавање виџета, за цео домен или страницу:

Render Links as Text

По подразумевaњу, FastComments ће истовремено приказати поље за унос коментара и нит коментара. Да би уштедео вертикални простор, такође ће сакрити сва друга обавезна поља док се не интерагује са виџетом.

Међутим, виџет за коментаре може бити сакривен иза дугмета, на пример:

Click to Show Comments

Дугме користи различит превод текста у зависности од тога да ли су коментари тренутно приказани или не. Ако су коментари скривени, користи translations.SHOW_COMMENTS_BUTTON_TEXT. Ако су коментари приказани, користи translations.HIDE_COMMENTS_BUTTON_TEXT. Преводи могу садржати текст [count] који ће бити замењен локализованим бројем.

Click to Show or Hide Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useShowCommentsToggle": true

8}];

9</script>

10

Ово је дизајнирано да замени конфигурацију hideCommentsUnderCountTextFormat.

Број се ажурира уживо са нити коментара. Дугме се не приказује ако нема коментара.

Ово се може омогућити без кода кроз креирање правила прилагођавања и омогућавање „Кликните да бисте приказали коментаре“:

Enable Click to Show Comments

Број коментара који се приказује на врху видгета за коментаре може се прилагодити.

Ово може бити замењено било којим низом, а вредност [count] биће замењена бројем коментара, локализованим за корисника.

Прилагођавање текста броја коментара

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

Ово се може прилагодити без писања кода, на страници за прилагођавање виджета:

Прилагођавање текста броја коментара

Када корисници унесу хештег, у облику #someexampletag, FastComments ће аутоматски креирати тај HashTag и истакнути га у њиховом коментару.

У неким случајевима пожељно је онемогућити ову функцију, или контролисати које хештегове се могу користити преко API-ја.

Да бисте то урадили, једноставно омогућите Disable Automatic #hashtag Creation преко интерфејса за прилагођавање видгета.

Disabling Automatic HashTag Creation

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

То звонце ће постати црвено и показати број обавештења које корисник има. Неки примери обавештења су:

• Корисник вам је одговорио.
• Корисник је одговорио у нити у којој сте коментарисали.
• Корисник је лајковао ваш коментар.
• Корисник је одговорио на страницу на коју сте се претплатили.

Икона звона за обавештења такође пружа механизам за претплату на целу страницу.

Међутим, можемо у потпуности онемогућити икону звона за обавештења:

Disable Notification Bell

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

Ово се такође може урадити и без кода. На страници за прилагођавање видгета, погледајте одељак „Онемогући икону звона за обавештења“.

Disable Notification Bell

По подразумеваној вредности, FastComments ће приказати профил корисника када кликнете на њихов аватар.

Међутим, можемо онемогућити ову функционалност:

Disable Profiles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

Ово се такође може урадити без кода. На страници за прилагођавање виџета, погледајте одељак "Онемогући профиле".

Disable Profiles

По подразумеваној вредности, FastComments ће приказати поруку о успеху након коментарисања. Ово се може онемогућити на следећи начин:

Disable Success Message

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

Ово се такође може урадити без кода. На страници за прилагођавање виџета:

Disable Success Message

По подразумевању, FastComments коментар виџет ће поставити gif rating на pg.

Доступне опције су g, pg, pg-13 и r.

Ово се може подесити у коду или преко корисничког интерфејса. У коду то можемо урадити на следећи начин:

Set Gif Rating

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

У корисничком интерфејсу, ово ћете наћи под Gif Picker Rating све док Disable Image Uploads? није означено.

Setting The Gif Rating

По подразумеваној поставци, FastComments коментарски виџет има модерацију садржаја слика искључену off.

Доступне опције су off, low, medium, и high.

У интерфејсу за прилагођавање виџета, ово ћете пронаћи под Image Content Moderation Level, под условом да опција Disable Image Uploads? није означена.

Setting The Image Content Moderation Level

По подразумеваној поставци, FastComments ће приказивати опције гласања као стрелице горе и доле, омогућавајући корисницима да гласају за или против коментара.

Међутим, могуће је променити стил траке за гласање. Тренутне опције су подразумевани тастери Горе/Доле, или коришћење механизма гласања у облику срца.

Користимо флаг voteStyle на следећи начин:

Enable Heart Button

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

Снажно препоручујемо да ово урадите без кода јер такође омогућава валидацију на серверској страни. На страници за прилагођавање видгета, погледајте одељак "Стил гласања".

Change Voting Style

Гласање такође може бити онемогућено, погледајте Disable Voting изнад опција стила.

По подразумевању, FastComments ће дозволити корисницима да обришу своје коментаре.

Међутим, могуће је спречити ово.

На страници за прилагођавање виџета, погледајте опцију "Disable Deleting".

Disable Comment Deleting

• Ово утиче само на редовне коментаторе и не на модераторе или администраторе, који ће и даље моћи да бришу.
• Ово ће такође утицати на API интеграције када се проследи contextUserId.

Подразумевано, FastComments ће дозволити корисницима да уређују своје коментаре.

Међутим, могуће је то онемогућити.

На страници за прилагођавање видгета, погледајте опцију "Онемогући уређивање".

Disable Comment Editing

• Ово утиче само на обичне коментаторе и не утиче на модераторе или администраторе, који ће и даље моћи да уређују.
• Ово ће такође утицати на API интеграције када се проследи contextUserId.

По подразумеваној вредности, величина странице у FastComments-у је 30. Ово укључује одговоре у нитима.

Величина странице може се прилагодити у UI за конфигурацију видгета у различитим величинама у распону од 10 до 200.

Имајте у виду да промена величине странице захтева прерачунавање свих нитова коментара на вашем налогу. Ово може потрајати неколико минута.

Ово се не може подесити у видгету на клијентској страни јер се странице израчунавају на серверској страни.

Пример конфигурације је приказан испод:

Custom Page Sizes

Величине страница могу се прилагодити глобално, по домену или по страници креирањем различитих правила прилагођавања.

Ово ће утицати на све клијенте, интеграције и фрејмворке које можда користите за приказ коментара преко наше платформе.

По подразумеваној поставци, FastComments ће приказати име корисника како су га унели, или како нам је прослеђено преко SSO.

Међутим, може бити пожељно прикрити или приказати име корисника на другачији начин. На пример, ако је име корисника Allen Rex, можда желите да прикажете само "Allen R.".

Ово се може урадити без кода у Widget Customization UI, под поставком која се зове Commenter Name Format:

Change Name Format

Доступни формати су:

• Име са великим почетним словом (прикажи Example User као Example User)
• Иницијал презимена (прикажи Example User као Example U.)
• Сви иницијали (прикажи Example User као E. U.)
• Прикажи "Anonymous"

Утицај промене је непосредан. Корисници ће и даље видети своје пуно корисничко име на врху подручја за коментаре, за себе, али ће њихови коментари показивати измењено корисничко име.

Корисничка имена се маскирају на серверској страни ради заштите корисника.

По подразумевању, FastComments дозвољава отпремање слика. Ово се може онемогућити постављањем заставице noImageUploads на true.

Disabling Image Uploads

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

Ово се може прилагодити без писања кода, на страници за прилагођавање видгета:

Disabling Image Uploads

По подразумевању, у видгету за коментаре није приказано поље за претрагу.

Међутим, ово можемо укључити подешавањем флага enableSearch на true:

Омогућавање претраге

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

Ово се такође може урадити без кода. На страници за прилагођавање видгета, погледајте опцију "Омогући поље за претрагу".

Омогућавање поља за претрагу

Можемо омогућити подршку за спојлере подешавањем заставице enableSpoilers на true:

Enabling Spoilers

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

Ово се такође може урадити и без кода. На страници за прилагођавање виџета, погледајте опцију "Омогући спојлере".

Enable Spoilers

Када је текст обележен, и када се кликне на сада видљиво дугме SPOILER, текст ће бити маскиран док корисник не помери курсор преко њега. За тамни режим радимо исто, али са другачијим бојама које боље одговарају тамном режиму.

Ово је такође компатибилно са WYSIWYG уређивачем.

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

Међутим, ову функцију можемо омогућити, и тада ће систем почети да прати када корисник скролује до коментара.

Када се то догоди, бројач поред иконе ока који се приказује на сваком коментару ће се повећати. Број се ажурира у реалном времену и скраћује се у складу са локалним подешавањима корисника.

Ову опцију можемо омогућити постављањем флага enableViewCounts на true:

Enabling Comment View Counts

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableViewCounts": true

8}];

9</script>

10

Ово се може прилагодити без кода, на страници за прилагођавање видгета:

Enabling Comment View Counts

Пратимо и ID корисника* који је прегледао коментар, тако да ако поново погледате коментар, бројач се неће повећати. Ако поново погледате коментар након две године, број ће се повећати поново.

• *Напомена: или anon session id, или IP корисника као хеширана вредност.

Podrazumevano je omogućeno komentarisanje uživo. To znači da, ako se bilo koji komentari dodaju, brišu, uređuju ili prikače, promene bi trebalo da se pojave svim korisnicima koji u tom trenutku gledaju nit komentara.

Međutim, po defaultu ti novi komentari će se pojaviti ispod dinamički prikazanog dugmeta sa tekstom sličnim "Prikaži 2 nova komentara".

Ako su novi komentari odgovori direktno na stranicu, dugme će se prikazati na vrhu niti komentara. Ako su odgovori na određeni komentar, dugme će se prikazati ispod tog komentara.

Ovo je da bi se sprečilo stalno menjanje veličine stranice, što može izazvati frustraciju kada korisnik pokuša da uhvati traku za pomeranje.

Za neke slučajeve upotrebe, kao što su licitacije uživo ili onlajn događaji, ovo nije poželjno ponašanje - možda ćete želeti da widget za komentare bude više kao "chat" prozor gde se novi komentari "prikazuju odmah".

Otuda i ime zastavice koja omogućava tu opciju: showLiveRightAway.

Možemo ga uključiti na sledeći način:

Prikaži komentare uživo odmah

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

Ovo se može prilagoditi bez koda, na stranici za prilagođavanje widgeta:

Prikaži komentare uživo odmah

По подразумеваној поставци, FastComments ће имати омогућено живо коментарисање.

То значи да ће сваки посматрач нити коментара видети исти садржај.

На пример, ако се коментар дода, тај коментар ће се појавити. Ако се коментар уреди или уклони, тада ће ти коментари бити уређени или уклоњени за све посматраче нити. Исто важи за гласања и све радње модерације.

Међутим, ово можемо онемогућити:

Disable Live Commenting

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

Ово се такође може урадити и без кода. На страници за прилагођавање виџета, погледајте одељак "Онемогући живо коментарисање".

Disable Live Commenting

По подразумевању, FastComments ће сортирати коментаре по смеру сортирања „Most Relevant“.

Сортирање „Most Relevant“ узима у обзир време када је коментар остављен и број гласова приликом сортирања.

Корисник потом може у UI видгета за коментаре да промени смер сортирања на „Најстарије прво“ или „Најновије прво“.

Међутим, можемо променити подразумевано на било који од ова три. На пример, ако желите да прикажете најстарије коментаре прво:

Changing The Default Sort To Oldest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

Подешавамо вредност defaultSortDirection на "OF" да бисмо поставили смер на "OF".

За смер сортирања „Најновије прво“, урадили бисмо следеће:

Changing The Default Sort To Newest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

Валидне вредности за defaultSortDirection су:

• MR: "Most Recent"
• NF: "Newest First"
• OF: "Oldest First"

Ово се може урадити и без кода. На страници за прилагођавање видгета, погледајте одељак „Подразумевани смер сортирања“.

Changing The Default Sort Direction

Имајте у виду да се коментари на свакој страници за сваки смер сортирања предрачунавају, тако да сви смерови сортирања имају исте перформансе.

По подразумеваној вредности поље за унос коментара је пре низа коментара. Међутим, постављањем овог конфигурационог параметра на true можемо га померити испод.

Moving The Reply Box to The Bottom

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

Ово се може прилагодити без кода, на страници за прилагођавање виџета:

Moving The Reply Box to The Bottom

Максималан број знакова који се могу унети у поље за коментар може се ограничити параметром maxCommentCharacterLength.

Подразумевано је 2000.

Ствари као што су URL-адресе слика нису укључене у одређивање дужине.

Limit Comment Length

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

Ово се може прилагодити без писања кода, на страници за прилагођавање виџета:

Limit Comment Length

По подразумевању, FastComments ће дозволити кориснику да унесе коментар са онолико редова колико желе, до подразумеваног ограничења знакова.

Међутим, можда ће бити пожељно ограничити корисника да уноси само један ред текста. Неке примерне употребе укључују онлајн надметање или уживо ћаскање, за које се FastComments може користити.

Флаг useSingleLineCommentInput омогућавамо на следећи начин:

Enable Single-Line Comment Input

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

Ово се може урадити и без кода. На страници за прилагођавање виџета, погледајте одељак "Омогући унос коментара у једном реду".

Enable Single-Line Comment Input

Имајте на уму да су коментари на свакој страници за сваки смер сортирања претходно израчунати, тако да све опције сортирања имају исте перформансе.

По подразумеваној вредности, сваки корисник може послати до 5 comments у истом минуту.

Ово се прати по user id, anon user id и ip address (хеширано).

Ово се може прилагодити без кода, на страници за прилагођавање виџета:

Ограничавање броја коментара по кориснику

Имајте на уму да ако користите API за креирање коментара можда желите да проследите корисникову оригиналну ip адресу у захтеву ка нашем бекенду како би ограничења брзине била примењена по кориснику, а не глобално за ваш налог.

FastComments Secure SSO користи HMAC-SHA256 енкрипцију као механизам за имплементацију SSO. Прво ћемо проћи кроз општу архитектуру, пружити примере и детаљне кораке.

Постоји и нека документација у вези миграције са других провајдера са сличним SSO механизмима, и разлика.

Ток изгледа овако:

Ток сигурног SSO

Пошто Secure SSO подразумева full-stack развој, потпуно функционални примери кода у Java/Spring, NodeJS/Express и vanilla PHP су тренутно на GitHub-у.

Иако у NodeJS примеру користимо ExpressJS а у Java примеру Spring, у овим runtime окружењима нису потребне додатне библиотеке/фрејмворци да бисте имплементирали FastComments SSO — нативни crypto пакети су довољни.

Не морате да правите нове API endpoint-ове за FastComments SSO. Једноставно енкриптујте информације о кориснику користећи ваш тајни кључ и проследите payload у comment widget.

Добијте ваш API тајни кључ

Ваш API тајни кључ можете преузети са ове странице. Такође можете доћи до ове странице тако што ћете отићи на My Account, кликнути на API/SSO плочицу, а затим кликнути "Get API Secret Key".

Параметри видгета за коментаре

Високо-ниво API документације за comment widget можете пронаћи овде.

Хајде да детаљније размотримо шта ти параметри значе.

Comment widget прима конфигурациони објекат — већ прослеђујете овај објекат ако користите FastComments да бисте проследили ваш tenantId (зване customer id).

Да бисте омогућили SSO, проследите нови објекат "sso", који мора имати следеће параметре. Вредности треба да буду генерисане на серверској страни.

• userDataJSONBase64: Подаци корисника у JSON формату, који се затим кодују у Base64.
• verificationHash: HMAC-SHA256 хеш направљен од UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Epoch timestamp у милисекундама. Не сме бити у будућности, нити више од два дана у прошлости.
• loginURL: URL који comment widget може приказати за пријављивање корисника.
• logoutURL: URL који comment widget може приказати за одјављивање корисника.
• loginCallback: Када је обезбеђено уместо login URL-а, функција коју ће comment widget позвати када се кликне дугме за пријаву.
• logoutCallback: Када је обезбеђено уместо logout URL-а, функција коју ће comment widget позвати када се кликне дугме за одјаву.

Secure SSO Client Code

Copy

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1768890094516,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout"

13 }

14}];

15</script>

16

Кориснички објекат

The User Object:

Кориснички објекат

Copy

1

2interface SSOUser {

3 /** Обавезно. Максимум 1k карактера. **/

4 id: string;

5 /** Обавезно. Максимум 1k карактера. Напомена: Мора бити јединствено. **/

6 email: string;

7 /** Обавезно. Максимум 1k карактера. Напомена: Корисничко име не може бити имејл. Не мора бити јединствено. **/

8 username: string;

9 /** Опционо. Максимум 3k карактера за URL-ове. Подразумевано је са gravatar-а на основу имејла. Подржава 64 кодиране слике, у ком случају је лимит 50k карактера. **/

10 avatar?: string;

11 /** Опционо. Подразумевано false. **/

12 optedInNotifications?: boolean;

13 /** Опционо. Подразумевано false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Опционо. Максимум 100 карактера. Ова ознака ће бити приказана поред њиховог имена. Подразумевано је Administrator/Moderator када је применљиво. **/

16 displayLabel?: string;

17 /** Опционо. Максимум 500 карактера. Ово ће бити приказано уместо корисничког имена. **/

18 displayName?: string;

19 /** Опционо. Максимум 2k карактера. Име корисника ће водити на ово. **/

20 websiteUrl?: string;

21 /** Опционо. До 100 група по кориснику. ID групе не може бити дужи од 50 карактера. **/

22 groupIds?: string[];

23 /** Опционо. Означава корисника као администратора. **/

24 isAdmin?: boolean;

25 /** Опционо. Означава корисника као модератора. **/

26 isModerator?: boolean;

27 /** Опционо, подразумевано true. Поставите на false да омогућите "activity" таб у корисничком профилу. **/

28 isProfileActivityPrivate?: boolean;

29 /** Опционо, подразумевано false. Поставите на true да онемогућите коментаре на профилу. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Опционо, подразумевано false. Поставите на true да онемогућите слање директних порука овом кориснику. **/

32 isProfileDMDisabled?: boolean;

33}

34

Модератори и администратори

За администраторе и модераторе, проследите одговарајуће isAdmin или isModerator ознаке у објекту SSOUser.

Обавештења

Да бисте омогућили или онемогућили обавештења, подесите вредност optedInNotifications на true или false респективно. Први пут када корисник учита страницу са овом вредношћу у SSO payload-у, њихова подешавања обавештења ће бити ажурирана.

Додатно, ако желите да корисници примају електронске поруке обавештења за активност на страницама на које су се претплатили (за разлику од само апликационих обавештења), подесите optedInSubscriptionNotifications на true.

VIP корисници и посебне ознаке

Можете приказати посебну ознаку поред имена корисника коришћењем опционог поља "displayLabel".

Неаутентификовани корисници

Да бисте представили неаутентификованог корисника, једноставно не попуњавајте userDataJSONBase64, verificationHash или timestamp. Обезбедите loginURL.

Ови корисници неће моћи да коментаришу, већ ће им бити приказана порука за пријаву (порука, линк или дугме, у зависности од конфигурације).

Директни примери за серијализацију и хеширање података корисника

Више детаља и примера можете наћи овде (js), овде (java) и овде (php).

Разумемо да било која интеграција може бити компликован и болан процес. Не оклевајте да контактирате вашег представника или да користите страницу за подршку.

FastComments SSO (погледајте детаље овде) пружа вашим корисницима начин да коментаришу без потребе да се пријављују на другу платформу.

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

Променом подешавања можемо ограничити преузимање коментара осим ако захтев не долази од администратора или валидног SSO корисника.

No-Code Setup

Можемо спречити прегледање и интеракцију са нашим нитовима коментара када је SSO подешен, креирањем правила прилагођавања.

Када то урадите, потражите SSO, и наћи ћете ову опцију:

Require SSO To View Comments

Омогућите ту опцију и сачувајте правило прилагођавања.

Only Protect a Certain Domain or Page

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

На врху интерфејса за прилагођавање наћи ћете два уноса, Domain и URL ID.

Да бисте заштитили одређени домен, унесите тај домен у поље "domain".

Да бисте заштитили одређену страницу, унесите URL странице у поље "URL ID". Ако имате прилагођену интеграцију са FastComments, овде можете унети тип ID-а уместо URL-а.

Security Levels

Када захтевате SSO, треба да одлучите да ли захтевате Simple SSO или Secure SSO. Ако захтевате Simple SSO, оба су дозвољена, али ако захтевате Secure SSO онда садржај мора бити преузет са Secure SSO payload-ом хешираним вашим API кључем да би био видљив.

Опција нивоа безбедности ће се појавити када изаберете "Require SSO To View Comments".

Protection Beyond Reading

Омогућавање ове опције ће заштитити страницу или домен од коментарисања осим ако корисник није пријављен преко SSO.

Напомене

Сви корисници који су креирали коментаре пре ваше SSO интеграције неће моћи да их виде, осим ако се не пријаве путем ваше SSO интеграције.

По подразумевaњу, FastComments ће захтевати имејл да би се коментарисало. Не мора бити важећи имејл, међутим док корисник не кликне на линк послат њему, његов коментар ће приказивати ознаку „Непотврђени коментар“.

Међутим, можемо уклонити захтев за имејлом. Поље за унос имејла ће и даље бити видљиво, али више неће бити обавезно.

Ово се може конфигурисати преко интерфејса за прилагођавање виџета:

Enabling Anonymous Comments

FastComments може бити подешен да уклања непотврђене коментаре након жељеног броја дана. Ово помаже у борби против спама.

По подразумевању, то није омогућено.

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

Moderation Settings

Када корисници коментаришу, а нису пријављени, затражиће им се да наведу своју е-пошту.

Ово ће креирати "неверификовану сесију" за тог корисника, и затражићемо од њега да потврди ту сесију путем е-поште.

За неке сајтове или апликације пожељно је да кориснику не буде тражена е-пошта приликом коментарисања или гласања.

Омогућавање анонимног коментарисања чини поље за унос е-поште опционалним. Међутим, можемо га у потпуности онемогућити. Прво омогућите анонимно коментарисање, и онда ће се појавити опција да онемогућите поља за унос е-поште.

Disable Email Inputs

Када је ово укључено, поља за е-пошту уопште се неће приказивати у свим нашим производима за коментарисање.

Имајте на уму да ће са овом конфигурацијом сви коментари бити неверификовани осим ако корисник не креира налог и не пријави се на https://fastcomments.com.

Можда ћете пожелети да размислите о искључивању ознаке 'неверификовано'.

По подразумеваној поставци, FastComments ће приказати ознаку „Неовјерени коментар“ за коментаре који су остављени за корисника који има неовјерену сесију прегледача. Прочитајте више о неовјереном коментарисању овде.

Disable The Unverified Label

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

Поред тога, ова функција се може користити, без писања кода, у Customization UI:

Disable The Unverified Label

Када корисници покушају да гласају за коментар, а нису пријављени, од њих ће бити затражено да наведу своје корисничко име и имејл.

Можемо уклонити овај захтев, омогућавајући свакоме да гласа за коментар без остављања икаквих података.

Allow Anonymous Votes

Када корисници коментаришу или гласају, а нису пријављени, затражиће им се адреса е-поште и корисничко име.

У случају анонимног коментарисања, понекад је пожељно дефинисати подразумевано корисничко име како би се олакшало коментарисање. То се може подесити у интерфејсу за прилагођавање. Прво мора бити омогућено анонимно коментарисање.

Setting The Default Username

По подразумеваној поставци, FastComments ће приказати видгет за коментаре у локалу који одређује систем и прегледач корисника.

Када корисник остави коментар или се пријави, ажурирамо њихов последњи коришћени локал и користимо га и за слање е-порука.

Ово утиче на начин на који је видгет за коментаре преведен за корисника. Локал се састоји од језика и региона корисника, па ће конфигурисање локала обично променити језик који се користи за приказ текста кориснику.

Преко корисничког интерфејса

Ово се може дефинисати помоћу интерфејса за прилагођавање видгета. Погледајте опцију "Locale / Language":

Changing The Locale / Language

Помоћу кода

Ово може бити замењено жељеним локалом.

Manually Defining the User's Locale

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

Подржани језици и кодови локала

Овде можете пронаћи комплетну листу подржаних језика и одговарајућих кодова локала.

Напомена о SSO

Ако користите SSO, можда ћете желети да проследите локал корисника у user object, тако да су е-поруке и друге ствари правилно локализоване за њих.

По подразумеву, FastComments не ограничава језике који се користе за коментарисање.

Може бити пожељно ограничити језике које заједница користи.

Ово се може конфигурисати без кода, на страници за прилагођавање виџета:

Allowed Languages

Систем ће анализирати њихов коментар и утврдити његов језик, а затим га упоредити са дозвољеном листом.

Ако је коментар написан на језику који није дозвољен, приказује се локализована порука о грешци.

Коментарисање се може закључати тако да се не могу остављати нови коментари или гласови подешавањем флага readonly на true.

Коментари такође неће моћи да буду уређивани или избрисани.

Making The Comment Thread Readonly

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

Ово се може прилагодити без кода, на страници за прилагођавање виџета, за цео домен или страницу:

Making The Comment Thread Readonly

Ажурирање!

Од новембра 2022. године, теме могу бити закључане или откључане у реалном времену од стране администратора и модератора преко менија са три тачке изнад поља за одговор.

Ово ће спречити нове коментаре, али ће и даље дозвољавати гласање и омогућити корисницима да по жељи обришу своје коментаре, док readonly не дозвољава ове функције.

Ово одговара пољу isClosed у Page API-ју.

По подразумеву, FastComments дозвољава повезивање на било који спољашњи сајт.

Ово се може ограничити на жељену листу сајтова или домена. Покушај слања линка ка сајту или домену, који није на дефинисаној листи, изазваће приказивање грешке кориснику.

Ова валидација важи само за Comment Widget и API. Увози нису погођени.

Ово се ради без кода, на страници за прилагођавање виџета:

Restrict External Link Domains

По подразумеваној поставци, FastComments ће тражити од корисника само њихов коментар, корисничко име и е-пошту.

Међутим, у неким ситуацијама можда ћете пожелети да корисник остави везу до свог блога или веб-сајта.

Можемо омогућити приказ додатног поља за унос у које ће корисник оставити URL свог сајта тако што ћемо поставити флаг enableCommenterLinks на true:

Enabling Commenter Links

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

Када је тај URL наведен, налог корисника ће бити ажуриран и сва њихова корисничка имена на свим претходним и будућим коментарима ће водити на тај URL.

Ово се може прилагодити без кода, на страници за прилагођавање виџета:

Enabling Commenter Links

Списак ИД-ова генерисаних са странице Групе за модерацију.

Када је наведено, коментари остављени користећи ту конфигурацију имаће исти скуп moderationGroupIds.

Ако Moderator има дефинисану једну или више Групе за модерацију, они ће видети само коментаре на страници Moderate Comments који су повезани са њиховом групом(ама).

Specify Moderation Groups

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

За аутентификацију, FastComments зависи од тога да су колачићи трећих страна омогућени у вашем прегледачу. Без њих, корисници ће увек морати да оставе своју е-пошту да би коментарисали (осим ако поље за унос е-поште није скривено), и њихови коментари ће по подразумеваној вредности увек бити означени као непотврђени.

Да бисте то заобишли, можете омогућити заобилажење колачића трећих страна.

Када је ова поставка омогућена, појавиће се мали искачући прозор који приказује поруку да се корисник пријављује. Овај искачући прозор се приказује кад год корисник интерагује са видгетом за коментаре; на пример, ако остави коментар.

Ово можемо урадити у коду подешавањем флага enableThirdPartyCookieBypass на true:

Enabling Third-Party Cookie Bypass

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

Такође можемо ово подесити преко корисничког интерфејса за прилагођавање видгета, у одељку Enable Third-Party Cookie Popup:

Enabling Third-Party Cookie Bypass

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

You can restrict this in the following ways:

• Уместо тога, анонимизујте обрисани коментар (подесите име и текст на [deleted] или прилагођену вредност).
• Не дозвољавајте брисање коментара када постоје одговори. Приказује се прилагодљива порука о грешци.
• Ограничите брисање коментара који имају одговоре само на администраторе и модераторе.

This can be configured via the Comment Thread Deletion section in the Widget Customization UI.

Customize Delete Behavior for Replies

Po podrazumevanoj postavci, FastComments prikazuje bedževe korisnika samo pored njihovih komentara u okviru niti komentara.

Međutim, možemo prikazati bedževe korisnika pored njihovog imena iznad forme za komentar omogućavanjem ove funkcije na stranici za prilagođavanje widgeta:

Show Badges in Top Bar Option

Ovo će prikazati bedževe korisnika pored njihovog imena u gornjoj traci, čineći njihova postignuća i status istaknutijim dok pišu komentar.

Imajte na umu da ova funkcija mora biti omogućena u interfejsu za prilagođavanje widgeta da bi radila. Po želji možete postaviti zastavicu showBadgesInTopBar na false u konfiguraciji koda da biste je selektivno onemogućili čak i kada je uključena na nivou servera:

Disable Show Badges in Top Bar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10