Možda ćete primijetiti da se widget za komentare može koristiti sa Tenant ID-jem "demo", na primjer:

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

Ovo služi samo za isprobavanje i igranje sa widgetom za komentare. U produkciji biste proslijedili svoj Tenant ID na sljedeći način:

Defining Your 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

Vaš Tenant ID već je primijenjen u isječku koda widgeta za komentare u vašem nalogu.

Također možete pronaći svoj Tenant ID i upravljati svojim API ključevima na stranici za API vjerodajnice.

Od ovog trenutka nadalje, ako ste prijavljeni u FastComments, primjeri koda će koristiti vaš stvarni Tenant ID (ako ste prijavljeni na https://fastcomments.com).

When rendering a comment thread, or leaving a comment, FastComments needs to know what page, or article, or product those comments belong to.

Za to koristimo nešto što zovemo "URL ID". To može biti identifikator, poput stringa ili broja, ili URL.

By default, if you do not specify the urlId, it will become the page URL. We will take the current page URL, and clean it to remove any common marketing parameters or tracking identifiers.

U slučaju integracija trećih strana, poput WordPressa, naš plugin obično koristi identifikator koji predstavlja trenutne podatke koje se pregledaju kao the URL ID, na primjer the 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

Jedna stvar na koju ćemo često upućivati u ovom dokumentu je the Korisničko sučelje za prilagođavanje widgeta.

Ovim sučeljem možete napraviti mnoge promjene na widgetu za komentare bez korištenja koda.

When creating a customization rule, we'll often want it to apply to all pages to our site. However, in some cases we want to customize the comment widget on a particular page, either to apply custom styling, or maybe make comments for that particular page anonymous. You could also, for example, have live comments appear right away on some pages, while hiding them under notification buttons on others.

Sve je to moguće putem polja za unos URL ID na ovoj stranici, koje izgleda otprilike ovako:

URL ID Input in The Widget Customization Page

The value in this field should match the urlId parameter passed into the comment widget. If you want your customization rule to be urlId agnostic, leave this field empty or enter *.

As of 2023 the URL ID field in widget customization now also takes patterns! For example you may have */blog/* to add styling specific to your blog and */store/* to have styling specific to your store, all while using the same domain.

Zamke

1. If your page has hash parameters (like example.com#page-1) - this will become part of the URL ID, by default.
2. During migrations, for example from WordPress to Gatsby, you may have to migrate the URL ID comment values after the initial migration. For that, reach out to us.

FastComments je dizajniran da bude prilagodljiv. Sam widget za komentare radi unutar iframe-a iz sigurnosnih razloga, pa da biste primijenili prilagođeni stil morate slijediti jedan od dva pristupa.

Prvi, najlakši pristup, i onaj koji preporučujemo, je da koristite widget customization page.

Na stranici za prilagođavanje widgeta, pogledajte odjeljak "Show Advanced Options", ispod kojeg se nalazi oblast označena kao "Custom CSS":

Custom CSS Input Area

Ovaj pristup ima neke prednosti:

1. Uneseni CSS se minificira prije nego što se pošalje korisniku, a formatiranje se održava konzistentnim u uređivačkom korisničkom interfejsu.
2. Dobijate sve prednosti korisničkog interfejsa za prilagođavanje widgeta, na primjer lako prilagođavanje widgeta za komentare različito za različite sajtove.
3. Kada napravimo promjene na widgetu za komentare, vaš prilagođeni stil će biti testiran kao dio našeg procesa izdavanja.

Drugi pristup je da u konfiguraciji widgeta navedete parametar customCSS, na sljedeći način:

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

Međutim, ovo ima ograničenja:

1. Postoji ograničenje koliko custom CSS-a može biti proslijeđeno prije nego što naši serveri odbace zahtjev, zbog veličine headers.
2. Morate upravljati custom CSS-om u vašoj infrastrukturi i build sistemu. Ovo također može biti prednost, a ne nedostatak.
3. Postoji dodatni overhead slanja custom CSS-a preko mreže dvaput u ovom slučaju, jer mora biti poslan na naše servere, a zatim vraćen u sadržaju iframe-a. Međutim, za većinu veličina payloada, ovo nije primjetno.
4. Uobičajena optimizacija je minificiranje CSS-a kako bi se smanjila njegova veličina preko mreže, međutim s ovim pristupom vi ćete to morati sami obraditi.
5. Vaš custom CSS neće biti testiran kada mi napravimo promjene.

Eksterni CSS fajlovi

Možete naložiti widgetu da povuče eksterni fajl koristeći @import!

Preporučeno je staviti @import u pravilo za prilagođavanje. Na ovaj način, ako ikada budemo morali napraviti promjenu na widgetu za komentare, možemo koristiti naše alate za automatizaciju da provjerimo vašu konfiguraciju. Dakle, na primjer, kreirali biste pravilo za prilagođavanje u korisničkom interfejsu za prilagođavanje widgeta, kliknuli Advanced, i unijeli u Custom CSS:

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

U kodu - nije preporučeno

Također možete učitati eksterni CSS fajl putem svojstva 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

Međutim, imajte na umu da vaš CSS neće moći biti testiran od strane nas ako ovo uradite.

Stilizovanje modal prozora korisničkog profila

Modal prozori korisničkih profila također se mogu stilizovati pomoću custom CSS-a. Međutim, kako bi se osiguralo da se prilagođeni stil primijeni na korisničke profile, svi CSS selektori moraju biti prefiksirani sa .user-profile. Bez ovog prefiksa, prilagođeni stil će biti zanemaren za modal prozore korisničkih profila.

Na primjer:

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

Kompatibilnost unazad

U FastComments-u, znamo da naši korisnici prilagođavaju widget za komentare. To je namjerno - posljednje što želimo je da naš proizvod izazove neslaganja u dizajnu vašeg proizvoda.

Pošto je ovo važan dio našeg proizvoda, imamo build pipeline koji nam omogućava da pregledamo promjene na widgetu za komentare, po korisniku, pri svakom izdanju.

Ako uočimo manje probleme, ažurirat ćemo vaš račun kako bi naše izdanje prošlo glatko. Ako uočimo velike promjene koje bi prekinule funkcionalnost, to nam omogućava da zaustavimo izdanje.

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

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

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

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

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

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

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

Потпуни пример пребацивања тамног режима

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

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

Kada korisnik prvi put komentariše pomoću FastComments-a, pokušaćemo preuzeti njihov avatar sa http://gravatar.com/.

Međutim, ako ne pronađemo avatar, ili korisnik nikada ne postavi jedan u svom nalogu, prikazujemo statičku podrazumijevanu sliku avatara.

Da biste naveli vlastitu statičku sliku avatara, možete koristiti podešavanje defaultAvatarSrc.

Override The Default Avatar

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

Ovo se može uraditi i bez koda. Na stranici za prilagođavanje widgeta, pogledajte odjeljak "Podrazumijevani avatar".

Customizing The Default Avatar

Napomena: Definisanje avatara za određenog korisnika, kao npr. kod SSO-a, obuhvaćeno je u zasebnom odjeljku.

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

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, као у примеру:

Disabling All Default Styles

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

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

Disabling All Default Styles

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

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

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

Po zadanim postavkama, FastComments prikazuje alatnu traku pri pisanju komentara kako bi obezbijedio prečice za uređivanje teksta i učitavanje slika.

Ova alatna traka se može onemogućiti u kodu ili putem sučelja za prilagođavanje.

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

Ovo se može učiniti i bez koda. Na stranici za prilagođavanje widgeta pogledajte opciju "Onemogući alatnu traku za odgovore".

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

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

Po podrazumevanim postavkama koriste se lokalizovani relativni datumi. Na primjer, pored nedavno ostavljenog komentara možete vidjeti "pre 11 minuta".

Može biti potrebno ili poželjno zadržati ovaj relativni format datuma, ali i prikazati puni datum pored njega — u tom slučaju postavite ovaj parametar na 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

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta, u okviru Naprednih opcija. Najprije ćete morati omogućiti Apsolutne datume da biste vidjeli ovu opciju u korisničkom interfejsu.

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

Po zadanim postavkama, FastComments će prikazivati linkove ovako: https://exmaple.com - gdje URL veze postaje klikabilan HTML anchor tag.

Neke stranice možda žele ovo onemogućiti, na primjer kako bi obeshrabrile prevarante. To omogućavamo podešavanjem Comment HTML Rendering Option na Links as Text.

Ovo se može prilagoditi bez koda, na stranici za prilagođavanje widgeta, za čitav domen ili pojedinačnu stranicu:

Render Links as Text

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

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

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.

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

Ово се може омогућити без кода креирањем правила прилагођавања и омогућавањем "Click to Show Comments":

Enable Click to Show Comments

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

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

Customizing The Comment Count 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 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

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

Customizing The Comment Count Text

Kada korisnici unesu hashtagove, u obliku #someexampletag, FastComments će automatski kreirati taj HashTag i označiti ga u svom komentaru.

U nekim slučajevima poželjno je onemogućiti ovu funkciju, ili putem API-ja kontrolisati koji se hashtagovi mogu koristiti.

Da biste to uradili, jednostavno omogućite Disable Automatic #hashtag Creation putem sučelja za prilagođavanje widgeta.

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

Po zadanim postavkama, FastComments će prikazati profil korisnika kada kliknete na njihov avatar.

Međutim, ovu funkcionalnost možemo onemogućiti:

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

Ovo se može uraditi i bez koda. Na stranici za prilagođavanje widgeta, pogledajte odjeljak "Onemogući profile".

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

Po zadanom, FastComments prikazuje opcije za glasanje kao strelice gore i dolje, omogućavajući korisnicima da komentaru daju pozitivan ili negativan glas.

Međutim, moguće je promijeniti stil trake za glasanje. Trenutne opcije su zadane tipke Gore/Dolje, ili korištenje mehanizma glasanja u obliku srca.

Koristimo zastavicu voteStyle na sljedeći način:

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

Toplo preporučujemo da to uradite bez koda, jer tako omogućavate i provjere na strani servera. Na stranici za prilagođavanje widgeta, pogledajte odjeljak "Stil glasanja".

Change Voting Style

Glasanje se također može onemogućiti, pogledajte Disable Voting iznad opcija stila.

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

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

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

Disable Comment Deleting

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

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

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

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

Disable Comment Editing

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

Podrazumevano, veličina stranice u FastComments je 30. Ovo uključuje odgovore u nitima.

Veličina stranice se može prilagoditi u Sučelje za konfiguraciju widgeta u različitim veličinama u rasponu od 10 do 200.

Imajte na umu da promjena veličine stranice zahtijeva preračunavanje svih komentarskih niti na vašem nalogu. To može potrajati nekoliko minuta.

Ovo se ne može konfigurirati u klijentskom widgetu jer se stranice izračunavaju na serverskoj strani.

Primjer konfiguracije je prikazan u nastavku:

Custom Page Sizes

Veličine stranica se mogu prilagoditi globalno, po domenu ili po stranici, kreiranjem različitih pravila za prilagođavanje.

Ovo će utjecati na sve klijente, integracije i okvire koje možda koristite za prikaz komentara putem naše platforme.

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

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

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

Change Name Format

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

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

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

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

Po zadanim postavkama FastComments omogućava otpremanje slika. Ovo se može onemogućiti postavljanjem zastavice noImageUploads na 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

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

Disabling Image Uploads

Prema zadanim postavkama, u widgetu za komentare nije prikazano polje za pretragu.

Međutim, ovu opciju možemo uključiti postavljanjem zastavice enableSearch na true:

Enabling Search

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

Ovo se takođe može uraditi bez koda. Na stranici za prilagođavanje widgeta pogledajte opciju "Enable Search Box".

Enable Search Box

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

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

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

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

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

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

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

За неке случајеве употребе, као што су живе лицитације или онлајн догађаји, ово није жељено понашање - можда ћете желети да виџет за коментаре буде више као "chat" кутија где се нови коментари "show right away".

Отуд и назив флага који омогућава ту функцију: 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

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

Show Live Comments Right Away

По подразумјевању, 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".

Disable Live Commenting

Po defaultu, FastComments će sortirati komentare prema opciji sortiranja "Najrelevantnije".

Sortiranje "Najrelevantnije" uzima u obzir vrijeme kada je komentar ostavljen i broj glasova pri sortiranju.

Korisnik potom može promijeniti smjer sortiranja na "Najstarije prvo" ili "Najnovije prvo" u komentarskom widgetu UI.

Međutim, zadanu vrijednost možemo promijeniti na bilo koju od ove tri. Na primjer, ako želite prikazati najstarije komentare prvo:

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

Postavili smo vrijednost defaultSortDirection na "OF" da postavimo smjer na "OF".

Za smjer sortiranja "Najnovije prvo", uradili bismo sljedeće:

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

Dozvoljene vrijednosti za defaultSortDirection su:

• MR: "Najnovije"
• NF: "Najnovije prvo"
• OF: "Najstarije prvo"

Ovo se može uraditi i bez koda. Na stranici za prilagođavanje widgeta, pogledajte sekciju "Podrazumijevani smjer sortiranja".

Changing The Default Sort Direction

Imajte na umu da su komentari na svakoj stranici za svaki smjer sortiranja prethodno izračunati, tako da sve opcije sortiranja imaju iste performanse.

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

Enable Single-Line Comment Input

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

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

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

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

Limiting Comment Volume Per User

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• userDataJSONBase64: Подаци корисника у JSON формату, који су потом Base64 кодирани.
• verificationHash: HMAC-SHA256 хеш направљен од UNIX_TIME_MILLIS + userDataJSONBase64.
• 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": 1768890094125,

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

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

13 }

14}];

15</script>

16

Објекат корисника

Објекат корисника садржи сљедећу шему:

Објекат корисника

Copy

1

2interface SSOUser {

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

4 id: string;

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

6 email: string;

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

8 username: string;

9 /** Опционо. Максимум 3k знакова за URL-ове. Подразумевано се узима из gravatar-а на основу имејла. Подржава Base64 кодиране слике, у којем случају лимит је 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 група по кориснику. ИД групе не смије бити дужи од 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 (детаљи овде) пружа вашим корисницима начин да коментаришу без потребе да се пријављују на другу платформу.

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

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

Постављање без кода

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

When doing so, search for SSO, and you will find this option:

Require SSO To View Comments

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

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

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

На врху UI за прилагођавање, наћи ћемо два поља: Domain и URL ID.

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

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

Нивои сигурности

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

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

Заштита изван читања

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

Замке

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

По подразумевању, FastComments ће захтевати адресу е-поште за коментарисање. Не мора бити важећа адреса е-поште, међутим док корисник не кликне на везу послату њему, њихов коментар ће приказати ознаку "Неверификован коментар".

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

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

Enabling Anonymous Comments

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

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

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

Moderation Settings

Kada korisnici komentarišu, a nisu prijavljeni, zatražiće im se da navedu svoju email adresu.

To će za tog korisnika kreirati "unverified session", i tražićemo od njih da potvrde tu sesiju putem emaila.

Za neke sajtove ili aplikacije poželjno je ne tražiti email od korisnika prilikom komentarisanja ili glasanja.

Omogućavanje anonimnog komentarisanja čini polje za unos emaila opcionalnim. Međutim, možemo ga potpuno onemogućiti. Prvo omogućite anonimno komentarisanje, i tada će se pojaviti opcija za onemogućavanje polja za unos emaila.

Disable Email Inputs

Sa ovim uključenim, polja za email uopće se neće prikazivati u svim našim proizvodima za komentarisanje.

Imajte na umu da će, sa ovom konfiguracijom, svi komentari biti nepotvrđeni osim ako korisnik ne napravi nalog i ne prijavi se na https://fastcomments.com.

Možda ćete htjeti razmotriti onemogućavanje oznake 'nepotvrđeno'.

Према подразумеваним поставкама, FastComments ће приказати ознаку "Unverified Comment" за коментаре које је оставио корисник који има непотврђену сесију прегледача. Прочитајте више о непотврђеном коментарисању here.

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

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

Disable The Unverified Label

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

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

Allow Anonymous Votes

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

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

Setting The Default Username

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

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

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

Кроз кориснички интерфејс

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

Промена локала / језика

Преко кода

Ово се може замијенити жељеним локалом.

Ручно дефинисање корисниковог локала

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

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

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

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

Allowed Languages

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

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

Komentarisanje se može zaključati tako da se ne mogu ostaviti novi komentari ili glasovi postavljanjem zastavice readonly na true.

Komentari takođe neće moći biti uređivani ili obrisani.

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

Ovo se može prilagoditi bez koda, na stranici za prilagođavanje widgeta, za čitav domen ili stranicu:

Making The Comment Thread Readonly

Ažuriranje!

Od novembra 2022., teme se mogu zaključavati ili otključavati uživo od strane administratora i moderatora putem menija s tri tačkice iznad oblasti za odgovor.

To će spriječiti nove komentare, ali će i dalje dozvoliti glasanje i omogućiti korisnicima da po potrebi obrišu svoje komentare, dok readonly to ne dozvoljava.

Ovo odgovara polju isClosed u 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

Po defaultu, korisnici mogu obrisati svoje komentare. Takođe, brisanje njihovog komentara automatski briše sve podređene i privremene komentare u niti. Ovo ponašanje je takođe uživo.

You can restrict this in the following ways:

• Umjesto toga, anonimizirajte obrisani komentar (postavite ime i tekst na [deleted] ili prilagođenu vrijednost).
• Ne dozvoljavajte brisanje komentara kada postoje odgovori. Prikazuje se prilagodljiva poruka o grešci.
• Ograničite brisanje komentara sa odgovorima samo na administratore i moderatore.

Ovo se može konfigurirati putem odjeljka Comment Thread Deletion u Widget Customization UI.

Customize Delete Behavior for Replies

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

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

Show Badges in Top Bar Option

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

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

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