
Језик 🇷🇸 Српски
Додаци трећих страна
Прилагођене инсталације
Уграђивање у документе
Додавање коментара на веб-сајт
Инсталација
FastComments олакшава додавање коментара на ваш веб-сајт, било да је статичан или динамичан, са светлом или тамном темом, за јавне или интерне странице. Требало би да буде лако инсталирати и прилагодити га било којем типу сајта или веб апликације. Ово вам омогућава коментарисање уживо одмах, у многим случајевима без додатне конфигурације.
WordPress 
Да бисте додали коментаре на ваш WordPress сајт, наш WordPress додатак можете пронаћи овде.
Комплетан водич за инсталацију и документација о додатку налазе се овде.
Овај додатак подржава коментарисање у реалном времену, SSO и инсталацију без кода. Једноставно следите водич за инсталацију на админ страници после инсталирања додатка. Он ће вас провести кроз повезивање ваше WordPress инсталације са вашим налогом.
Сви коментари остављени преко FastComments помоћу нашег WordPress додатка могу бити аутоматски синхронизовани назад у вашу WordPress инсталацију тако да задржите контролу над својим подацима. Ово се може искључити да бисте ограничили величину ваше WordPress базе података.
VanillaJS / HTML исечак 
VanillaJS верзија видџета је најједноставнији начин да додате коментаре на ваш сајт, без потребе за системима за изградњу или серверским кодом.
Једноставно додајте следећи кодски исечак на било коју страницу да бисте додали коментаре на ваш сајт:
Run 
Исти кодски исечак можете користити на више страница; он ће аутоматски креирати засебну тему по страници.
Многе апликације имају опцију "HTML Embed Code". Изаберите ту и налепите горе наведени кодски исечак у њу.
Такође вам није потребан налог да то пробате! Можда ћете видети "tenantId: demo" у горе наведеном исечку ако нисте пријављени. На тај начин ће се користити демо налог.
Документацију о конфигурисању видџета можете пронаћи овде.
Све верзије FastComments видџета су омотачи око основне VanillaJS библиотеке. Ово нам омогућава да додамо функције и исправимо проблеме на једном месту - и промене се аутоматски проширују на остале варијанте коментарског видџета.
Angular 
За додавање коментара на сајт изграђен са Angular-ом, нашу Angular библиотеку можете пронаћи на NPM овде.
FastComments Angular виџет за коментаре подржава све исте функције као VanillaJS верзија - коментаре у реалном времену, sso и тако даље.
Потребан вам је fastcomments-typescript, који је peer dependency. Молимо вас да уверите да је укључен у вашу TypeScript компилацију. У будућности, ова peer dependency биће премештена у @types/fastcomments што ће поједноставити инсталацију.

Peer dependency треба додати у вашу tsconfig.json датотеку, на пример:

Затим додајте FastCommentsModule у вашу апликацију:

Употреба
Да бисте започели, прослеђујемо конфигурациони објекат за demo tenant:

Пошто конфигурација може постати прилично сложена, можемо проследити референцу на објекат:


Виџет користи change detection, тако да промена било које особине конфигурационог објекта доводи до његовог поновног учитавања.
Конфигурацију коју Angular компонента подржава можете пронаћи овде.
React 
За додавање коментара на сајт направљен са React-ом, нашу React библиотеку можете пронаћи на NPM овде.
FastComments React виџет за коментаре подржава све исте функције као VanillaJS верзија - коментаре у реалном времену, sso и тако даље.



Ако сте у ЕУ, треба да подесите region параметар на следећи начин:

Конфигурацију коју React компонента подржава можете пронаћи овде.
React Native 
Да бисте додали коментаре у своју React Native апликацију, нашу React Native библиотеку можете пронаћи на NPM овде.
FastComments React Native виџет за коментаре подржава све исте функције као VanillaJS верзија - коментаре у реалном времену, sso и тако даље.


Конфигурација се наводи мало другачије у поређењу са fastcomments-react библиотеком:

Ако сте у ЕУ, желећете да подесите region параметар:

Конфигурацију коју React Native компонента подржава можете пронаћи овде.
Vue 
Да бисте додали коментаре на свој веб сајт направљен помоћу Vue-а, нашу Vue библиотеку можете пронаћи на NPM овде.
Поред тога, vue-next библиотека се налази на NPM овде
Изворни код можете пронаћи на GitHub-у.
FastComments Vue виџет за коментаре подржава све исте функције као VanillaJS верзија - коментаре у реалном времену, sso и тако даље.
Упутства у наставку важе за Vue 3 јер је ту већ неко време, међутим FastComments такође подржава Vue 2 преко fastcomments-vue библиотеке.



Ако сте у ЕУ, желите да подесите region на EU:

