
Jezik 🇸🇮 Slovenščina
Namestitev
API-ji za štetje komentarjev
FastComments zagotavlja lahke, samostojne pripomočke za štetje komentarjev, ki lahko prikažejo število komentarjev za določene strani ali objave. Ti pripomočki so ločeni od glavnega pripomočka za komentiranje in so zasnovani za uporabo kjerkoli, kjer želite prikazati število komentarjev brez celotnega vmesnika za komentiranje.
Na voljo sta dve vrsti pripomočkov za štetje komentarjev:
- Pripomoček za štetje komentarjev - Za prikaz števila komentarjev na posamezni strani
- Pripomoček za množično štetje komentarjev - Za učinkovito prikazovanje števila komentarjev na več straneh na isti strani
Ta članek pokriva VanillaJS pripomočke. Naše knjižnice za React/Angular/ipd. imajo tudi svoje pripomočke.
Namestitev gradnika za štetje komentarjev 
Pripomoček za štetje komentarjev je zasnovan za prikaz števila komentarjev posamezne strani. Je lahek in zagotavlja posodobitve v realnem času, če je konfiguriran.
Osnovna namestitev
Run 
Možnosti konfiguracije
Funkcija FastCommentsCommentCount sprejema naslednje možnosti konfiguracije:
- tenantId (obvezno): Vaš FastComments ID najemnika
- urlId (neobvezno): Identifikator strani. Privzeto je
window.location.href, če ni določeno - numberOnly (neobvezno): Če je
true, prikaže samo število brez besedila. Privzeto jefalse - isLive (neobvezno): Če je
true, se bo število samodejno posodabljalo. Privzeto jefalse
Napredni primeri
Prilagojen URL ID
Run 
Prikaz samo števila
Run 
Posodobitve v živo
Run 
Metode pripomočka
Pripomoček vrne objekt z naslednjimi metodami:
- destroy(): Odstrani pripomoček in počisti vse časovnike
- update(config): Posodobi pripomoček z novo konfiguracijo
Primer uporabe
Run 
Oblikovanje
Pripomoček prikaže navaden HTML s številom komentarjev in ima minimalno oblikovanje. Videz lahko prilagodite s CSS:
Run 
Množična namestitev gradnikov za štetje komentarjev 
Pripomoček za množično štetje komentarjev je zasnovan za učinkovito prikazovanje števila komentarjev za več strani na isti strani. Namesto posameznih API klicev za vsako število komentarjev, ta pripomoček združuje zahteve za optimalno zmogljivost.
Osnovna namestitev
Run 
Kako deluje
Množični pripomoček deluje tako, da:
- Pregleda stran za elemente z razredom
fast-comments-count - Prebere atribut
data-fast-comments-url-idiz vsakega elementa - Združi API zahteve za učinkovito pridobivanje več števil komentarjev
- Posodobi vsak element z ustreznim številom komentarjev
Možnosti konfiguracije
Funkcija FastCommentsCommentCountBulk sprejema naslednje možnosti konfiguracije:
- tenantId (obvezno): Vaš FastComments ID najemnika
- apiHost (neobvezno): Prilagojen API gostitelj, če uporabljate lastno gostovano instanco
Primer iz resničnega sveta
Tukaj je praktičen primer, ki prikazuje, kako lahko uporabite množični pripomoček v seznamu objav na blogu:
Run 
Premisleki o zmogljivosti
Množični pripomoček samodejno optimizira zmogljivost z:
- Združevanjem zahtev: Več števil komentarjev se pridobi z enim samim API klicem
- Omejitvami velikosti zahtev: Zahteve se samodejno razdelijo, če seznam URL-jev postane predolg (več kot 1.000 znakov)
- Deduplikacijo: Več elementov z istim
data-fast-comments-url-idsi deli isto število
Več elementov z istim URL ID
Na strani lahko imate več elementov z istim data-fast-comments-url-id. Vsi bodo posodobljeni z istim številom:
Run 
Lokalizacija
Množični pripomoček samodejno oblikuje števila komentarjev glede na vaše jezikovne nastavitve FastComments. Zagotavlja ustrezno besedilo za:
- Nič komentarjev
- En komentar
- Več komentarjev
Kdaj uporabiti množični ali posamični pripomoček
Uporabite množični pripomoček, ko:
- Imate več števil komentarjev na isti strani
- Prikazujete seznam objav/člankov s števili komentarjev
- Je zmogljivost pomembna (zmanjšuje API klice)
Uporabite posamični pripomoček, ko:
- Potrebujete le eno število komentarjev na strani
- Potrebujete posodobitve v živo (posamični pripomoček podpira posodobitve v realnem času)
- Želite več nadzora nad vedenjem posameznega pripomočka
API-ji za štetje komentarjev 
Obstaja nekaj koncnih tock za pridobivanje stevil, odvisno od tega, kaj zelite in ali jih zelite pridobiti iz brskalnika, streznika ali z uporabo API SDK.
Javna stevila komentarjev
Javna stevila komentarjev lahko dobite z uporabo zgornjih pripomockov ali z uporabo API-jev, ki jih uporabljajo. Ti API-ji ostajajo nespremenjeni od leta 2019 in se nikoli ne bodo spremenili.

To bo vrnilo strukturo kot:

Lastnost postfix je vedno vkljucena.

To bo vrnilo strukturo kot:

Objekt counts je izpolnjen samo za strani, ki imajo stevila. Zemljevid translations je vedno prisoten, ker se uporablja za pripomoček.
Obnasanje javnih koncnih tock / Predpomnjenje
Javne koncne tocke imajo 60-sekundni mehanizem predpomnjenja za obvladovanje konic v prometu. Interno je to LRU predpomnilnik na nit v pomnilniku streznika, tako da lahko vidite, da se stevila rahlo spreminjajo (narastejo in nato zacasno padejo), ko ljudje pustijo veliko komentarjev.
Javne koncne tocke vedno vrnejo skupno stevilo komentarjev, ne stevila korenskih komentarjev.
API-ji na strani streznika / SDK
Nacin za pridobitev komentarjev s svojega streznika je klic Pages API in pridobitev objekta strani, ki vsebuje skupno stevilo komentarjev in stevilo korenskih komentarjev. Zagotavljamo SDK-je, ki vam omogocajo klic tega API-ja brez rocne konstrukcije API zahteve in zagotavljajo tipizirane vrnjene vrednosti.
Vtičniki za štetje komentarjev FastComments zagotavljajo preprost in učinkovit način za prikaz števila komentarjev na vašem spletnem mestu.
Upamo, da vam je bila ta dokumentacija v pomoč.