
Jezik 🇭🇷 Hrvatski
Instalacija
API-ji za broj komentara
FastComments pruža lagane, samostalne widgete za broj komentara koji mogu prikazati broj komentara za određene stranice ili objave. Ti widgeti su odvojeni od glavnog widgeta za komentiranje i namijenjeni su upotrebi na mjestima na kojima želite prikazati broj komentara bez punog sučelja za komentiranje.
Dostupna su dva tipa widgeta za broj komentara:
- Comment Count Widget - Za prikaz broja komentara jedne stranice
- Bulk Comment Count Widget - Za učinkovito prikazivanje broja komentara za više stranica na istoj stranici
Ovaj članak obuhvaća VanillaJS widgete. Naše React/Angular/itd. biblioteke također imaju vlastite widgete.
Instalacija widgeta za broj komentara 
Widget za brojanje komentara dizajniran je za prikaz broja komentara pojedinacne stranice. Lagan je i pruza azuriranja u stvarnom vremenu ako je konfigurirano.
Osnovna instalacija
Run 
Opcije konfiguracije
Funkcija FastCommentsCommentCount prihvaca sljedece opcije konfiguracije:
- tenantId (obavezno): Vas FastComments tenant ID
- urlId (opcijski): Identifikator stranice. Zadana vrijednost je
window.location.hrefako nije navedeno - numberOnly (opcijski): Ako je
true, prikazuje samo broj bez teksta. Zadano jefalse - isLive (opcijski): Ako je
true, broj ce se automatski azurirati. Zadano jefalse
Napredni primjeri
Prilagodeni URL ID
Run 
Prikaz samo broja
Run 
Azuriranja uzivo
Run 
Metode widgeta
Widget vraca objekt sa sljedecim metodama:
- destroy(): Uklanja widget i cisti sve timere
- update(config): Azurira widget s novom konfiguracijom
Primjer uporabe
Run 
Stiliziranje
Widget prikazuje obican HTML s brojem komentara i dolazi s minimalnim stiliziranjem. Mozete prilagoditi izgled pomocu CSS-a:
Run 
Masovna instalacija widgeta za broj komentara 
Widget za masovno brojanje komentara dizajniran je za ucinkovito prikazivanje brojeva komentara za vise stranica na istoj stranici. Umjesto pojedinacnih API poziva za svaki broj komentara, ovaj widget grupira zahtjeve za optimalnu izvedbu.
Osnovna instalacija
Run 
Kako funkcionira
Masovni widget funkcionira tako da:
- Skenira stranicu za elemente s klasom
fast-comments-count - Cita atribut
data-fast-comments-url-idiz svakog elementa - Grupira API zahtjeve za ucinkovito dohvacanje vise brojeva komentara
- Azurira svaki element s odgovarajucim brojem komentara
Opcije konfiguracije
Funkcija FastCommentsCommentCountBulk prihvaca sljedece opcije konfiguracije:
- tenantId (obavezno): Vas FastComments tenant ID
- apiHost (opcijski): Prilagodeni API host ako koristite vlastitu instancu
Primjer iz stvarnog svijeta
Evo prakticnog primjera koji pokazuje kako mozete koristiti masovni widget u popisu blog postova:
Run 
Razmatranja o izvedbi
Masovni widget automatski optimizira izvedbu pomocu:
- Grupiranja zahtjeva: Vise brojeva komentara dohvaca se u jednom API pozivu
- Ogranicenja velicine zahtjeva: Zahtjevi se automatski dijele ako popis URL-ova postane prevelik (preko 1.000 znakova)
- Deduplikacije: Vise elemenata s istim
data-fast-comments-url-iddijeli isti broj
Vise elemenata s istim URL ID-om
Mozete imati vise elemenata na stranici s istim data-fast-comments-url-id. Svi ce biti azurirani s istim brojem:
Run 
Lokalizacija
Masovni widget automatski formatira brojeve komentara na temelju vasih FastComments jezicnih postavki. Pruza odgovarajuci tekst za:
- Nula komentara
- Jedan komentar
- Vise komentara
Kada koristiti masovni widget naspram pojedinacnog
Koristite masovni widget kada:
- Imate vise brojeva komentara na istoj stranici
- Prikazujete popis postova/clanaka s brojevima komentara
- Izvedba je vazna (smanjuje API pozive)
Koristite pojedinacni widget kada:
- Trebate samo jedan broj komentara na stranici
- Trebate azuriranja uzivo (pojedinacni widget podrzava azuriranja u stvarnom vremenu)
- Zelite vise kontrole nad ponasanjem pojedinacnog widgeta
API-ji za broj komentara 
Postoji nekoliko krajnjih tocaka za dobivanje brojeva, ovisno o tome sto zelite i zelite li ih dobiti iz preglednika, servera ili koristeci API SDK.
Javni brojevi komentara
Mozete dobiti javne brojeve komentara koristeci widgete iznad ili koristeci API-je koje oni koriste. Ovi API-ji ostaju nepromijenjeni od 2019. godine i nikada se nece promijeniti.

Ovo ce vratiti strukturu poput:

Svojstvo postfix je uvijek ukljuceno.

Ovo ce vratiti strukturu poput:

Objekt counts popunjava se samo za stranice koje imaju brojeve. Mapa translations je uvijek prisutna jer se koristi za widget.
Ponasanje javnih krajnjih tocaka / Kesiranje
Javne krajnje tocke imaju 60-sekundni mehanizam kesiranja za rukovanje naglim povecanjem prometa. Interno, ovo je LRU kes po niti u memoriji servera, pa mozete vidjeti da se brojevi malo mijenjaju (rastu pa privremeno padaju) kada ljudi ostavljaju puno komentara.
Javne krajnje tocke uvijek vracaju ukupan broj komentara, a ne broj korijenskih komentara.
Server-side API-ji / SDK
Nacin da dobijete komentare s vaseg servera je da pozovete Pages API i dobijete objekt stranice, koji sadrzi ukupan broj komentara i broj korijenskih komentara. Pruzamo SDK-ove koji vam omogucuju pozivanje ovog API-ja bez rucnog konstruiranja API zahtjeva i pruzaju tipizirane povratne vrijednosti.
FastComments widgeti za broj komentara pružaju jednostavan i učinkovit način za prikaz broja komentara na vašoj web-lokaciji.
Nadamo se da vam je ova dokumentacija bila korisna.