Прилагођавања и конфигурација

Прилагођавања и конфигурација

Контекст

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

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

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

Примери кода ће користити нашу vanilla JavaScript библиотеку, међутим опције конфигурације имају идентична имена у свим верзијама коментарског видгета (React, Vue и др.).

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

Идентификација вашег налога

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

Демо Tenant ID

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo"
}];
</script>

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "aKa2Z4Q="
}];
</script>

Ваш 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

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "urlId": "https://example.com/page"
}];
</script>

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

Ово сучеље се може користити за многе измене виџета за коментаре без потребе за кодом.

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

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

Унос URL ID у страници за прилагођавање виџета

External Link

Поље URL ID које се користи за ограничење правила прилагођавања на једну страницу, или на шаблон као што је */blog/*

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

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

Загонетке

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

Приказ истих коментара на различитим страницама

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

The Same Comments on Multiple Pages

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "urlId": "https://example.com/source-page"
}];
</script>

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

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

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

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

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

External Link

Уређивач прилагођеног CSS-а испод Прикажи напредне опције на страници за прилагођавање виџета

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

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

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

Prosleđivanje prilagođenog CSS-a

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": "button { background: red; }"
}];
</script>

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

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

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

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

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

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

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

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

Eksterni CSS fajl

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": "@import url(https://example.com/styles.css);"
}];
</script>

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

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

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

На пример:

CSS за кориснички профил

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": ".user-profile .profile-name { color: blue; }"
}];
</script>

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

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

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

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

Прилагођени фонтови

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

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

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

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

Како дефинисати фонт

Да бисте заменили фонт, препоручујемо да дефинишете ваш CSS користећи селекторе .fast-comments, textarea. На пример:

Пример прилагођеног спољног фонта

Copy

Copy

External Link

@import url('https://fonts.googleapis.com/css2?family=Roboto:wght@300&display=swap');
.fast-comments, textarea {
    font-family: 'Roboto', sans-serif;
}

Уклањање бренда

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

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

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

Подршка за тамне позадине (тамни режим)

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

Када се открије тамни режим, FastComments ће променити црни текст на белој позадини у бели текст на црној позадини. И слике ће се такође променити.

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

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

Force Dark Background Mode

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "hasDarkBackground": true
}];
</script>

Укључивање/искључивање тамног режима

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

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

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

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

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

Copy

Copy

External Link

<script src="https://fastcomments.com/js/embed-v2.min.js"></script>
<button id="toggle-dark-mode">Toggle Dark Mode</button>
<div id="fastcomments-widget"></div>
<script>
    (function() {
        const button = document.getElementById('toggle-dark-mode');
        const config = {
            tenantId: 'demo',
            hasDarkBackground: false
        };
        const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);
        button.addEventListener('click', function() {
            config.hasDarkBackground = !config.hasDarkBackground;
            if (config.hasDarkBackground) {
                document.body.classList.add('dark');
            } else {
                document.body.classList.remove('dark');
            }
            instance.update(config);
        });
    })();
</script>
<style>
    body.dark {
        background: #000;
        color: #fff;
    }
</style>

Преписивање текста

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

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "translations": {
        "SUBMIT_REPLY": "Reply"
    }
}];
</script>

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

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

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

External Link

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

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

Ово покрива текст самог виџета. Да преведете коментаре које пишу ваши посетиоци, погледајте Comment Translation.

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

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

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultAvatarSrc": "https://example.com/some-image.png"
}];
</script>

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

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

External Link

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

Искључивање аватара

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

Hiding Avatars

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "hideAvatars": true
}];
</script>

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

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

External Link

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

Искључивање свих подразумеваних стилова

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noStyles": true
}];
</script>

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

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

External Link

Потврдни оквир за онемогућавање свих подразумеваних стилова омогућен у Напредним опцијама на страници за прилагођавање виџета

Повезивање коментара са страницама

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

Ако URL ID није увек прави идентификатор, онда морамо да сачувамо URL негде друго. Зато постоји својство "url", које је дефинисано на следећи начин.

Defining a Custom URL

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "url": "https://example.com/article-5"
}];
</script>

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

Defining Custom URL and URL IDs together

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "url": "https://example.com/article-5",
    "urlId": "article-5"
}];
</script>

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

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

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "collapseReplies": true
}];
</script>

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

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

External Link

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

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

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

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

Омогући WYSIWYG

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableWYSIWYG": true
}];
</script>

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

Омогући WYSIWYG

External Link

Страница за прилагођавање виџета са означеним пољетом Enable Advanced Formatting за укључивање WYSIWYG уређивача

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

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

Onemogućavanje alatne trake

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableToolbar": true
}];
</script>

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

Onemogućavanje alatne trake

External Link

Страница за прилагођавање виџета са пољетом „Disable The Reply Toolbar“ означеним за уклањање пречица за форматирање

Искључивање блокирања

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

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

Onemogući blokiranje

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableBlocking": true
}];
</script>

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

Onemogući blokiranje

External Link

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

Одређивање које странице приказати

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

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

Specifying The Page to Render

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "startingPage": 1
}];
</script>

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

Пребацивање тема коментара без поновног учитавања странице

Објаснили смо како је urlId идентификатор странице или чланка на који су коментари везани.

Такође, да поновимо, ако није дефинисан, urlId ће подразумевано бити URL тренутне странице.

А шта је са SPA апликацијама, односно Single-Page-Application апликацијама, где се страница или садржај на који су коментари везани мења динамички, без поновног учитавања странице?

Angular, React, Vue, итд

Са нашим библиотекама као што су Angular и React, једноставна измена urlId својства које се прослеђује виџету изазваће освежавање виџета за коментаре. Ово можете видети у акцији за React апликацију, на пример, овде.

VanillaJS

Ако користите VanillaJS библиотеку, нешто је компликованије јер не постоји фрејмворк попут Angular или React који би обрадио data binding или пропагацију стања.

Када инстанцирате VanillaJS виџет, он враћа неке функције које се могу позвати да би се ажурирао.

Ево функционалног примера у коме мењамо hash странице и ажурирамо виџет за коментаре:

Пример промене hash вредности странице

Copy

Copy

External Link

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<button id="change-page"></button>
<div id="fastcomments-widget"></div>
<script>
    (function fastCommentsMain() {
        let config = {
            tenantId: 'demo'
        };
        let instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);
        let page = '#page-1';
        function getNextPage() {
            if (page === '#page-1') {
                return '#page-2';
            } else {
                return '#page-1';
            }
        }
        let button = document.getElementById('change-page');
        function nextPage() {
            page = getNextPage();
            button.innerText = 'Go to ' + getNextPage();
            window.location.hash = page;
            let locationString = window.location.toString();
            config.url = locationString; // Ажурирамо и url, како обавештења могу да воде ка правој страници
            config.urlId = locationString;
            instance.update(config);
        }
        nextPage();
        button.addEventListener('click', nextPage);
    })();
</script>

Апсолутни датуми (искључивање људски читљивих временских ознака)

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

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

Use Absolute Dates

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "absoluteDates": true
}];
</script>

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

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

External Link

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

Приказ апсолутних и релативних датума

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "absoluteAndRelativeDates": true
}];
</script>

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

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

External Link

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

Додавање текста у заглављу

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

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

Specifying Header HTML

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "headerHTML": "<h1>Leave a Comment!</h1>"
}];
</script>

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

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

External Link

Област Напредних опција на страници за прилагођавање виџета где се уноси прилагођени HTML заглавља

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

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

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

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

Prikaži linkove kao tekst

External Link

Opcija za prikaz HTML komentara postavljena na Linkove kao tekst pod naprednim opcijama u prilagođavanju widgeta

Укључивање/искључивање коментара дугметом

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

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

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

External Link

Виџет за коментаре склопљен иза дугмета које приказује број коментара док читалац не кликне на њега

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "useShowCommentsToggle": true
}];
</script>

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

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

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

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

External Link

Поље за потврду „Кликните за приказ коментара“ означено у правилу прилагођавања на страници за прилагођавање виџета

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

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

Може бити замењен било којим текстом, а вредност [count] биће замењена вредношћу броја, прилагођеном кориснику.

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "commentCountFormat": "There are [count] comments."
}];
</script>

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

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

External Link

Поље за текст броја коментара на страници за прилагођавање виџета, где се [count] замењује са тренутним укупним бројем

Искључивање преусмеравања слика

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

Disable Image Redirect

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableImageRedirect": true
}];
</script>

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

Искључивање аутоматског прављења хештегова

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

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

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

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

External Link

Опција за онемогућавање аутоматског креирања #hashtag активирана у корисничком интерфејсу за прилагођавање виџета

Искључивање звона за обавештења

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

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

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

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

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

Onemogući zvono obaveštenja

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableNotificationBell": true
}];
</script>

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

Onemogući zvono obaveštenja

External Link

Страница за прилагођавање виџета са означеним пољем за онемогућавање звона обавештења

Искључивање профила

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableProfiles": true
}];
</script>

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

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

External Link

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

Искључивање коментара на профилу

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

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

Disable Profile Comments

Copy

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableProfileComments": true
}];
</script>

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

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

External Link

Страница прилагођавања виџета са означеним пољем за онемогућавање коментара на профилу да би се сакрило језичак коментара на профилу

Искључивање директних порука на профилу

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableProfileDirectMessages": true
}];
</script>

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

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

External Link

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

Искључивање поруке о успесу

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

Onemogući poruku o uspehu

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableSuccessMessage": true
}];
</script>

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

Onemogući poruku o uspehu

External Link

Страница за прилагођавање виџета са означеним пољем за онемогућавање поруке о успесу, како би се сакрило потврђивање након коментара

Промена оцене садржаја GIF-ова

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

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

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

Подеси Gif Rating

Copy

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "gifRating": "pg-13"
}];
</script>

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

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

External Link

Gif Picker Rating падајући мени на страници за прилагођавање widget-а који нуди g, pg, pg-13 и r

Модерација садржаја слика

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

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

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

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

External Link

Падајући мени за ниво модерације садржаја слика на страници за прилагођавање widget-а подешен на off, low, medium или high

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

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

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

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

Omogući dugme srca

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "voteStyle": 1
}];
</script>

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

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

External Link

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

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

Искључивање брисања

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

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

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

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

External Link

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

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

Искључивање уређивања

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

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

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

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

External Link

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

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

Истицање нових коментара

FastComments нуди неколико начина за истицање нових коментара.

Прво и најважније, подразумевано ће коментари који су покренули нотификацију у апликацији (одговори, одговори у истој дискусији или коментари на страници на коју сте претплаћени) аутоматски бити истакнути тако што ће кориснички аватар благо светлити. Боја се може прилагодити преко CSS-а користећи класу is-unread.

Коментари објављени у последњих 24 сата имају додељену класу 24hr која се може користити за стилизовање.

Коначно, сви нови коментари уживо који се појаве у корисничкој сесији биће истакнути неколико секунди помоћу анимације. Ово се постиже помоћу CSS класе is-live и такође се може прилагодити.

Величине странице

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

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

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

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

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

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

External Link

Селектор величине странице на страници за прилагођавање виџета, где се може изабрати вредност од 10 до 200

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

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

Шаблони е-поште

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

Формати корисничких имена

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

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

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

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

External Link

Коментатор Формат Име падајући мени отворен са изборима као што су Capitalize, Last Initial и All Initials

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

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

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noImageUploads": true
}];
</script>

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

Onemogućavanje otpremanja slika

External Link

Onemogućavanje otpremanja slika чекбокс укључен у подешавањима странице за прилагођавање виџета

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

Подразумевано FastComments не дозвољава iframes у коментарима. Када омогућите уграђивање медија, коментатори могу да налепе код за уградњу (исечак <iframe>) од поузданих добављача као што су YouTube, Vimeo, SoundCloud и Spotify, и он ће се приказати унутар коментара.

Из безбедносних разлога, ово није конфигурациони флаг виџета на страни клијента. То је подешавање на страни сервера, које се проверава приликом чувања сваког коментара, тако да се не може укључити са странице. Дозвољени су само iframes који упућују на уграђени списак поузданих добављача. Сваки други iframe се уклања.

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

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

External Link

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

Додавање сопствених добављача

Ако желите да дозволите уграђивање од добављача који није на уграђеном списку поузданих, додајте његов hostname у поље „Додатни домени за уграђивање" на истој страници. Ови hostnames су дозвољени поред уграђених добављача. Подударање је тачно, тако да укључите пун hostname (на пример, player.example.com). Све што не наведете остаје блокирано.

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

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

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

Међутим, можемо га укључити постављањем заставице enableSearch на true:

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableSearch": true
}];
</script>

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

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

External Link

Страница за прилагођавање виџета са означеним пољем за омогућавање претраге, приказује поље за претрагу у виџету

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableSpoilers": true
}];
</script>

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

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

External Link

Страница за прилагођавање виџета са означеним пољетом Enable Spoilers да би се додао SPOILER дугме у уређивач

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

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

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

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

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

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

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

Омогућавање бројања прегледа коментара

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableViewCounts": true
}];
</script>

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

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

External Link

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

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

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

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

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

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

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

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

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

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

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

Show Live Comments Right Away

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "showLiveRightAway": true
}];
</script>

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

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

External Link

Поставка за скривање живих коментара је укључена тако да се нови коментари појављују одмах уместо иза дугмета

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

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

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

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

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

Disable Live Commenting

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableLiveCommenting": true
}];
</script>

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

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

External Link

Одељак „Disable Live Commenting“ на страници за прилагођавање виџета, искључује ажурирања нити у реалном времену

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

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

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

New Live Comments to Bottom

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "newCommentsToBottom": true
}];
</script>

Када је ова поставка омогућена:

Нови коментари уживо које објаве други корисници појављиваће се на дну листе коментара
Корисници ће видети нове коментаре како се у реалном времену појављују испод постојећих коментара
Ово утиче само на ажурирања коментара уживо - не и на почетно учитавање странице
Ово може помоћи у одржавању тока читања када корисници прате дискусију

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

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

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

Међутим, постоје случајеви када је пожељно бесконачно скроловање. На пример, ову функцију користимо у нашем Stream Chat производу.

Можемо сакрити дугмад "Прикажи следеће" и прећи на бесконачно скроловање тако што ћемо опцију enableInfiniteScrolling поставити на true:

Enabling Infinite Scrolling

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableInfiniteScrolling": true
}];
</script>

Ово такође захтева додатак прилагођеног CSS-а. Додајте прилагођени CSS за селектор .comments да бисте омогућили скроловање, на пример:

Омогућавање бесконачног скроловања

Copy

Copy

External Link

.comments {
    max-height: 500px;
    overflow-y: auto;
}

Пуни радни пример би изгледао овако:

Enabling Infinite Scrolling

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableInfiniteScrolling": true,
    "customCSS": ".comments { max-height: 500px;  overflow-y: auto; }"
}];
</script>

У горе наведеном примеру користимо својство customCSS, међутим препоручује се коришћење UI за конфигурацију видгета уместо тога из разлога перформанси. Погледајте документацију о прилагођеном CSS-у.

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

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

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

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultSortDirection": "OF"
}];
</script>

Подешавамо вредност defaultSortDirection на „OF“ да поставимо смер на „OF“.

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultSortDirection": "NF"
}];
</script>

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

MR: "Најновије"
NF: "Најновије прво"
OF: "Најстарије прво"

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

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

External Link

Селектор за подразумевани смер сортирања који нуди Најрелевантније, Најновије прво и Најстарије прво

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

Приказ свих коментара одједном - искључивање пагинације

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

Render All Comments

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "startingPage": -1
}];
</script>

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "inputAfterComments": true
}];
</script>

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

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

External Link

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

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

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

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "maxCommentCharacterLength": 500
}];
</script>

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

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

External Link

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

Искључивање коментисања у више линија

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

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "useSingleLineCommentInput": true
}];
</script>

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

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

External Link

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

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

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

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

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

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

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

External Link

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

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

Спречи нове коментаре на највишем нивоу

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

Prevent New Root Comments

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noNewRootComments": true
}];
</script>

Максимална дубина одговора

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

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

Limiting Reply Depth to 2 Levels

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "maxReplyDepth": 2
}];
</script>

Када је maxReplyDepth постављен на 2:

Корисници могу коментарисати на највишем нивоу (дубина 0)
Корисници могу одговарати на коментаре највишег нивоа (дубина 1)
Корисници могу одговарати на те одговоре (дубина 2)
Није дозвољено даље одговарање изван дубине 2

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

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

Захтевај прихватање услова коришћења

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

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

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

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

Идите на страницу за прилагођавање виџета и омогућите поље за потврду „Require Terms of Service acceptance". Када је омогућено, видећете следеће опције:

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

External Link

Панел Услуга коришћења са изборником режима текста TOS и пољем за датум последњег ажурирања

TOS Text Mode: Подразумевано, поље за потврду приказује „I agree to the Terms of Service and Privacy Policy" са везама ка оба документа. Изаберите „Customize text per locale" да бисте навели сопствени текст за сваки језик.
TOS Last Updated Date: Када ажурирате своје Услове коришћења, поставите овај датум. Корисници који су прихватили пре овог датума биће у обавези да поново прихвате.

Како функционише

Временска ознака прихватања TOS се чува по кориснику и по коментару
Када корисник прихвати TOS, датум се бележи на његовом корисничком профилу (по станодавцу)
Ако поставите датум „Last Updated" који је након датума прихватања корисника, мораће поново да прихвате
За анонимне кориснике који се не могу пратити, поље за потврду се појављује при сваком слању коментара

Упозори пре напуштања са непослатим коментаром

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

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

Упозори на несачувани коментар

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "warnOnUnsavedComment": true
}];
</script>

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

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

Омогући анкете

Анкете омогућавају коментаторима да уз коментар додају питање са 2 до 10 опција. Сви на страни гласају на месту и виде резултате како се ажурирају уживо.

Анкете су подразумевано искључене. Штиклирајте Enable Polls у подешавањима прилагођавања виџета да бисте додали дугме за анкету на траку са алаткама коментара. Тада се појављују још два подешавања:

Who Can Create Polls: Само админи/модератори (подразумевано), или Сви.
Allow Anonymous Poll Votes: када није штиклирано (подразумевано), само пријављени корисници могу гласати.

Enable Polls

External Link

Страница прилагођавања виџета са штиклираном опцијом Enable Polls

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

Преглед једноставне пријаве (SSO)

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

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

То трење можемо смањити тако што ће постојати само један ток пријављивања за цео ваш сајт.

Како да га набавим?

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

Упоредимо опције, а затим уђимо у детаље сваке од њих.

Миграција корисника и коментара

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

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

Сами корисници се додају аутоматски када први пут погледају нити коментара. Алтернативно, могу се унапред додати путем API-ја, али овај посао нема многе предности.

Ако су коментари увезени, а SSO корисници нису ручно додати путем API-ја, коментари ће аутоматски бити мигрирани на корисников налог приликом његовог првог стварања када погледа било коју нит коментара. Тада ће моћи да управљају, уређују и бришу коментаре које су првобитно написали.

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

Све док проследите одговарајуће корисничко име и имејл у SSO payload-у, додаћемо имејл појединачним објектима коментара како би обавештења и помињања радили.

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

Дакле, да резимирамо најлакши пут за миграцију:

Увезите коментаре.
1. Аватари и други медији се мигрирају аутоматски ако користите Import UI у Manage Data -> Imports.
Подесите Secure или Simple SSO.
Дозволите да миграција аутоматски обави по кориснику када се први пут пријаве.
1. Ово обично додаје мање од секунде на време учитавања странице ако корисник има мање од 50k коментара.

WordPress корисници

Ако користите наш WordPress додатак, онда нема кода за писање! Једноставно идите на Admin страницу додатка, кликните SSO Settings, а затим Enable.

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

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

WordPress SSO - Модератори

Имајте на уму да тренутно, да би се значка "Moderator" приказивала поред ваших модератора када коментаришу помоћу FastComments WordPress додатка, они такође морају бити додати као модератори у FastComments контролном панелу и имати верификован имејл.

Прилагођене интеграције

За прилагођене интеграције постоје две опције.

Опција један - Secure SSO

Са Secure SSO-ом, FastComments зна да корисник који коментарише, гласа и чита коментаре је стварни корисник на вашем сајту.

Све док креирате важећи payload, корисник ће увек имати беспрекорно искуство коментарисања.

Са Secure SSO-ом, SSO payload се креира на серверу користећи HMAC аутентификацију, а затим прослеђује виџету на клијенту.

Са Secure SSO-ом, корисников налог је потпуно одвојен од остатка FastComments корисничке базе. То значи да ако имамо два партнера, Company A и Company B, сваки може имати SSO корисника са корисничким именом "Bob".

Захтеви

Основно познавање развоја на серверу (backend).
Основно познавање руковања тајним API кључевима.
Основно познавање развоја API-ја или серверског рендеровања.

Предности

Безбедно.
Беспрекорно искуство коментарисања.

Мане

Захтева развој на серверу (backend).

Ажурирање података корисника

Са Secure SSO-ом, сваки пут када проследите SSO корисников payload, ажурираћемо његов налог најновијим информацијама. На пример, ако корисник има корисничко име X, а ви проследите Y у SSO payload-у, његово корисничко име ће постати Y.

Ако желите да уклоните вредности овим приступом, поставите их на null (не undefined).

Secure SSO API

Такође пружамо API за интеракцију са SSO корисницима. Погледајте документацију.

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

Опција два - Simple SSO

Алтернатива Secure SSO-у је једноставно прослеђивање информација о кориснику виџету за коментарисање.

Пружање имејла са Simple SSO-ом није обавезно, међутим без тога ће њихови коментари бити приказани као "Unverified".

^{Напомена!} Од почетка 2022. године корисничка имена са Simple SSO-ом не морају бити јединствена на целом FastComments.com.

У идеалном случају, Simple SSO треба изабрати само када развијате на платформи која не пружа приступ серверу (backend).

Захтеви

Основно познавање развоја на клијенту (client-side).
Морате знати барем корисникову имејл адресу.

Предности

Једноставно.
Сва активност се и даље верификује.
Корисник никада не уноси своје корисничко име или имејл.

Мане

Мање безбедно од Secure SSO-а јер клијентски payload може бити измењен да постане било који корисник.

Simple SSO API

Корисници аутоматски креирани путем Simple SSO тока чувају се као SSOUser објекти. Могу се приступити и управљати њима путем SSOUser API-ја. Погледајте документацију.

Прилагођене интеграције – безбедна једноставна пријава (SSO)

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

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

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

Secure 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

Copy

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "sso": {
        "userDataJSONBase64": "...",
        "verificationHash": "...",
        "timestamp": 1794130022615.0,
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout",
        "loginCallback": null,
        "logoutCallback": null
    }
}];
</script>

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

The User Object:

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

Copy

Copy

interface SSOUser {
    /** Обавезно. Максимум 1k карактера. **/
    id: string;
    /** Обавезно. Максимум 1k карактера. Напомена: Мора бити јединствен. **/
    email: string;
    /** Обавезно. Максимум 1k карактера. Напомена: Корисничко име не може бити e-mail. Не мора бити јединствено. **/
    username: string;
    /** Опционо. Максимално 3k карактера за URL-ове. Подразумевано долази са gravatar-а на основу e-mail-а. Подржава base64-енкодиране слике, у ком случају лимит је 50k карактера. **/ 
    avatar?: string;
    /** Опционо. Подразумевано false. **/
    optedInNotifications?: boolean;
    /** Опционо. Подразумевано false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Опционо. Максимум 100 карактера. Ова ознака ће бити приказана поред њиховог имена. Подразумевано је Administrator/Moderator када је применљиво. **/
    displayLabel?: string;
    /** Опционо. Максимум 500 карактера. Ово ће бити приказано уместо username-а. **/
    displayName?: string;
    /** Опционо. Максимум 2k карактера. Име корисника ће водити на ово. **/
    websiteUrl?: string;
    /** Опционо. До 100 група по кориснику. ИД групе не сме бити дужи од 50 карактера. **/
    groupIds?: string[];
    /** Опционо. Означава корисника као администратора. **/
    isAdmin?: boolean;
    /** Опционо. Означава корисника као модератора. **/
    isModerator?: boolean;
    /** Опционо, подразумевано true. Поставите на false да бисте омогућили таб "activity" у профилу корисника. **/
    isProfileActivityPrivate?: boolean;
    /** Опционо, подразумевано false. Поставите на true да онемогућите коментаре на профилу. **/
    isProfileCommentsPrivate?: boolean;
    /** Опционо, подразумевано false. Поставите на true да онемогућите директне поруке овом кориснику. **/
    isProfileDMDisabled?: boolean;
    /** Опциона конфигурација за значке корисника. **/
    badgeConfig?: {
        /** Низ глобалних ID-ева значки које треба доделити. Ограничено на 30 значки. Редослед се поштује. **/
        badgeIds: string[];
        /** Низ ID-ева значки ограничених на тренутну страницу (urlId). Приказују се само на додељеној страници. **/
        pageBadgeIds?: string[];
        /** Ако је true, замењује постојеће приказане значке. Глобалне и странице-ограничене значке се понаособ преуписују. **/
        override?: boolean;
        /** Ако је true, ажурира приказ значки из конфигурације tenant-а. **/
        update?: boolean;
    };
}

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

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

