Prilagođavanja i konfiguracija

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

У случају интеграција трећих страна, као што је WordPress, наш додатак ће обично користити идентификатор који представља тренутну информацију која се приказује као URL ID, на пример 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 у страници за прилагођавање виџета

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

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

Загонетке

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

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

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

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

Област уноса прилагођеног CSS-а

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

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

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

Prosleđivanje prilagođenog CSS-a

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-а. Међутим, за већину величина оптерећења, то није приметно.
4. Уобичајена оптимизација је минификување CSS-а да се смањи његова величина преко мреже, али са овим приступом мораћете то сами да урадите.
5. Ваш прилагођени CSS неће бити тестирани када направимо измене.

Екстерни CSS фајлови

Можете рећи виџету да преузме екстерни фајл користећи @import!

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

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

У коду – није препоручено

Можете такође учитати екстерни CSS фајл преко својства customCSS:

Eksterni CSS fajl

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 неће бити тестирани од стране нас ако ово урадите.

Стиловање модала корисничког профила

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

Уназадна компатибилност

У 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, сав текст у виџету за коментаре је прилагодљив.

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

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

Прилагођени текст

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 локалу и навести замену.

Прилагођени текст

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

Када корисник први пут коментарише помоћу FastComments, покушаћемо да преузмемо његову аватару са https://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

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

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

Имајте на уму да је дефинисање аватаре за конкретног корисника, као што је случај са 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

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

Скривање аватара

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

Све подразумевано стилизовање може се уклонити постављањем параметра 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

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

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

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

Ово се може подесити тако да корисник мора кликнути „Прикажи одговоре“ на коментарима првог нивоа да би видео дете коментаре.

Сакриј одговоре на коментаре првог нивоа

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

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

Сакриј одговоре

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

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

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

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

Омогућавање WYSIWYG уређивања

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 Advanced Formatting" option.

Омогући WYSIWYG

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

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

Onemogućavanje alatne trake

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

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

Onemogućavanje alatne trake

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

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

Onemogući blokiranje

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

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

Onemogući blokiranje

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

Може бити потребно или пожељно користити апсолутне датуме, у ком случају постављате овај параметар на 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

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

Користи апсолутне датуме

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

Може бити потребно или жељено да се задржи овај релативни формат датума, али исто тако прикаже пуни датум поред њега, у ком случају постављате овај параметар на 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 "absoluteAndRelativeDates": true

8}];

9</script>

10

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

Користи и апсолутне и релативне датуме

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

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

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

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

Навођење HTML заглавља

По подразумеваној поставци, FastComments ће приказивати линкове на следећи начин: https://exmaple.com – где URL линка постаје кликљиви HTML anchor елемент.

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

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

Prikaži linkove kao tekst

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

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

Кликните за приказ коментара

Дугме користи различит преведени текст у зависности од тога да ли су коментари тренутно приказани или не. Ако су коментари скривени, користи translations.SHOW_COMMENTS_BUTTON_TEXT. Ако коментари су приказани, користи translations.HIDE_COMMENTS_BUTTON_TEXT. Преводи могу садржати текст [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 "useShowCommentsToggle": true

8}];

9</script>

10

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

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

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

Омогући Кликните за приказ коментара

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

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

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

Онемогућавање аутоматског креирања HashTag

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

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

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

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

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

Onemogući zvono obaveštenja

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

Ово се такође може урадити без кода. На страници за прилагођавање виџета, погледајте одељак „Onemogući zvono obaveštenja“.

Onemogući zvono obaveštenja

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

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

Онемогући профиле

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

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

Онемогући профиле

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

Међутим, можемо онемогућити овај језичак:

Disable Profile 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 "disableProfileComments": true

8}];

9</script>

10

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

Онемогућавање коментара на профилу

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

Међутим, можемо онемогућити овај језичак:

Онемогући директне поруке профила

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 "disableProfileDirectMessages": true

8}];

9</script>

10

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

Онемогући директне поруке профила

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

Onemogući poruku o uspehu

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

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

Onemogući poruku o uspehu

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

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

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

Подеси 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? није означено.

Подешавање Gif Rating

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

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

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

