
Sprache 🇩🇪 Deutsch
Installation
Kommentarzähler-APIs
FastComments bietet leichte, eigenständige Kommentarzähler-Widgets, die die Anzahl der Kommentare für bestimmte Seiten oder Beiträge anzeigen können. Diese Widgets sind vom Haupt-Widget für Kommentare getrennt und wurden dafür entwickelt, an beliebigen Stellen eingesetzt zu werden, an denen Sie Kommentaranzahlen anzeigen möchten, ohne die vollständige Kommentaroberfläche.
Es gibt zwei Arten von Kommentarzähler-Widgets:
- Comment Count Widget - Zur Anzeige der Kommentaranzahl einer einzelnen Seite
- Bulk Comment Count Widget - Zur effizienten Anzeige von Kommentaranzahlen für mehrere Seiten auf derselben Seite
Dieser Artikel behandelt die VanillaJS-Widgets. Unsere React/Angular/etc Bibliotheken haben ebenfalls eigene Widgets.
Installation des Kommentarzähler-Widgets 
Das Comment Count Widget ist dafuer konzipiert, die Kommentaranzahl einer einzelnen Seite anzuzeigen. Es ist leichtgewichtig und bietet Echtzeit-Updates, wenn konfiguriert.
Grundlegende Installation
Run 
Konfigurationsoptionen
Die Funktion FastCommentsCommentCount akzeptiert die folgenden Konfigurationsoptionen:
- tenantId (erforderlich): Ihre FastComments Tenant-ID
- urlId (optional): Die Seitenkennung. Standardmaessig
window.location.href, wenn nicht angegeben - numberOnly (optional): Wenn
true, wird nur die Zahl ohne Text angezeigt. Standard istfalse - isLive (optional): Wenn
true, wird die Zaehlung automatisch aktualisiert. Standard istfalse
Fortgeschrittene Beispiele
Benutzerdefinierte URL-ID
Run 
Nur Zahlenanzeige
Run 
Live-Updates
Run 
Widget-Methoden
Das Widget gibt ein Objekt mit den folgenden Methoden zurueck:
- destroy(): Entfernt das Widget und bereinigt alle Timer
- update(config): Aktualisiert das Widget mit einer neuen Konfiguration
Beispielverwendung
Run 
Styling
Das Widget rendert einfaches HTML mit der Kommentaranzahl und kommt mit minimalem Styling. Sie koennen das Aussehen mit CSS anpassen:
Run 
Masseninstallation des Kommentarzähler-Widgets 
Das Bulk Comment Count Widget ist dafuer konzipiert, Kommentarzaehlungen fuer mehrere Seiten effizient auf derselben Seite anzuzeigen. Anstatt individuelle API-Aufrufe fuer jede Kommentarzaehlung zu machen, buendelt dieses Widget Anfragen fuer optimale Leistung.
Grundlegende Installation
Run 
Funktionsweise
Das Bulk-Widget funktioniert durch:
- Scannen der Seite nach Elementen mit der Klasse
fast-comments-count - Lesen des
data-fast-comments-url-idAttributs von jedem Element - Buendeln von API-Anfragen, um mehrere Kommentarzaehlungen effizient abzurufen
- Aktualisieren jedes Elements mit der entsprechenden Kommentarzaehlung
Konfigurationsoptionen
Die Funktion FastCommentsCommentCountBulk akzeptiert die folgenden Konfigurationsoptionen:
- tenantId (erforderlich): Ihre FastComments Tenant-ID
- apiHost (optional): Benutzerdefinierter API-Host, wenn Sie eine selbst gehostete Instanz verwenden
Praxisbeispiel
Hier ist ein praktisches Beispiel, das zeigt, wie Sie das Bulk-Widget in einer Blog-Beitragsliste verwenden koennten:
Run 
Leistungsueberlegungen
Das Bulk-Widget optimiert automatisch die Leistung durch:
- Buendelung von Anfragen: Mehrere Kommentarzaehlungen werden in einem einzigen API-Aufruf abgerufen
- Anforderungsgroessenbeschraenkungen: Anfragen werden automatisch aufgeteilt, wenn die URL-Liste zu gross wird (ueber 1.000 Zeichen)
- Deduplizierung: Mehrere Elemente mit derselben
data-fast-comments-url-idteilen dieselbe Zaehlung
Mehrere Elemente mit derselben URL-ID
Sie koennen mehrere Elemente auf der Seite mit derselben data-fast-comments-url-id haben. Sie werden alle mit derselben Zaehlung aktualisiert:
Run 
Lokalisierung
Das Bulk-Widget formatiert Kommentarzaehlungen automatisch basierend auf Ihren FastComments-Spracheinstellungen. Es bietet passenden Text fuer:
- Null Kommentare
- Einen Kommentar
- Mehrere Kommentare
Wann Bulk vs Single Widget verwenden
Verwenden Sie das Bulk Widget wenn:
- Sie mehrere Kommentarzaehlungen auf derselben Seite haben
- Sie eine Liste von Beitraegen/Artikeln mit Kommentarzaehlungen anzeigen
- Leistung wichtig ist (reduziert API-Aufrufe)
Verwenden Sie das Single Widget wenn:
- Sie nur eine Kommentarzaehlung auf der Seite benoetigen
- Sie Live-Updates benoetigen (das Single-Widget unterstuetzt Echtzeit-Updates)
- Sie mehr Kontrolle ueber das individuelle Widget-Verhalten wuenschen
Kommentarzähler-APIs 
Es gibt mehrere Endpunkte, um die Zaehlungen zu erhalten, je nachdem, was Sie moechten und ob Sie sie von einem Browser, Server oder mit dem API SDK abrufen moechten.
Oeffentliche Kommentarzaehlungen
Sie koennen die oeffentlichen Kommentarzaehlungen mit den oben genannten Widgets oder mit den APIs, die sie verwenden, abrufen. Diese APIs sind seit 2019 unveraendert geblieben und werden sich nie aendern.

Dies gibt eine Struktur wie folgt zurueck:

Die Eigenschaft postfix ist immer enthalten.

Dies gibt eine Struktur wie folgt zurueck:

Das counts-Objekt wird nur fuer Seiten mit Zaehlungen gefuellt. Die translations-Map ist immer vorhanden, da sie fuer das Widget verwendet wird.
Verhalten oeffentlicher Endpunkte / Caching
Die oeffentlichen Endpunkte haben einen 60-Sekunden-Caching-Mechanismus, um Verkehrsspitzen zu bewaeltigen. Intern handelt es sich um einen Pro-Thread-LRU-Cache im Speicher des Servers, sodass Sie moeglicherweise sehen, dass sich die Zaehlungen leicht aendern (steigen und dann voruebergehend sinken), wenn viele Kommentare hinterlassen werden.
Die oeffentlichen Endpunkte geben immer die gesamte Kommentaranzahl zurueck, nicht die Wurzelkommentaranzahl.
Server-seitige APIs / SDK
Der Weg, Kommentare von Ihrem Server zu erhalten, besteht darin, die Pages API aufzurufen und das Seitenobjekt zu erhalten, das die Gesamtkommentaranzahl und die Wurzelkommentaranzahl enthaelt. Wir stellen SDKs bereit, mit denen Sie diese API aufrufen koennen, ohne die API-Anfrage manuell zu erstellen, und die typisierte Rueckgabewerte liefern.
Die FastComments-Kommentarzähler-Widgets bieten eine einfache und effiziente Möglichkeit, Kommentaranzahlen auf Ihrer gesamten Website anzuzeigen.
Wir hoffen, dass Sie diese Dokumentation hilfreich fanden.