Обавештења

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

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

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

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

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

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

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

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

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

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

Прилагођене интеграције – једноставна SSO

Помоћу Simple SSO, можемо обезбедити widget за коментарисање информацијама о кориснику тако да не мора да уноси своје корисничко име или имејл да би коментарисао.

Можемо конфигурисати Simple SSO на следећи начин:

Simple SSO

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "simpleSSO": {
        "username": "Bob",
        "email": "bob@example.com",
        "avatar": "https://example.com/bob.png",
        "websiteUrl": "https://example.com/profiles/bob",
        "displayName": "Bob's Name",
        "displayLabel": "VIP User",
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout",
        "badgeConfig": {
            "badgeIds": [
                "badge-id-1",
                "badge-id-2"
            ],
            "pageBadgeIds": [
                "badge-id-3"
            ],
            "override": false
        }
    }
}];
</script>

Корисник ће бити пријављен и биће креиран SSO корисник у позадини. Корисник ће имати createdFromSimpleSSO постављено на true ако је добијен из API‑ја.

Notes:

Имејл је јединствени идентификатор за Simple SSO.
Навођење имејла у Simple SSO није обавезно, међутим подразумевано ће њихови коментари бити приказани као „Unverified“. Ако није наведен имејл, корисник не може бити потпуно аутентификован.
НОВО Од јануара 2022.: Корисничка имена не морају бити јединствена на целом fastcomments.com
Simple SSO може аутоматски креирати и ажурирати SSO кориснике, ако је наведен имејл, и ако корисник није оригинално креиран из Secure SSO. Ако Simple SSO payload именује корисника који је креиран из Secure SSO или API‑ја, тај корисник остаје нетакнут, а посетиоца добија одвојеног корисника.
Можете одредити значке за корисника помоћу својства badgeConfig. Низ badgeIds садржи ИД‑ове глобалних значки које се везују за корисника. Низ pageBadgeIds садржи ИД‑ове значки ограничене на тренутну страницу (urlId) — ове значке се приказују само на страници где су додељене. Ако је override постављено на true, замениће постојеће приказане значке (глобалне и странице‑ограничене се независно замењују); ако је false, додаће се постојећим значкама.