Подешавање нивоа модерације садржаја слика

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

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

Користимо заставицу voteStyle на следећи начин:

Omogući dugme srca

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

Топло вам препоручујемо да ово урадите без кода, јер тако такође омогућавате серверску валидацију. На страници за прилагођавање виџета, погледајте одељак „Vote Style“.

Промени стил гласања

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

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

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

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

Онемогући брисање коментара

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

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

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

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

Онемогући уређивање коментара

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

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

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

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

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

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

Прилагођене величине страница

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

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

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

Међутим, можда је потребно маскирати или приказати име корисника на другачији начин. На пример, ако је име корисника Аллен Рекс, можда желите да прикажете само „Аллен Р.“.

Ово се може урадити без кода у UI-ју за прилагођавање виџета, под подешавањем названим Commenter Name Format:

Промени Формат Име

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

• Capitalize (display example user as Example User)
• Last Initial (display Example User as Example U.)
• All Initials (display Example User as E. U.)
• Show "Anonymous"

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

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

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

Onemogućavanje otpremanja slika

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

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

Onemogućavanje otpremanja slika

By default FastComments does not allow iframes in comments. When you enable media embeds, commenters can paste the embed code (the <iframe> snippet) from trusted providers like YouTube, Vimeo, SoundCloud, and Spotify, and it will render inline in the comment.

For security, this is not a client-side widget config flag. It is a server-side setting, validated when each comment is saved, so it cannot be turned on from the page. Only iframes pointing at a built-in list of trusted providers are allowed. Any other iframe is removed.

This is done without code, on the widget customization page:

Дозволи медијска уграђивања

Додавање сопствених провајдера

If you want to allow embeds from a provider that is not on the built-in trusted list, add its hostname in the "Additional Embed Domains" field on the same page. These hostnames are allowed in addition to the built-in providers. Matching is exact, so include the full hostname (for example, player.example.com). Anything you do not list stays blocked.

Both the plain comment box and the WYSIWYG editor support pasting an embed. In the WYSIWYG editor the embed is inserted as a removable block.

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

Међутим, можемо га укључити постављањем заставице 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

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

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

Можемо омогућити подршку за спојлере постављањем enableSpoilers заставице на 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 "enableSpoilers": true

8}];

9</script>

10

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

Омогући спојлере

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

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

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

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

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

Ово можемо омогућити постављањем заставице enableViewCounts на 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 "enableViewCounts": true

8}];

9</script>

10

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

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

Тракујемо ID корисника* који је прегледао коментар једну недељу, тако да ако поново прегледате коментар унутар те недеље, број се не повећава. Ако прегледате коментар поново након што недеља прође, број ће се поново повећати.

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

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

Међутим, подразумевано ће ти нови коментари бити приказани испод динамички приказаног дугмета са текстом сличним „Show 2 New Comments“.

Ако су нови коментари одговори директно на страницу, дугме ће се појавити на врху теме коментара. Ако су одговори на одређени коментар, дугме ће се појавити испод тог коментара.

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

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

Зато је назив заставице која омогућава ту функцију: showLiveRightAway.

Можемо је укључити на следећи начин:

Show Live Comments Right Away

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

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

Прикажи живе коментаре одмах

Подразумевано, 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 ће сортирати коментаре према смеру сортирања „Најрелевантније“.

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

Корисник затим може променити смер сортирања на „Најстарије“ или „Најновије прво“ у корисничком интерфејсу виџета за коментаре.

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

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

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“.

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

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

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: "Најновије"
• NF: "Најновије прво"
• OF: "Најстарије прво"

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

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

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

Подразумевано је област за унос коментара пре нити коментара. Међутим, постављањем овог параметра конфигурације на 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 "inputAfterComments": true

8}];

9</script>

10

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

Премештање поља за одговор на дно

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

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

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

Ограничи дужину коментара

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

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

Ограничи дужину коментара

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

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

Омогућавамо заставицу useSingleLineCommentInput на следећи начин:

Омогући унос коментара у једној линији

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

Ово се такође може урадити без кода. На страници за прилагођавање widget-а, погледајте одељак „Enable Single-Line Comment Input“.

