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

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

Контекст

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

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

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

Примери кода ће користити нашу 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>

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

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

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

External Link

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

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

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

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

Angular, React, Vue, etc

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

VanillaJS

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

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

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

Пример промене хеша странице

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

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

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

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

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

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

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

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

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

External Link

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

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

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

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

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

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

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

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

Copy

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

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

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

Configuration

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

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

External Link

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

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

How It Works

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

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

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

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

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

How do I get it?

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

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

User and Comment Migrations

Када мигрирате са платформе која користи 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 Users

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

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

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

WordPress SSO - Moderators

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

Custom Integrations

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

Option One - Secure SSO

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

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

Код Secure SSO, SSO payload се креира на серверској страни користећи HMAC authentication и затим се прослеђује видгету на клијенту.

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

Requirements

Основно знање о развоју бекенда.
Основно знање о руковању тајним API кључевима.
Основно знање о развоју API-ја или серверском рендеровању.

Pros

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

Cons

Захтева развој на бекенду.

Updating User Data

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

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

Secure SSO API

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

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

Option Two - Simple SSO

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

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

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

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

Requirements

Основно знање о развоју на клијентској страни.
Морате знати барем имејл корисника.

Pros

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

Cons

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

Simple SSO API

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

Прилагођене интеграције - безбедно једнократно пријављивање (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": 1787115343229.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 можемо да обезбедимо коментаришућем видгету информације о кориснику тако да не мора да уноси своје корисничко име или имејл да би коментарисао.

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-ја.

Напомене:

Е-пошта је јединствени идентификатор за Simple SSO.
Пружање е-поште уз Simple SSO није обавезно, међутим по подразумеваној вредности њихови коментари ће се приказати као "Unverified". Ако е-пошта није обезбеђена, корисник не може бити у потпуности аутентификован.
NEW Since Jan 2022: Usernames do not have to be unique across all of fastcomments.com
Simple SSO може аутоматски да креира и ажурира SSO кориснике ако је е-пошта обезбеђена и корисник није оригинално креиран преко Secure SSO.
Можете одредити значке за корисника помоћу badgeConfig својства. Низ badgeIds садржи ID-еве глобалних значки које ће бити повезане са корисником. Низ pageBadgeIds садржи ID-еве значки који су ограничени на тренутну страницу (urlId) — ове значке се приказују само на страници на којој су додељене. Ако је override постављен на true, он ће заменити постојеће приказане значке (глобалне и оне ограничене на страницу се потискују независно); ако је false, додаће се постојећим значкама.

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

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

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

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

Заштита нити коментара помоћу једнократног пријављивања

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

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

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

No-Code Setup

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

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

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

External Link

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

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

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

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

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

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

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

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

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

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

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

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

Замке

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

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

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

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

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

Omogućavanje anonimnih komentara

External Link

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

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

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

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

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

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

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

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

External Link

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

---

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

Све библиотеке за видгет коментара (тренутно 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

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

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

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

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

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

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