Подешавања Simple SSO

Simple SSO је увек доступан. Два подешавања контролишу колико FastComments му верује. Можете их пронаћи претраживањем SSO у правилу прилагођавања. Оба су подразумевано искључена и примењују се без обзира да ли је „Require SSO To View Comments“ укључено.

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

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

Аутоматска верификација коментара преко Simple SSO

Када је ово укључено, коментари од Simple SSO корисника се одмах верификују.

Када је ово искључено, коментари од Simple SSO корисника се приказују као „Unverified“ док корисник не кликне на линк који им пошаљемо имејлом на адресу у Simple SSO payload‑у. Ако аутоматски одобравате само верификоване коментаре, они такође чекају тај линк. Ако у payload‑у нема имејла, коментар остаје неверификован.

Ово подешавање утиче само на коментаре. Гласови од Simple SSO корисника се увек одмах рачунају.

Дозволи Simple SSO администраторе

Када је ово укључено, Simple SSO корисник може бити администратор или модератор вашег налога:

Simple SSO корисник који има администраторска или модераторска овлашћења задржава их.
Simple SSO корисник са истим имејлом као један од ваших администратора или модератора преузима њихова овлашћења.

Када је ово искључено, Simple SSO не додељује ова овлашћења. Simple SSO payload који именује корисника са овим овлашћењима добија одвојеног корисника без овлашћења, а оригинални корисник остаје нетакнут.