Омогући унос коментара у једној линији

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

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

Ово се прати по ID-ју корисника, анонимном ID-ју и IP адреси (хеширано).

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

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

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

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

Када је омогућено:

• Anonymous users will see a TOS checkbox every time they comment
• Authenticated users will see the checkbox only on their first comment, or when you update your TOS

Configuration

Navigate to the widget customization page and enable the "Require Terms of Service acceptance" checkbox. Once enabled, you'll see the following options:

Опције услова коришћења

• TOS Text Mode: By default, the checkbox displays "I agree to the Terms of Service and Privacy Policy" with links to both documents. Select "Customize text per locale" to provide your own text for each language.
• TOS Last Updated Date: When you update your Terms of Service, set this date. Users who accepted before this date will be required to accept again.

How It Works

• The TOS acceptance timestamp is stored per-user and per-comment
• When a user accepts the TOS, the date is recorded on their user profile (per-tenant)
• If you set a "Last Updated" date that is after the user's acceptance date, they will need to re-accept
• For anonymous users who cannot be tracked, the checkbox appears on every comment submission

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

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

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

Secure SSO ток

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

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

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

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

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

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

Документација високог нивоа за API видгета за коментаре може се наћи овде.

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

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

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

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

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": 1790645990543.0,

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

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

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

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

The User Object:

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

Copy

1

2interface SSOUser {

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

4 id: string;

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

6 email: string;

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

8 username: string;

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

10 avatar?: string;

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

12 optedInNotifications?: boolean;

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

14 optedInSubscriptionNotifications?: boolean;

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

16 displayLabel?: string;

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

18 displayName?: string;

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

20 websiteUrl?: string;

21 /** Опционо. До 100 група по кориснику. ИД групе не сме бити дужи од 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 badgeConfig?: {

35 /** Низ глобалних ID-ева значки које треба доделити. Ограничено на 30 значки. Редослед се поштује. **/

36 badgeIds: string[];

37 /** Низ ID-ева значки ограничених на тренутну страницу (urlId). Приказују се само на додељеној страници. **/

38 pageBadgeIds?: string[];

39 /** Ако је true, замењује постојеће приказане значке. Глобалне и странице-ограничене значке се понаособ преуписују. **/

40 override?: boolean;

41 /** Ако је true, ажурира приказ значки из конфигурације tenant-а. **/

42 update?: boolean;

43 };

44}

45

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

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

Обавештења

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

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

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

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

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

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

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

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

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

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

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

Међутим, ово само по себи не обезбеђује безбедност ваших нити коментара, јер су подаци о коментарима подразумевано јавно доступни – свако ко може да види страницу може да види и коментаре.

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

No-Code Setup

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

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

Захтевај SSO за преглед коментара

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

Заштити само одређени домен или страницу

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

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

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

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

Нивои безбедности

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

Опција нивоа безбедности ће се појавити када изаберете „Захтевај SSO за преглед коментара“.

Заштита поред читања

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

Замке

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

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

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

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

Омогућавање анонимних коментара

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

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

Подразумевано, то не ради.

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

Подешавања модерације

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

Ово ће за тог корисника креирати „непотврђену сесију“, и затражићемо од њих да потврде ту сесију путем е‑поште.

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

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

Онемогући уносе е‑поште

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

Имајте на уму да ће, са овом конфигурацијом, сви коментари бити непотврђени осим ако корисник не направи налог и не пријави се на 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

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

Онемогући ознаку Неоверификованог коментара

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

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

Омогући анонимно гласање

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

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

Подешавање подразумеваног корисничког имена

Дељење подразумеваног корисничког имена

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

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

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

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

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

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

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

Аутоматско генерисање корисничких имена

Како се понаша

• Свако генерисано име је јединствено. Проверава се у односу на постојеће налоге и резервише за сесију прегледача тог посетилаца, тако да два посетилаца не добију исто име.
• Име се генерише само за посетиоце који још немају име. Пријављени корисници, SSO корисници и посетиоци који су већ коментарисали задржавају своје постојеће име.
• Функционише са или без анонимног коментарисања. Када је анонимно коментарисање искључено, посетилац и даље уноси своју е‑пошту, али више не мора да размишља о корисничком имену.
• Повратни посетилац који уноси е‑пошту коју је раније користио повезује се са постојећим налогом и задржава име на том налогу.
• Ако је такође подешено подразумевано корисничко име, генерисано име има предност.