Библиотеке fastcomments-vue и fastcomments-vue-next подржавају исту конфигурацију као VanillaJS виџет за коментаре.
Конфигурацију коју Vue компонента подржава можете пронаћи овде.
Више инстанци на истој страници 
Свака инстанца widget-а за коментаре је изолована. Због тога FastComments природно подржава више од једне инстанце по страници, или више инстанци које упућују на исту конверзацију.
У случају VanillaJS библиотеке, на пример, једноставно треба да повежете widget за коментаре са различитим DOM чворовима. Ако желите само да ажурирате тренутну конверзацију на страници, погледајте Switching Comment Threads Without Reloading The Page;
Синхронизација стања аутентификације између више инстанци
Прегледајмо пример прилагођене једностраничне апликације која је листа често постављаних питања са својом конверзацијом за коментаре.
У овом случају, имамо више инстанци FastComments у DOM-у истовремено.
То је у реду, али представља неке изазове за корисничко искуство.
Размотрите овај ток:
- Корисник посећује страницу са листом питања, свако са сопственим widget-ом за коментаре.
- Корисник уноси своје корисничко име и имејл и оставља питање у једној од конверзација.
- Видише још један FAQ ставку о којој има питање.
- Поново иду да коментаришу. Да ли морају поново унети свој имејл и корисничко име?
У овом случају, FastComments за вас управља синхронизацијом стања аутентификације између инстанци widget-а. У четвртом кораку, корисник ће већ бити привремено аутентификован јер је унео своје корисничко име и имејл на истој страници.
Чести случајеви употребе 
Приказивање живих коментара одмах
Виџет за коментаре је подразумевано жив, али живи коментари се појављују испод дугмета „Show N New Comments“ како би се спречило померање садржаја странице.
У неким случајевима је и даље пожељно приказати нове коментаре одмах, без потребе за кликом на дугме.
У овом случају, желите да омогућите заставицу showLiveRightAway, за коју можете пронаћи документацију овде.
Омогућавање анонимног коментарисања (без захтева за е‑пошту)
Подразумевано, FastComments захтева од корисника да остави е‑пошту приликом коментарисања.
Ово се може онемогућити, упутства су овде.
Да би се посетиоци такође ослободили избора корисничког имена, FastComments може генерисати једно за сваког посетиоца.
Прилагођени стил
Многи од наших клијената примењују сопствени стил на виџет за коментаре. Документацију можете пронаћи овде.
Приказ истих коментара на више домена
Приказ истих коментара на више сајтова је функција коју FastComments подржава одмах. Погледајте нашу документацију о овој теми.
Промена тренутне странице
FastComments подржава SPA‑ове и сложене апликације. Промена тренутне странице је лака и објашњена овде.
Решавање уобичајених проблема 
Ево неких симптома који се често јављају, и уобичајених решења.
Порука „Ово је демо"
Ово се приказује када сте копирали код виџета са наше почетне странице, који користи наш демо тенант. Да бисте користили свој тенант, копирајте код виџета са овде.
Грешка „FastComments се не може учитати на овом домену"
FastComments мора да зна које домене поседујете како би аутентификовао захтеве везане за ваш налог. Погледајте нашу документацију да видите како да решите ову грешку (једноставно додајте тачан поддомен + домен на свој налог).
Имајте на уму да би се ово требало десити само након истека пробног периода. Током пробног периода, сви захтеви са нових домена биће аутоматски додати на ваш налог.
Мигрирани коментари се не приказују за прилагођене инсталације
Обично се ово дешава када су увезени коментари везани за Page ID, а ви прослеђујете URL
(или ништа, у ком случају се подразумева URL странице).
Ово можете дебаговати тако што ћете извезти своје коментаре и погледати колону URL ID (тренутно колона B).
Уверите се да вредности које видите у колони URL ID одговарају вредностима које прослеђујете
конфигурацији виџета као параметар urlId.
За даље објашњење, прочитајте нашу документацију Како су коментари везани за странице и чланке.
Ако ништа не помогне, контактирајте нас.
Виџет за коментаре се не приказује
Ако се виџет за коментаре не приказује, проверите Chrome developer конзолу за грешке.
У већини случајева погрешне конфигурације, виџет за коментаре ће барем приказати грешку на страници ако је у стању да се учита. Ако не видите ништа, то обично указује на грешку у скрипти.
Жељена конфигурација не ради како се очекује
Пробајте нашу Chrome екстензију да видите која се конфигурација прослеђује виџету за коментаре. Ако ништа не помогне, направите снимак екрана онога што Chrome екстензија приказује и контактирајте нас.
Коментари недостају на истом URL-у са различитим hash bang-ом
Подразумевано, FastComments користи URL странице као „канту" (bucket) у којој се чувају коментари. Ако ваши URL-ови садрже #hashbangs, а ти #hashbangs
не би требало да буду део идентификатора који идентификује нит коментара, можемо једноставно игнорисати вредност hash bang-а, на пример:

Имајте на уму да након ове промене треба извршити миграцију за постојеће коментаре. За то, контактирајте нас.
URL query параметри утичу на виџет
Подразумевано, FastComments користи URL странице као „канту" (bucket) у којој се чувају коментари. Ако ваши URL-ови садрже query параметре који не би требало да буду део идентификатора који идентификује нит коментара, можемо их једноставно игнорисати, на пример:

Имајте на уму да након ове промене треба извршити миграцију за постојеће коментаре. За то, контактирајте нас.
Е-поште не стижу
У FastComments улажемо много труда да наша испорука е-поште буде што поузданија. Међутим, неки добављачи е-поште су познато тешки за поуздану испоруку. Проверите свој spam фасциклу за поруке од fastcomments.com.
Ако нам пишете, обично можемо дати више увида у разлог зашто не видите е-пошту од нас.
Notion и Google Sites 
Желите да додате коментаре на своје Notion странице, Google Sites или Nimbus Notes? Ми смо ту за вас.
Notion
За додавање коментирања у Notion документе, погледајте објашњење у видеу овде.
Google Sites
Google Sites је такође подржан, а поступак је сличан.
- Create a conversation to embed.
- Када уређујете свој Google Site, идите на
Insert->Embed. ОдаберитеBy URL. - Налепите URL из Корака 1.
- Кликните на
Insert. Готово!
Nimbus Note
Додавање коментирања уживо у Nimbus Note је такође подржано, а поступак је сличан Notion-у.
- Create a conversation to embed.
- Када уређујете своју белешку, додајте embed блок.
- Користите URL из Корака 1 као URL за уметање.
- Готово!