Simple SSO payload‑и нису потписани, тако да када је ово укључено, свако ко зна имејл или ИД администратора може се представљати као он. Ако је то важно за ваш сајт, оставите ово искључено и користите Secure SSO за ваше администраторе.

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

Прилагођене интеграције – миграција са Disqus SSO

Najveća razlika između Disqus и FastComments Secure SSO је што Disqus користи SHA1 за енкрипцију, док ми користимо SHA256. То значи да је миграција са Disqus једноставна - промените алгоритам хешовања који се користи са SHA1 на SHA256 и ажурирајте називе својстава која се прослеђују UI-у.

Прилагођене интеграције – миграција са Commento SSO

Commento користи драстично другачији SSO приступ - они захтевају да имате endpoint који они позивају да би аутентификовали корисника. FastComments је обрнуто - једноставно енкодирајте и хеширајте информације о кориснику користећи ваш тајни кључ и проследите их.

Заштита тема коментара помоћу SSO

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

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

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

Подешавање без кода

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

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

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

External Link

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

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

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

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

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

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

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

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

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

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

Подешавања Аутоматска верификација коментара преко Simple SSO и Дозволи Simple SSO администраторе су одвојена и важе без обзира да ли је ова опција укључена.

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

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

Замке

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

Дозволи анонимно коментарисање

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

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

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

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

