
Језик 🇲🇪 Српски (Црна Гора)
Инсталација Shopify-а
Додавање коментара на Shopify сајтове
FastComments је доступан у Продавници апликација Shopify. Инсталирајте апликацију и додајте FastComments блокове на било који блог пост, страницу производа или прилагођену страницу из уређивача тема у Shopify-ју. Није потребно уређивање кода.
Када инсталирате апликацију, Shopify конфигурише ваш FastComments налог, повезује домен ваше продавнице и аутоматски повезује наплату. Не морате се посебно регистровати на fastcomments.com.
Странице у овом водичу обухватају сваки FastComments блок који апликација пружа, како једнократно пријављивање (single sign-on) функционише за ваше Shopify купце и како увезти постојеће Shopify коментаре пре преласка.
Инсталација FastComments апликације 
Инсталирање преко Shopify App Store
- Отворите FastComments страницу у Shopify App Store.
- Кликните Додај апликацију и изаберите план који желите током инсталације.
- Shopify ће вас преусмерити назад у FastComments админ унутар Shopify када се инсталација заврши.
То је цео процес инсталације. Нема потребе да било шта лепите у фајлове ваше теме.
Шта се подешава за вас
Инсталација извршава све што бисте иначе радили ручно:
- Креира се FastComments tenant за вашу продавницу и повезује се са доменом ваше продавнице.
- URL ваше продавнице се додаје у овлашћене домене tenant-а, тако да се коментари учитавају без грешке у вези домена.
- Записује се
fastcomments.tenant_idshop metafield тако да сваки блок зна против ког tenant-а да рендерује. - Једнократно пријављивање (Single sign-on) за ваше Shopify купце је подразумевано омогућено.
- Наплата се обавља преко Shopify Managed Pricing. Трошкови се појављују на вашем редовном Shopify рачуну. Надоградња, понижавање нивоа или отказивање могуће је у Подешавања > Апликације и канали продаје > FastComments у вашем Shopify админ панелу.
Ако је ваша продавница већ била FastComments корисник пре него што сте инсталирали апликацију, инсталација ће поново користити постојећи tenant уместо да креира нови.
Уграђени админ
Када отворите FastComments апликацију из вашег Shopify админ панела, наићи ћете на контролну таблу са једнокликовим плочицама које воде у пуни FastComments backend:
- Контролна табла: подешавања налога, коришћење и детаљи претплате.
- Ред за модерацију: одобравање, одбијање и одговарање на коментаре широм ваше продавнице.
- Прилагоди: подесите боје видгета, фонтове, правила модерације и конфигурацију.
- Помоћник за оцене и рецензије: подесите звездане оцене и питања за рецензије ако желите да користите блок Reviews Summary.
Свака плочица отвара FastComments са једнократним линком за пријаву, тако да вам није потребна посебна пријава.
Следеће: додајте блокове у вашу продавницу
Отворите уређивач теме у Shopify-ју (Онлајн продавница > Теме > Прилагоди), отворите шаблон у који желите да додате коментаре или рецензије и кликните Додај блок. FastComments блокови ће се појавити под Апликације. Остатак овог водича покрива сваки од њих.
Додавање коментара на блог постове и производе 
Блок FastComments је главни видгет за коментаре. Додајте га у шаблоне блог постова, шаблоне производа или било коју другу страницу на којој желите нит дискусије или разговор уживо.
Додавање блока
- Отворите уређивач тема Shopify-а (Online Store > Themes > Customize).
- Одаберите шаблон на ком желите коментаре: Blog post, Product, или било који други шаблон странице или секције.
- У секцији где желите да се коментари појаве, кликните Add block.
- Под Apps, изаберите FastComments.
- Кликните Save.
Блок се појављује одмах. Нема Tenant ID-а који треба унети; tenant ваше продавнице се аутоматски повезује када инсталирате апликацију.
Подешавања
| Подешавање | Шта ради | Подразумевано |
|---|---|---|
| Tenant ID (опционо) | Омогућава префињавање (override) FastComments tenanta на који се блок односи. Оставите празно да бисте користили tenant који је аутоматски конфигурисан за продавницу. Пронађите ручни Tenant ID на fastcomments.com/auth/my-account/api-secret. | (празно) |
| SSO | Аутоматски пријављује посетиоца као његов Shopify кориснички налог пре коментарисања. Погледајте Аутоматско пријављивање Shopify купаца. | Укључено |
| Commenting Style | Threaded за угнеждене одговоре и гласање, или Streaming за проток разговора уживо у реалном времену. | Threaded |
| Custom URL ID | Прекида аутоматски откривени идентификатор странице. Користите ово када желите да две URL адресе деле исту нит коментара. | (аутоматски откривен) |
Како се бира идентификатор странице
Свака нит коментара је индексирана по URL ID-у. Блок аутоматски бира један:
- Blog post template:
shopify-article-{article.id}, који је стабилан при промјенама slug-а и наслова. - Product template:
shopify-product-{product.id}, који је стабилан при промјенама slug-а и наслова. - Other templates: путања захтева.
Ако подесите Custom URL ID, та вредност ће се користити уместо тога. Користите исти Custom URL ID у више блокова (на пример, на локализованој варијанти странице производа) да бисте делили једну нит коментара.
Threaded vs Streaming
Threaded је подразумевано. Посетиоци одговарају једни другима, гласају, а алати за модерацију раде како се очекује. Најбоље за блог постове и рецензије производа.
Streaming уклања уређеност и приказује нове коментаре у реалном времену како се објављују, као канал ћаскања. Најбоље за лансирања производа, догађаје уживо и странице заједнице.
Више блокова на истој страници
Блок се може додати више пута у исти шаблон. На пример, Резиме рецензија на врху странице производа и FastComments блок на дну. Блокови деле URL ID, тако да резиме одражава коментаре испод.
Савети
- Блок се сакрива у прегледу уређивача тема са жутим обавештењем ако не може да пронађе tenant-а. Ако се то појави у вашој продавници уживо, поново инсталирајте FastComments апликацију.
- За страницу производа, FastComments блок служи и као видгет за рецензије производа. Упарите га са FastComments - Reviews Summary за резиме оцена у звездицама на врху странице.
Додавање ознаке са бројем коментара 
The FastComments - Comment Count block prikazuje mali broj komentara za pojedinačnu stranicu. Koristite ga na listama blog postova, karticama proizvoda ili bilo kojem šablonu koji linkuje na stranicu sa komentarima, tako da posjetioci mogu vidjeti koliko je aktivna svaka nit prije nego što kliknu.
Add the block
- Otvorite Shopify theme editor.
- Otvorite šablon gdje želite da se broj pojavi. Na primjer, Blog template (lista postova) ili sekcija za listanje proizvoda.
- Kliknite Add block u sekciji koja renderuje svaki predmet.
- Pod Apps, izaberite FastComments - Comment Count.
- Kliknite Save.
Settings
| Setting | Šta radi | Default |
|---|---|---|
| Tenant ID (optional) | Prepišite iz kojeg FastComments tenant-a se čita broj. Ostavite prazno da bi koristilo tenant koji je automatski konfigurisan za prodavnicu. | (blank) |
| Custom URL ID | Prepišite identifikator stranice koji se koristi za pretragu broja. Koristite ovo kada je broj na drugoj stranici nego FastComments blok koji prati. | (auto-detected) |
How the count matches the comment thread
Comment Count blok koristi istu logiku automatskog otkrivanja kao FastComments blok:
- Blog post template:
shopify-article-{article.id} - Product template:
shopify-product-{product.id} - Other templates: the request path
Ako postavite Custom URL ID na FastComments bloku na nekoj stranici, postavite isti Custom URL ID na Comment Count bloku tako da pokazuju na istu nit.
Tips
- Brojevi za svaki predmet na stranici se dohvaćaju u jednom zahtjevu, tako da dodavanje bloka za svaki predmet u dugoj listi nema dodatni trošak za round-trip.
- Očekivana upotreba je jedan Comment Count blok po članku ili proizvodu u listi; blok možete dodati onoliko puta koliko želite.
Додавање фида са најновијим коментарима 
Блок FastComments - Recent Comments приказује најновије коментаре у цијелој вашој продавници. Користите га да прикажете свјежу активност у бочној траци, подножју, или одјељку почетне странице.
Додавање блока
- Отворите уређивач тема на Shopify-у.
- Отворите шаблон у којем желите фид. Секција у бочној траци, почетна страница или индекс блога добро функционишу.
- Кликните Add block у секцији која треба да га садржи.
- Под Aplikacije, изаберите FastComments - Recent Comments.
- Кликните Save.
Подешавања
| Подешавање | Шта ради | Подразумевано |
|---|---|---|
| Tenant ID (опционо) | Прекрива који FastComments tenant фид чита. Оставите празно да користи аутоматски конфигурисан tenant продавнице. | (празно) |
| Број коментара | Колико најновијих коментара да се прикаже. Опсег 1 до 50. | 5 |
Савјети
- Сваки коментар води на страницу на којој је објављен, па блок такође дуплира функцију навигационе наznake "о чему људи тренутно причају".
- Фид важи за цијелу продавницу. Да бисте приказали најновије коментаре само за једну страницу, уместо тога употребите блок FastComments на тој страници.
Додавање фида са најновијим дискусијама 
Blok FastComments - Recent Discussions prikazuje stranice u vašoj prodavnici sa najnovijom aktivnošću komentara, po jedan unos po stranici. Koristite ga kada želite da posjetioci otkriju aktivne teme umjesto pojedinačnih komentara.
Dodajte blok
- Otvorite Shopify uređivač teme.
- Otvorite šablon gdje želite feed, na primjer u bočnoj traci, podnožju, indeksu bloga ili sekciji početne stranice.
- Kliknite Add block u sekciji koja bi ga trebala držati.
- Pod Apps, izaberite FastComments - Recent Discussions.
- Kliknite Save.
Postavke
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Prepišite koji FastComments tenant feed čita. Ostavite prazno da biste koristili tenant koji je automatski konfigurisan za prodavnicu. | (prazno) |
| Number of comments | Koliko najnovijih diskusija prikazati. Opseg 1 do 50. | 20 |
Recent Discussions naspram Recent Comments
Oba bloka vuku podatke iz istog izvora, ali prikazuju različite poglede:
- Recent Comments: plošan spisak najnovijih pojedinačnih komentara. Najbolje za "šta je upravo rečeno".
- Recent Discussions: po jedan unos po stranici, poredano po najnovijoj aktivnosti. Najbolje za "koje su teme trenutno žive".
Možete koristiti oba na istoj prodavnici. Na primjer, Recent Comments u bočnoj traci bloga i Recent Discussions na početnoj stranici.
Листа најпосећенијих страница 
The FastComments - Top Pages block lists the pages on your store with the most comment activity overall. Use it to surface your most-discussed posts or products.
Dodajte blok
- Otvorite Shopify uređivač tema.
- Otvorite šablon gde želite listu, na primer u bočnoj traci, podnožju, ili sekciji indeksa bloga.
- Kliknite Dodaj blok u sekciji koja treba da ga sadrži.
- U okviru Aplikacije, izaberite FastComments - Top Pages.
- Kliknite Sačuvaj.
Podešavanja
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (opciono) | Prekrijte koji FastComments tenant lista čita. Ostavite prazno da biste koristili automatski konfigurisan tenant prodavnice. | (prazno) |
Top Pages vs Recent Discussions
- Top Pages rangira po ukupnom angažmanu, tako da iste objave obično ostaju pri vrhu neko vreme. Pogodno za bočnu traku "popularne objave".
- Recent Discussions rangira po najnovijoj aktivnosti, tako da se lista često menja. Pogodno za panel "šta je trenutno popularno".
Сажетак рецензија 
The FastComments - Reviews Summary блок приказује агрегирану оцјену у звјездицама и расподјелу рецензија за страницу. Упарите га са блоком FastComments у шаблонима производа за стандардни изглед рецензија: саже́так на врху, образац за рецензију и рецензије испод.
Prerequisite: set up Ratings & Reviews
Блок Reviews Summary приказује питања за оцјењивање која сте конфигурисали за вашу продавницу. Подесите их прво:
- Отворите апликацију FastComments у свом Shopify администраторском панелу.
- Кликните на плочицу Ratings & Reviews Helper (или отворите Ratings & Reviews Helper директно).
- Додајте питања на која желите да сваки рецензент одговара (укупна оцјена у звјездицама, „како одговара величина“, итд.).
Ако питања нису конфигурисана, блок саже́тка нема шта да агрегира.
Add the block
- Отворите уређивач тема у Shopify-у.
- Отворите шаблон Product (или шаблон странице где желите сажетак).
- Кликните Add block близу врха секције странице, изнад мјеста гдје ће бити блок FastComments.
- Под Apps, одаберите FastComments - Reviews Summary.
- Додајте блок FastComments ниже на истој страници ако то већ нисте урадили, како би посјетиоци могли остављати рецензије.
- Кликните Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Поставља из ког FastComments tenant-а сажетак чита. Оставите празно да користи аутоматски конфигурисани tenant продавнице. | (празно) |
| Custom URL ID | Прекорачује идентификатор странице против којег сажетак агрегира. Користите ово када се сажетак налази на другој страници од блока FastComments који он одражава. | (аутоматски детектовано) |
How the summary matches the reviews
Блок Reviews Summary користи исту логику аутоматског детектовања као и блок FastComments:
- Шаблон производа:
shopify-product-{product.id} - Шаблон чланка:
shopify-article-{article.id} - Остали шаблони: пут захтјева
За уобичајену страницу производа, сажетак и нит коментара аутоматски дијеле исти URL ID, без потребе за додатном конфигурацијом.
Tips
- Сажетак је само за читање. Да бисте прикупљали рецензије, потребан вам је блок FastComments на истој страници.
- Ако промијените питања за оцијене у Ratings & Reviews Helper након прикупљања рецензија, сажетак ће се поново израчунати у односу на нови скуп питања.
Аутоматско пријављивање Shopify купаца 
The FastComments blok podržava jedinstvenu prijavu (SSO) tako da vaši Shopify kupci mogu komentarisati kao oni sami bez kreiranja odvojenog FastComments naloga.
Kako funkcioniše
Kada posjetilac koji je prijavljen u vašu prodavnicu otvori stranicu sa FastComments blokom:
- Blok otkriva Shopify
customerobjekat. - Šalje ime i email kupca FastComments-u putem potpisanog app proxy zahtjeva.
- FastComments kreira ili usklađuje korisnika čiji je ključ
shopify-{customerId}, pa isti kupac uvijek odgovara istom FastComments korisniku kroz sesije i ponovne instalacije. - Ime posjetioca se pojavljuje na njihovim komentarima. Ne traži im se ponovna prijava.
Ako posjetilac nije prijavljen u prodavnicu, blok se vraća na anonimno komentarisanje (ili FastComments tok prijave, u zavisnosti od konfiguracije vašeg widgeta).
Isključivanje SSO-a
SSO je podrazumijevano uključen za svaki FastComments blok. Da biste ga isključili na konkretnom bloku:
- Otvorite Shopify uređivač teme.
- Otvorite šablon koji sadrži blok i kliknite na blok da ga izaberete.
- Odznačite SSO.
- Kliknite Sačuvaj.
Isključite SSO ako želite da komentatori izaberu zasebni identitet za razgovor. Na primjer, interna stranica zajednice na kojoj osoblje komentariše pod drugim prikaznim imenom.
Šta FastComments prima
SSO payload koji se šalje za svakog kupca sadrži:
- ID korisnika izveden iz Shopify customer ID-a (
shopify-{customerId}). - Email kupca (koristi se za identifikaciju korisnika; ne prikazuje se javno).
- Prikazno ime kupca (koristi se kao ime autora njihovog komentara).
Ne šalju se podaci o istoriji narudžbina, plaćanju ili adresi. Payload je potpisan na serverskoj strani; pretraživač kupca nikada ne vidi vjerodajnice.
Linkovi za prijavu i odjavu
Kada je SSO uključen, linkovi za prijavu i odjavu u widgetu za komentare upućuju na /account/login i /account/logout, standardne rute Shopify za naloge kupaca. Nema ništa za konfiguraciju. Linkovi rade za svaku prodavnicu koja ima omogućene korisničke naloge.
Увоз постојећих коментара 
Ako već imate komentare na svojim Shopify blog postovima i želite да их сачувате, уведите их у FastComments пре него што онемогућите Shopify-ev уграђени систем коментара.
Import мора да се покрене док су Shopify-ev уграђени коментари још активни и видљиви. Када их онемогућите, FastComments их више не може прочитати.
Како започети увоз
- Уверите се да је FastComments апликација инсталирана у вашој продавници.
- За сада оставите Shopify-ev уграђени систем коментара омогућен.
- Отворите тикет за подршку и реците нам које блогове треба да унесемо.
Увоз траје мање од једног дана.
Када су ваши постојећи коментари у FastComments, додате FastComments блок у шаблон блог поста и уклоните или онемогућите Shopify-ev уграђени систем коментара. Погледајте Додајте коментаре на блог постове и производе.
Ако не треба да сачувате постојеће коментаре, можете прескочити ову страницу.
Прилагођавање 
Боје, фонтови, правила модерације, дозвољени HTML и анонимно коментарисање могу се подесити тако да одговарају брендингу ваше продавнице.
Отворите апликацију FastComments у вашем Shopify администраторском панелу и кликните на плочицу Прилагоди да отворите екран за прилагођавање виџета. Она користи везу за пријаву за једнократну употребу, па вам није потребно посебно пријављивање.
За пун списак опција прилагођавања, погледајте Водич за прилагођавање и конфигурацију.
Грешке домена 
Ako ste instalirali FastComments iz Shopify App Store-a, domen vaše prodavnice se automatski dodaje u ovlašćene domene tenant-a i ne biste trebali vidjeti grešku u vezi sa domenom. Ova stranica važi ako ste prošli kroz ručni proces instalacije, ili ako je vaša prodavnica hostovana na prilagođenom domenu koji nije bio registrovan kod Shopify u trenutku instalacije aplikacije.
Možete dobiti grešku autorizacije koja izgleda ovako:
Ovo znači da FastComments ne prepoznaje domen na kojem se widget učitava kao ovlašćen za vaš tenant.
Da biste to ispravili, dodajte domen u svoj FastComments nalog: Konfigurišite domene.
Ручна инсталација (напредно) 
Ако не можете да инсталирате апликацију из Shopify App Store app, и даље можете додати FastComments уређивањем ваше теме. Овај пут је користан када желите да повежете FastComments tenant који већ поседујете, или када уграђујете на Shopify продавницу где апликација није опција.
Инсталација преко апликације је подржан пут за већину продавница. Користите овај начин само ако апликација не одговара.
Корак 1: Онемогућите уграђене коментаре Shopify-а
У вашем Shopify администраторском панелу идите на Блог постови > Управљање блоговима, отворите сваки блог и подесите 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. Кликните Save.
Корак 4: Овластите домен ваше продавнице
Отворите пост на блогу на вашој живој продавници. Ако уместо виджета за коментаре видите грешку за ауторизацију, FastComments треба да зна да је вашa продавница овлашћена да користи овај tenant. Види Domain Errors.
Додавање FastComments на друге странице
Исти исјечак ради на било ком Liquid шаблону, укључујући странице производа, прилагођене странице и почетну страницу. Залепите га тамо где желите да се коментари појаве и прилагодите urlId ако желите стабилан идентификатор по страници (на пример, urlId: "{{ product.id }}" на шаблону производа).