
Dil 🇹🇷 Türkçe
Kurulum
Yorum Sayısı API'leri
FastComments, belirli sayfalar veya gönderiler için yorum sayısını görüntüleyebilen hafif, bağımsız yorum sayısı bileşenleri sağlar. Bu bileşenler ana yorum bileşeninden ayrı olup, tam yorum arayüzü olmadan yorum sayılarını göstermek istediğiniz her yerde kullanılmak üzere tasarlanmıştır.
Mevcut iki tür yorum sayısı bileşeni vardır:
- Comment Count Widget - Tek bir sayfanın yorum sayısını görüntülemek için
- Bulk Comment Count Widget - Aynı sayfada birden çok sayfanın yorum sayılarını verimli şekilde görüntülemek için
Bu makale VanillaJS bileşenlerini kapsar. Our React/Angular/etc libraries also have their own widgets.
Yorum Sayısı Widget'ı Kurulumu 
Yorum Sayisi Widget'i, tek bir sayfanin yorum sayisini gostermek icin tasarlanmistir. Hafiftir ve yapilandirilirsa gercek zamanli guncellemeler saglar.
Temel Kurulum
Run 
Yapilandirma Secenekleri
FastCommentsCommentCount fonksiyonu asagidaki yapilandirma seceneklerini kabul eder:
- tenantId (zorunlu): FastComments kiraci kimliginiz
- urlId (istege bagli): Sayfa tanimlayicisi. Belirtilmezse varsayilan olarak
window.location.href - numberOnly (istege bagli):
trueise, metin olmadan yalnizca sayi gosterir. Varsayilanfalse - isLive (istege bagli):
trueise, sayi otomatik olarak guncellenecektir. Varsayilanfalse
Gelismis Ornekler
Ozel URL ID
Run 
Yalnizca Sayi Gosterimi
Run 
Canli Guncellemeler
Run 
Widget Metodlari
Widget asagidaki metodlara sahip bir nesne dondurur:
- destroy(): Widget'i kaldirir ve tum zamanlayicilari temizler
- update(config): Widget'i yeni bir yapilandirmayla gunceller
Kullanim Ornegi
Run 
Stillendirme
Widget, yorum sayisiyla duz HTML olusturur ve minimal stillendirme ile gelir. Gorunumu CSS ile ozellesitirebilirsiniz:
Run 
Toplu Yorum Sayısı Widget'ı Kurulumu 
Toplu Yorum Sayisi Widget'i, ayni sayfada birden fazla sayfa icin yorum sayilarini verimli bir sekilde gostermek uzere tasarlanmistir. Her yorum sayisi icin ayri API cagrilari yapmak yerine, bu widget en iyi performans icin istekleri gruplar.
Temel Kurulum
Run 
Nasil Calisir
Toplu widget su sekilde calisir:
fast-comments-countsinifina sahip ogeler icin sayfayi tarar- Her ogeden
data-fast-comments-url-idozelligini okur - Birden fazla yorum sayisini verimli bir sekilde almak icin API isteklerini gruplar
- Her ogeyi uygun yorum sayisiyla gunceller
Yapilandirma Secenekleri
FastCommentsCommentCountBulk fonksiyonu asagidaki yapilandirma seceneklerini kabul eder:
- tenantId (zorunlu): FastComments kiraci kimliginiz
- apiHost (istege bagli): Kendi barindirdiginiz bir ornek kullaniyorsaniz ozel API ana bilgisayari
Gercek Dunya Ornegi
Iste toplu widget'i bir blog yazisi listesinde nasil kullanabileceginizi gosteren pratik bir ornek:
Run 
Performans Degerlendirmeleri
Toplu widget asagidakiler araciligiyla performansi otomatik olarak optimize eder:
- Istek gruplama: Birden fazla yorum sayisi tek bir API cagrisinda alinir
- Istek boyutu sinirlari: URL listesi cok uzun olursa (1.000 karakterden fazla) istekler otomatik olarak bolunur
- Tekrarlari kaldirma: Ayni
data-fast-comments-url-iddegerine sahip birden fazla oge ayni sayiyi paylasir
Ayni URL ID'li Birden Fazla Oge
Sayfada ayni data-fast-comments-url-id degerine sahip birden fazla ogeniz olabilir. Hepsi ayni sayiyla guncellenecektir:
Run 
Yerellesirme
Toplu widget, FastComments dil ayarlariniza gore yorum sayilarini otomatik olarak biçimlendirir. Asagidakiler icin uygun metin saglar:
- Sifir yorum
- Bir yorum
- Birden fazla yorum
Toplu ve Tekli Widget Ne Zaman Kullanilir
Toplu Widget'i su durumlarda kullanin:
- Ayni sayfada birden fazla yorum sayiniz var
- Yorum sayilariyla birlikte bir yazi/makale listesi gosteriyorsunuz
- Performans onemli (API cagrilarini azaltir)
Tekli Widget'i su durumlarda kullanin:
- Sayfada yalnizca bir yorum sayisina ihtiyaciniz var
- Canli guncellemelere ihtiyaciniz var (tekli widget gercek zamanli guncellemeleri destekler)
- Bireysel widget davranisi uzerinde daha fazla kontrol istiyorsunuz
Yorum Sayısı API'leri 
Sayilari almak icin birkac endpoint vardir, ne istediginize ve bunlari bir tarayicidan, sunucudan veya API SDK kullanarak almak isteyip istemediginize bagli olarak.
Genel Yorum Sayilari
Yukaridaki widget'lari kullanarak veya onlarin kullandigi API'leri kullanarak genel yorum sayilarini alabilirsiniz. Bu API'ler 2019'dan beri degismeden kalmistir ve asla degismeyecektir.

Bu, su sekilde bir yapi dondurecektir:

postfix ozelligi her zaman dahildir.

Bu, su sekilde bir yapi dondurecektir:

counts nesnesi yalnizca sayilari olan sayfalar icin doldurulur. translations haritasi widget icin kullanildigi icin her zaman mevcuttur.
Genel Endpoint Davranisi / Onbellekleme
Genel endpoint'ler trafik artislarini yonetmek icin 60 saniyelik bir onbellekleme mekanizmasina sahiptir. Dahili olarak bu, sunucudaki bellekte is parcacigi basina bir LRU onbellegidir, bu nedenle insanlar cok sayida yorum biraktiginda sayilarin hafifce degistigini (yukselip sonra gecici olarak dustugunu) gorebilirsiniz.
Genel endpoint'ler her zaman kok yorum sayisini degil, toplam yorum sayisini dondurur.
Sunucu Tarafi API'leri / SDK
Sunucunuzdan yorum almanin yolu, Pages API'yi cagirmak ve toplam yorum sayisini ve kok yorum sayisini iceren sayfa nesnesini almaktir. API istegini manuel olarak olusturmadan bu API'yi cagirmaniza olanak taniyan ve tipli donus degerleri saglayan SDK'lar sunuyoruz.
FastComments yorum sayacı widget'ları sitenizin genelinde yorum sayılarını görüntülemek için basit ve verimli bir yol sağlar.
Bu dokümantasyonu faydalı bulduğunuzu umuyoruz.