External Link

Опција анонимних коментара у интерфејсу за прилагођавање виџета, која чини поље за имејл опционо

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

Спречавање истека анонимних коментара

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

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

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

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

External Link

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

Искључивање уноса е-поште

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

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

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

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

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

External Link

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

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

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

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

Искључивање ознаке непотврђеног

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

Disable The Unverified Label

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableUnverifiedLabel": true
}];
</script>

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

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

External Link

Страница за прилагођавање виџета са чекираним пољем за онемогућавање ознаке Неоверификованог коментара

Дозволи анонимно гласање

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

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

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

External Link

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

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

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

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

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

External Link

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

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

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

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

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

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

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

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

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

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

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

External Link

Опција Аутоматско генерисање корисничких имена у корисничком интерфејсу прилагођавања виџета

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

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

Повратни позиви

Све библиотеке за видгет коментара (тренутно Angular, React, Vue) подржавају повратне позиве.

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

Подржани повратни позиви су:

onInit
onAuthenticationChange
onRender
commentCountUpdated
onReplySuccess
onVoteSuccess
onImageClicked
onOpenProfile
onCommentSubmitStart
onCommentsRendered

Тачне сигнатуре можете пронаћи у TypeScript definitions.

Ево примера са свим повратним позивима:

Примери повратних позива

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
    window.fcConfigs = [{
        target: '#fastcomments-widget',
        tenantId: 'demo',
        onInit: function () {
            console.log('Library started to fetch comments!');
        },
        onAuthenticationChange: function (eventName, userObj) {
            console.log('User authenticated!', eventName, userObj);
        },
        onRender: function () {
            console.log('Render event happened!');
        },
        commentCountUpdated: function (newCount) {
            console.log('New comment count:', newCount);
        },
        onReplySuccess: function (comment) {
            console.log('New comment saved!', comment);
        },
        onVoteSuccess: function (comment, voteId, direction, status) {
            console.log('New vote saved!', comment, voteId, direction, status);
        },
        onImageClicked: function (src) {
            console.log('Image clicked!', src);
        },
        onOpenProfile: function (userId) {
            console.log('User tried to open profile', userId);
            // return true; // return true да бисте спречили подразумевано понашање (отварање fastcomments.com корисничког профила).
        },
        onCommentSubmitStart: function(comment, continueSubmitFn, cancelFn) {
            console.log('Trying to submit comment', comment);
            setTimeout(function() { // емулирање асинхроног понашања (позивање API-ја итд).
                if(confirm('Should submit?')) {
                    continueSubmitFn();
                } else {
                    cancelFn('Some optional error message');
                }
            }, 1000);
        },
        onCommentsRendered: function(comments) {
            // comments је сортиран према подразумеваној сорти на страници која може бити Most Relevant (нпр: највише гласова, итд) или Newest First
            const topCommentInList = comments[0];
            console.log('First Comment Rendered:', topCommentInList.avatarSrc, topCommentInList.commenterName, topCommentInList.commentHTML);
        }
    }];
