
Језик 🇷🇸 Српски
Инсталација Shopify-а
Додавање коментара на Shopify сајтове
FastComments је доступан на Shopify App Store. Инсталирајте апликацију и додајте FastComments блокове на било који блог пост, страницу производа или прилагођену страницу из уређивача тема у Shopify-у. Није потребно уређивање кода.
Када инсталирате апликацију, Shopify конфигурише ваш FastComments налог, повезује домен ваше продавнице и аутоматски подешава наплату. Нема потребе да се посебно пријављујете на fastcomments.com.
Странице у овом упутству обрађују сваки FastComments блок који апликација пружа, како ради једнократно пријављивање (single sign-on) за ваше Shopify купце и како да увезете постојеће коментаре из Shopify-а пре преласка.
Инсталирање FastComments апликације 
Инсталирајте са Shopify App Store
- Отворите FastComments страницу на Shopify App Store.
- Кликните Add app и изаберите план који желите током процеса инсталације.
- Shopify ће вас вратити у FastComments админ унутар Shopify-а када се инсталација заврши.
То је цела инсталација. Нема ништа што треба да налепите у фајлове теме.
Шта се подешава за вас
Инсталација покреће све што бисте иначе радили ручно:
- За вашу продавницу се креира FastComments tenant и повезује се са доменом ваше продавнице.
- URL ваше продавнице се додаје у овлашћене домене tenant-а, тако да се коментари учитавају без грешке везане за домен.
- Уметнуто је метаполе продавнице
fastcomments.tenant_idтако да сваки блок зна против ког tenant-а да приказује. - Једнократно пријављивање (Single sign-on) за ваше Shopify купце је подешено подразумевано.
- Плаћање се обрађује преко Shopify Managed Pricing. Трошкови се појављују на вашем редовном Shopify рачуну. Надоградите, спустите ниво или откажите у Подешавања > Апликације и канали продаје > FastComments у вашем Shopify администратору.
Ако је ваша продавница већ била FastComments корисник пре него што сте инсталирали апликацију, инсталација ће поново користити постојећи tenant уместо да креира нови.
Угралдни админ
Када отворите FastComments апликацију из вашег Shopify админ панела, наћи ћете се на контролној табли са плочицама за једним кликом које воде у пун FastComments бекенд:
- Dashboard: подешавања налога, коришћење и детаљи претплате.
- Moderation Queue: одобрите, одбите и одговорите на коментаре широм ваше продавнице.
- Customize: подесите боје видгета, фонтове, правила модерације и конфигурацију.
- Ratings & Reviews Helper: подесите звездице за оцене и питања за рецензије ако желите да користите Reviews Summary блок.
Свака плочица отвара FastComments са једнократним линком за пријаву, па вам није потребно посебно пријављивање.
Следеће: додајте блокове у вашу продавницу
Отворите уређивач теме у Shopify-у (Онлајн продавница > Теме > Прилагоди), отворите шаблон у који желите да додате коментаре или рецензије и кликните Add block. FastComments блокови се појављују под Apps. Остатак овог водича обухвата сваки од њих.
Додавање коментара на блог постове и производе 
Блок FastComments је главни видгет за коментаре. Додајте га у шаблоне постова на блогу, шаблоне производа, или било коју другу страницу на којој желите дискусиону нит или уживо чет.
Додавање блока
- Отворите уређивач Shopify теме (Online Store > Themes > Customize).
- Изаберите шаблон на ком желите коментаре: Blog post, Product, или било који други шаблон странице или секције.
- У секцији где желите да се појаве коментари, кликните Add block.
- Под Apps, изаберите FastComments.
- Кликните Save.
Блок се појављује одмах. Нема Tenant ID који треба унети; ваш продавнички tenant је повезан аутоматски када инсталирате апликацију.
Поставке
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Премашите који FastComments tenant блок рендерује против. Оставите празно да бисте користили tenant који је продавница конфигурисала аутоматски. Пронађите ручни Tenant ID на fastcomments.com/auth/my-account/api-secret. | (blank) |
| SSO | Аутоматски пријављује посетиоца као њихов Shopify customer account пре коментарисања. Погледајте Аутоматско пријављивање Shopify купаца. | On |
| Commenting Style | Threaded за угнеждене одговоре и гласање, или Streaming за фид у реалном времену (као ћаскање). | Threaded |
| Custom URL ID | Премашите аутоматски детектовани идентификатор странице. Користите ово када желите да две URL адресе деле једну нит коментара. | (auto-detected) |
Како се бира идентификатор странице
Свака нит коментара је кључевана по URL ID-ју. Блок бира један аутоматски:
- Blog post template:
shopify-article-{article.id}, which is stable across slug and title changes. - Product template:
shopify-product-{product.id}, which is stable across slug and title changes. - Other templates: the request path.
Ако подесите Custom URL ID, користи се та вредност уместо тога. Користите исти Custom URL ID у више блокова (на пример, на локализованој варијанти странице производа) да бисте делили једну нит коментара.
Threaded vs Streaming
Threaded је подразумевано. Посетиоци одговарају једни другима, гласају, и алати за модерирање раде као што се очекује. Најбоље за постове на блогу и рецензије производа.
Streaming уклања угнежђивање и показује нове коментаре у реалном времену док се шаљу, као фид ћаскања. Најбоље за лансирања производа, догађаје уживо и странице заједнице.
Више блокова на истој страници
Блок се може додати више пута на исти шаблон. На пример, сажетак рецензија на врху странице производа и FastComments блок на дну. Блокови деле URL ID, тако да сажетак одражава коментаре испод.
Савети
- Блок се сакрива у прегледу уређивача теме са жутом обавештењем ако не може да пронађе tenant. Ако се то појави у вашој уживо продавници, поново инсталирајте FastComments апликацију.
- За страницу производа, FastComments блок служи и као видгет за рецензије производа. Упарајте га са FastComments - Reviews Summary за резиме оцена са звездама на врху странице.
Додавање значке са бројем коментара 
Блок FastComments - Број коментара приказује мали број коментара за једну страницу. Користите га у списковима блог постова, картицама производа, или било ком шаблону који води ка страници са коментарима, тако да посетиоци могу видети колико је свака нит активна пре него што кликну.
Додајте блок
- Отворите уређивач Shopify теме.
- Отворите шаблон у ком желите да се број приказује. На пример, Blog шаблон (листa постова) или секција листе производа.
- Кликните Add block у секцији која рендерује сваки елемент.
- Под Apps, изаберите FastComments - Број коментара.
- Кликните Save.
Подешавања
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Пренадгледа са ког FastComments tenant-а бројач чита податке. Оставите празно да бисте користили tenant који је продавница аутоматски конфигурисала. | (празно) |
| Custom URL ID | Замењује идентификатор странице који бројач тражи. Користите ово када је бројач на другој страници од FastComments блока који прати. | (аутоматски детектовано) |
Како се бројач подудара са нити коментара
The Comment Count block uses the same auto-detection logic as the FastComments block:
- Шаблон блог поста:
shopify-article-{article.id} - Шаблон производа:
shopify-product-{product.id} - Други шаблони: the request path
Ако на страници подесите Custom URL ID на FastComments блоку, подесите исти Custom URL ID на FastComments - Број коментара блоку тако да показују на исту нит.
Савети
- Бројеви за сваки елемент на страници дохватају се у једном захтеву, тако да додавање блока на сваки елемент у дугачкој листи не захтева додатне мрежне захтеве.
- Очекиван начин коришћења је један FastComments - Број коментара блок по чланку или производу у листингу; блок можете додати онолико пута колико вам треба.
Додавање фида са недавним коментарима 
The FastComments - Recent Comments block shows the most recent comments across your whole store. Use it to show fresh activity in a sidebar, footer, or homepage section.
Dodajte blok
- Otvorite uređivač tema Shopify-a.
- Otvorite šablon u kojem želite feed. Sekcija bočne trake, početna stranica ili indeks bloga svi su pogodni.
- Kliknite na Add block u sekciji koja treba da ga sadrži.
- Pod Apps, odaberite FastComments - Recent Comments.
- Kliknite na Save.
Podešavanja
| Podešavanje | Šta radi | Podrazumevano |
|---|---|---|
| Tenant ID (optional) | Odredite sa kog FastComments tenant-a feed učitava komentare. Ostavite prazno da biste koristili tenant koji je automatski konfigurisan za prodavnicu. | (prazno) |
| Number of comments | Koliko najnovijih komentara prikazati. Opseg 1 do 50. | 5 |
Saveti
- Svaki komentar vodi na stranicu na kojoj je objavljen, tako da blok istovremeno služi kao naznaka navigacije "o čemu ljudi trenutno pričaju".
- Feed pokriva celu prodavnicu. Da biste prikazali najnovije komentare za pojedinačnu stranicu, umesto toga koristite blok FastComments na toj stranici.
Додавање фида са недавним дискусијама 
The FastComments - Recent Discussions блок наводи странице у вашој продавници са најновијом активношћу коментара, по један унос по страници. Користите га када желите да посетиоци открију активне теме уместо појединачних коментара.
Додајте блок
- Отворите уређивач тема у Shopify-у.
- Отворите шаблон где желите фид, као што су бочни панел, подножје, индекс блога или одељак на почетној страници.
- Кликните Додај блок у одељку који треба да га садржи.
- Под Апликације, изаберите FastComments - Recent Discussions.
- Кликните Сачувај.
Подешавања
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Замењује који FastComments tenant фид чита. Оставите празно да бисте користили аутоматски конфигурисани tenant продавнице. | (празно) |
| Number of comments | Колико најновијих дискусија да се прикаже. Опсег 1 до 50. | 20 |
Recent Discussions vs Recent Comments
Both blocks pull from the same data, but they show different views:
- Recent Comments: равна листа најновијих појединачних коментара. Најбоље за "оно што је управо речено".
- Recent Discussions: по један унос по страници, по редоследу најновије активности. Најбоље за "које теме су тренутно активне".
Можете користити оба на истој продавници. На пример, Recent Comments у бочном панелу блога и Recent Discussions на почетној страници.
Додавање листе најбољих страница 
Блок FastComments - Top Pages наводи странице у вашој продавници са највише активности коментара уопште. Користите га да истакнете највише дискутоване постове или производе.
Додајте блок
- Отворите Shopify уређивач теме.
- Отворите шаблон у који желите листу, на пример бочни панел, подножје или одељак индекса блога.
- Кликните на Add block у одељку који би требало да га садржи.
- Под Apps, изаберите FastComments - Top Pages.
- Кликните на Save.
Подешавања
| Подешавање | Шта ради | Подразумевано |
|---|---|---|
| Tenant ID (optional) | Замените који FastComments tenant се користи за читање листе. Оставите празно да бисте користили tenant који је продавница аутоматски конфигурисала. | (празно) |
Top Pages у односу на Recent Discussions
- Top Pages рангира по укупном ангажману, тако да исти постови обично остају при врху неко време. Погодно за бочни панел „популарни постови“.
- Recent Discussions рангира по најновијој активности, тако да се листа брзо мења. Погодно за панел „шта је сада популарно".
Додавање сажетка рецензија 
The FastComments - Reviews Summary block shows an aggregated star rating and review breakdown for a page. Pair it with the FastComments block on product templates for the standard reviews layout: summary up top, review form and reviews below.
Претпоставка: подесите Ratings & Reviews
The Reviews Summary block displays the rating questions you configured for your store. Set those up first:
- Отворите апликацију FastComments у вашем Shopify администраторском панелу.
- Кликните плочицу Ratings & Reviews Helper (или отворите Ratings & Reviews Helper директно).
- Додајте питања на која желите да сваки рецензент одговори (укупна оцена у звездама, "како је пристајало", итд.).
Without questions configured, the summary block has nothing to aggregate.
Додавање блока
- Отворите уређивач теме у Shopify-у.
- Отворите шаблон Product (или шаблон странице на којој желите сажетак).
- Кликните Add block близу врха секције странице, изнад места где ће бити блок FastComments.
- Испод Apps, изаберите FastComments - Reviews Summary.
- Додајте блок FastComments ниже на истој страници ако то већ нисте урадили, како би посетиоци могли да остављају рецензије.
- Кликните Save.
Подешавања
| Подешавање | Шта ради | Подразумевано |
|---|---|---|
| Tenant ID (optional) | Одредите из којег FastComments tenant-а сажетак преузима податке. Оставите празно да бисте користили tenant који је аутоматски конфигурисан за продавницу. | (blank) |
| Custom URL ID | Одредите идентификатор странице против којег сажетак агрегира податке. Користите ово када се сажетак налази на другој страници од оне на којој је блок FastComments који он одражава. | (auto-detected) |
Како се сажетак поклапа са рецензијама
The Reviews Summary block uses the same auto-detection logic as the FastComments block:
- Шаблон производа:
shopify-product-{product.id} - Шаблон блога:
shopify-article-{article.id} - Остали шаблони: путања захтева
For a normal product page, the summary and the comment thread share a URL ID automatically, with no configuration needed.
Савети
- Сажетак је само за читање. Да бисте прикупили рецензије, потребан вам је блок FastComments на истој страници.
- Ако промените питања за оцењивање у Ratings & Reviews Helper након прикупљања рецензија, сажетак ће се прерачунати у складу са новим скупом питања.
Аутоматско пријављивање Shopify купаца 
Блок FastComments подржава систем једнократног пријављивања (SSO) тако да ваши Shopify купци могу коментарисати као сами себи без креирања посебног FastComments налога.
Како то функционише
Када посетилац који је пријављен у вашу продавницу отвори страницу са блоком FastComments:
- Блок открива Shopify
customerобјекат. - Он шаље име и имејл купца у FastComments преко потписаног app proxy захтева.
- FastComments креира или поклапа корисника кључног имена
shopify-{customerId}, тако да исти купац увек одговара истом FastComments кориснику кроз сесије и поновна инсталирања. - Име посетиоца се појављује на њиховим коментарима. Не тражи им се да се поново пријаве.
Ако посетилац није пријављен у продавницу, блок прелази на анонимно коментарисање (или FastComments ток пријаве, у зависности од конфигурације вашег видгета).
Искључивање SSO
SSO је подразумевано укључен за сваки блок FastComments. Да бисте га искључили на одређеном блоку:
- Отворите Shopify уређивач тема.
- Отворите шаблон који садржи блок и кликните на блок да бисте га изабрали.
- Поништите избор за SSO.
- Кликните на Save.
Искључите SSO ако желите да коментатори одаберу посебан идентитет за разговор. На пример, унутрашња страница заједнице где особље коментарише под другим приказним именом.
Шта FastComments добија
SSO payload који се шаље за сваког купца садржи:
- Кориснички ID изведен из Shopify customer ID (
shopify-{customerId}). - Имејл купца (користи се за идентификацију корисника; не приказује се јавности).
- Приказно име купца (користи се као име аутора коментара).
Ни историја поруџбина, ни подаци о плаћању или адреси нису послати. Тело поруке (payload) је потписано на серверској страни; прегледач купца никада не види креденцијале.
Линкови за пријаву и одјаву
Када је SSO укључен, линкови за пријаву и одјаву у видгету за коментаре упућују на /account/login и /account/logout, стандардне руте Shopify корисничког налога. Нема ништа за конфигурисање. Линкови раде за било коју продавницу која има омогућене корисничке налоге.
Увоз постојећих коментара 
Ако већ имате коментаре на вашим Shopify блог објавама и желите да их сачувате, увезите их у FastComments пре него што онемогућите нативно коментарисање на Shopify-у.
Увоз мора да се покрене док су нативни коментари на Shopify-у још увек активни и видљиви. Када их онемогућите, FastComments их више не може прочитати.
Како започети увоз
- Уверите се да је апликација FastComments инсталирана у вашој продавници.
- За сада оставите нативно коментарисање на Shopify-у укључено.
- Отворите тикет за подршку и обавестите нас које блогове да увеземо.
Увоз траје мање од једног дана.
Када су ваши постојећи коментари у FastComments, додајте FastComments блок у шаблон ваше блог објаве и уклоните или онемогућите нативне коментаре Shopify-ја. Погледајте Додавање коментара на блог објаве и производе.
Ако не морате да сачувате постојеће коментаре, можете прескочити ову страницу.
Прилагођавање 
Боје, фонтови, правила модерације, дозвољени HTML и анонимно коментарисање могу се прилагодити како би одговарали брендингу ваше продавнице.
Отворите FastComments апликацију у вашем Shopify администраторском панелу и кликните на плочицу Прилагоди да бисте отворили екран за прилагођавање видгета. Она користи једнократни линк за пријаву, тако да вам није потребно посебно пријављивање.
За пун списак опција прилагођавања, погледајте Водич за прилагођавања и конфигурацију.
Грешке домена 
Ако сте инсталирали FastComments из Shopify App Store-а, домен ваше продавнице се аутоматски додаје у овлашћене домене тенанта и не бисте требали видети грешку у вези са доменом. Ова страница важи ако сте прошли ручну инсталацију, или ако се ваш продавнички сајт сервира на прилагођеном домену који није био регистрован код Shopify у тренутку када је апликација инсталирана.
Можда ћете добити грешку ауторизације која изгледа овако:
Ово значи да FastComments не препознаје домен на коме се видџет учитава као овлашћен за ваш тенант.
Да бисте то исправили, додајте домен на ваш FastComments налог: Конфигуришите домене.
Ручна инсталација (напредно) 
Ако не можете да инсталирате апликацију из Shopify App Store, и даље можете да додате FastComments уређивањем своје теме. Овај пут је користан када желите да повежете FastComments tenant који већ поседујете, или када уграђујете на Shopify продајни простор где апликација није опција.
Апликацијска инсталација је подржан пут за већину продавница. Користите овај начин само ако апликација није погодна.
Корак 1: Онемогућите уграђене коментаре Shopify-а
У свом Shopify администраторском панелу идите на Blog posts > Manage blogs, отворите сваки блог и у десном панелу подесите Comments are disabled. Сачувајте.
Ово спречава да Shopify-ев уграђени систем коментара буде видљив заједно са FastComments.
Корак 2: Отворите шаблон теме блога
У свом Shopify администраторском панелу:
- Идите на Онлајн продавница > Теме.
- Под вашом текућом темом кликните Акције > Уреди код.
- У прегледачу фајлова са леве стране отворите Sections и кликните
main-article.liquid.
Ово је шаблон који Shopify приказује за појединачну објаву на блогу.
Корак 3: Налепите FastComments исечак
Скролујте до отприлике линије 100 у main-article.liquid, одмах након затварајућег </div> тела чланка. Налепите следећи исечак:

Замените "demo" својим Tenant ID-јем са fastcomments.com/auth/my-account/api-secret. Кликните Сачувај.
Корак 4: Овластите домен ваше продавнице
Отворите објаву на блогу на вашој уживо продавници. Ако уместо видгета за коментаре видите грешку овлашћења, FastComments мора да зна да је вашој продавници дозвољено да користи овај tenant. Погледајте Грешке домена.
Додавање FastComments на друге странице
Исти исечак ради у сваком Liquid шаблону, укључујући странице производа, прилагођене странице и почетну страницу. Налепите га тамо где желите да се коментари појаве и прилагодите urlId ако желите стабилни идентификатор по страници (на пример, urlId: "{{ product.id }}" у шаблону производа).