Po podrazumevanju, FastComments će prikazati vidžet za komentare u lokalizaciji određenoј sistemom i pregledačem korisnika.

Kada korisnik komentariše ili se prijavi, ažuriramo njegovu poslednju korišćenu lokalizaciju i koristimo je i za slanje e‑mailova.

Ovo utiče na to kako je vidžet za komentarisanje preveden za korisnika. Lokalizacija se sastoji od jezika i regiona korisnika, tako da podešavanje lokalizacije obično menja jezik koji se prikazuje korisniku.

Preko UI-ja

Ovo se može definisati putem UI‑ja za prilagođavanje vidžeta. Pogledajte opciju „Locale / Language“:

Promena lokalizacije / jezika

Preko koda

Ovo se može prepisati željenom lokalizacijom.

Ručno definisanje lokalizacije korisnika

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

Podržani jezici i kodovi lokalizacije

Možete pronaći kompletnu listu podržanih jezika i odgovarajućih kodova lokalizacije ovde.

Napomena o SSO

Ako koristite SSO, možda ćete želeti da prosledite lokalizaciju korisnika u objektu korisnika, kako bi e‑mailovi i druge stvari bile pravilno lokalizovane za njih.

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

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

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

Дозвољени језици

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

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

Коментари могу бити закључани тако да се нови коментари или гласови не могу оставити постављањем заставице 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

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

Постављање теме коментара у режим само за читање

Update!

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

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

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

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

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

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

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

Ограничи спољне домене веза

Подразумевано, 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 зависи од омогућених колачића трећих страна у вашем прегледачу. Без њих, корисници ће увек морати да оставе своју е‑пошту за коментарисање (осим ако је поље за унос е‑поште скривено), и њихови коментари ће увек бити приказани као непотврђени (подразумевано).

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

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

Ово можемо урадити у коду постављањем заставице enableThirdPartyCookieBypass на 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 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

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

Омогућавање заобилажења колачића трећих страна

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

Ово можете ограничити на следеће начине:

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

Ово се може подесити преко одељка Comment Thread Deletion у корисничком интерфејсу прилагођавања виџета.

Прилагодите понашање брисања за одговоре

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

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

Опција приказа значки у горњој траци

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

Напомена: ова функција мора бити омогућена у корисничком интерфејсу за прилагођавање виџета да би радила. По потреби можете поставити заставицу showBadgesInTopBar на false у вашој конфигурацији кода да бисте селективно онемогућили функцију чак и када је укључена на нивоу сервера:

Onemogući prikaz bedževa u gornjoj traci

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

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

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

Постоје три опције распореда:

• 1 - Горе: хоризонтални ред преклапајућих се аватара приказан изнад коментара.
• 2 - Лево: бочна трака са именима и индикаторима присутности приказана лево од виџета.
• 3 - Десно: иста бочна трака приказана десно од виџета.

Подесите заставицу usersListLocation да бисте омогућили функцију:

Прикажи листу корисника десно

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 "usersListLocation": 3

8}];

9</script>

10

Подразумевано листа приказује само кориснике који су тренутно онлајн. Да бисте такође укључили људе који су у прошлости коментарисали страницу (али је тренутно не прегледају), поставите usersListIncludeOffline на 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 "usersListLocation": 3,

8 "usersListIncludeOffline": true

9}];

10</script>

11

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

Корисници са приватним профилима се приказују са генеричким аватаром и ознаком „Приватни профил“ како би број остао тачан без откривања идентитета.

Ово се такође може подесити без кода. На страници за прилагођавање виџета, погледајте опцију „Локација листе корисника“. Када је локација постављена на било шта осим „Искључено“, појављује се поље за потврду „Укључи претходне коментаторе“ испод њега.

Подешавања листе корисника

За последњих 500 живих корисника, листа може бити за до 30 секунди застарела.