</script>

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

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

External Link

Padajući meni Locale / Language na stranici za prilagođavanje vidžeta koji se koristi za prepisivanje detektovane lokalizacije posetioca

Preko koda

Ovo se može prepisati željenom lokalizacijom.

Ručno definisanje lokalizacije korisnika

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "locale": "ru_ru"
}];
</script>

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 не ограничава језике који се користе за коментарисање.

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

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

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

External Link

Селектор дозвољених језика на страници за прилагођавање виџета за ограничавање којих језика се могу користити у коментарима

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

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

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

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

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

Постоје два режима:

Аутоматски: коментари написани на језику различитом од језика виџета се приказују преведени. Линија „Преведено са шпанског“ појављује се испод коментара са везом Прикажи оригинал која мења између превода и непреведеног текста.
Ручни: сваки коментар добија везу Преведи. Клик на њу преводи тај коментар на језик посетиоца, са истим прекидачем Прикажи оригинал након тога. Коментари који су већ на језику посетиоца то указују уместо тога.

Циљни језик је језик виџета: подешавање Locale / Language на истом правилу прилагођавања ако је постављено, иначе језик прегледача посетиоца. Посетиоцу није потребно ништа, нема налога, екстензије или додатног софтвера, и функционише исто у угњежденом виџету и на самосталним страницама коментара.

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

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

External Link

Падајући мени за превод коментара на страници за прилагођавање виџета са опцијама Искључено, Аутоматски и Ручно

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

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

Употреба се наплаћује као LLM токени по истој цени као AI Agents и појављује се на истом месту у вашим подацима о наплати.

Наслови страница

Тренутни наслов странице повезује се са наведеним urlId и чува за употребу у алатима за модерацију.

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

Ако желите, можете навести сопствени наслов странице на следећи начин:

Specifying The Page Title

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "pageTitle": "Article 42"
}];
</script>

Спречи нове одговоре и искључи гласање

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

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

Making The Comment Thread Readonly

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "readonly": true
}];
</script>

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

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

External Link

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

Update!

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

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

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

Ограничење домена линкова

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

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

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

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

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

External Link

Подешавања спољних веза са листом ограничених домена веза где се уносе дозвољени сајтови

Број коментара и бројање свих угнежђених одговора

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

Подразумевано, ово је true – то је број последњег – свих коментара. У старијим верзијама виџета за коментаре подразумевана вредност је false.

Можемо променити понашање тако да буде број свих угнежђених коментара постављањем заставице countAll на true.

Бројање свих коментара

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "countAll": true
}];
</script>

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

Бројање коментара највишег нивоа

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "countAll": false
}];
</script>

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

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

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

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

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

Enabling Commenter Links

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableCommenterLinks": true
}];
</script>

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

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

Enabling Commenter Links

External Link

Widget customization page with the commenter links checkbox checked to add a website URL field to the comment form

Групе за модерацију

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

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

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

Specify Moderation Groups

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "moderationGroupIds": [
        "mxZAhjzdb",
        "FT19nXbqA"
    ]
}];
</script>

Помена ID група

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

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

Limit Groups for Mentions

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "mentionGroupIds": [
        "yxZAhjzda",
        "QT19nXbqB"
    ]
}];
</script>

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

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

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

Ово можемо урадити у коду постављањем заставице enableThirdPartyCookieBypass на true:

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableThirdPartyCookieBypass": true
}];
</script>

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

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

External Link

Страница за прилагођавање виџета са означеним пољем за омогућавање искачућег прозора за колачиће трећих страна

Брисање коментара са одговорима

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

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

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

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

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

External Link

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

Прикажи значке у горњој траци

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

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

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

External Link

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

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

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

Onemogući prikaz bedževa u gornjoj traci

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "showBadgesInTopBar": false
}];
</script>

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

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

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

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

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

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

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

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "usersListLocation": 3
}];
</script>

Подразумевано листа приказује само кориснике који су тренутно онлајн. Да бисте такође укључили људе који су у прошлости коментарисали страницу (али је тренутно не прегледају), поставите usersListIncludeOffline на true:

Укључи претходне коментаторе

Copy

Copy

External Link

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "usersListLocation": 3,
    "usersListIncludeOffline": true
}];
</script>

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

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

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

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

External Link

Локација листе корисника постављена на десно, са пољем за укључивање претходних коментатора приказаним испод

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

Претходни водич Следећи водич