
Γλώσσα 🇬🇷 Ελληνικά
Εγκατάσταση
API πλήθους σχολίων
Widgets πλήθους σχολίων
FastComments παρέχει ελαφριά, αυτόνομα widgets μέτρησης σχολίων που μπορούν να εμφανίζουν τον αριθμό σχολίων για συγκεκριμένες σελίδες ή δημοσιεύσεις. Αυτά τα widgets είναι ξεχωριστά από το κύριο widget σχολιασμού και έχουν σχεδιαστεί για χρήση οπουδήποτε θέλετε να εμφανίσετε αριθμούς σχολίων χωρίς ολόκληρο το περιβάλλον σχολιασμού.
Υπάρχουν δύο τύποι widgets μέτρησης σχολίων διαθέσιμοι:
- Comment Count Widget - Για την εμφάνιση του αριθμού σχολίων μιας μεμονωμένης σελίδας
- Bulk Comment Count Widget - Για την αποδοτική εμφάνιση των αριθμών σχολίων σε πολλές σελίδες στην ίδια σελίδα
Αυτό το άρθρο καλύπτει τα widgets VanillaJS. Οι βιβλιοθήκες μας για React/Angular/κ.λπ. έχουν επίσης τα δικά τους widgets.
Εγκατάσταση Widget πλήθους σχολίων 
Το Comment Count Widget ειναι σχεδιασμενο για την εμφανιση του αριθμου σχολιων μιας μεμονωμενης σελιδας. Ειναι ελαφρυ και παρεχει ενημερωσεις σε πραγματικο χρονο αν ρυθμιστει.
Βασικη Εγκατασταση
Run 
Επιλογες Διαμορφωσης
Η συναρτηση FastCommentsCommentCount δεχεται τις ακολουθες επιλογες διαμορφωσης:
- tenantId (απαιτειται): Το FastComments tenant ID σας
- urlId (προαιρετικο): Ο αναγνωριστης σελιδας. Προεπιλογη ειναι
window.location.hrefαν δεν οριστει - numberOnly (προαιρετικο): Αν
true, εμφανιζει μονο τον αριθμο χωρις κειμενο. Προεπιλογη ειναιfalse - isLive (προαιρετικο): Αν
true, ο αριθμος θα ενημερωνεται αυτοματα. Προεπιλογη ειναιfalse
Προχωρημενα Παραδειγματα
Προσαρμοσμενο URL ID
Run 
Εμφανιση Μονο Αριθμου
Run 
Ζωντανες Ενημερωσεις
Run 
Μεθοδοι Widget
Το widget επιστρεφει ενα αντικειμενο με τις ακολουθες μεθοδους:
- destroy(): Αφαιρει το widget και καθαριζει ολους τους χρονοδιακοπτες
- update(config): Ενημερωνει το widget με νεα διαμορφωση
Παραδειγμα Χρησης
Run 
Στυλ
Το widget αποδιδει απλο HTML με τον αριθμο σχολιων και ερχεται με ελαχιστο στυλ. Μπορειτε να προσαρμοσετε την εμφανιση με CSS:
Run 
Μαζική Εγκατάσταση Widget πλήθους σχολίων 
Το Bulk Comment Count Widget ειναι σχεδιασμενο για την αποτελεσματικη εμφανιση του αριθμου σχολιων για πολλαπλες σελιδες στην ιδια σελιδα. Αντι να κανει μεμονωμενες κλησεις API για καθε αριθμο σχολιων, αυτο το widget ομαδοποιει τα αιτηματα για βελτιστη αποδοση.
Βασικη Εγκατασταση
Run 
Πως Λειτουργει
Το bulk widget λειτουργει:
- Σαρωνοντας τη σελιδα για στοιχεια με την κλαση
fast-comments-count - Διαβαζοντας το χαρακτηριστικο
data-fast-comments-url-idαπο καθε στοιχειο - Ομαδοποιωντας αιτηματα API για αποτελεσματικη ανακτηση πολλαπλων αριθμων σχολιων
- Ενημερωνοντας καθε στοιχειο με τον καταλληλο αριθμο σχολιων
Επιλογες Διαμορφωσης
Η συναρτηση FastCommentsCommentCountBulk δεχεται τις ακολουθες επιλογες διαμορφωσης:
- tenantId (απαιτειται): Το FastComments tenant ID σας
- apiHost (προαιρετικο): Προσαρμοσμενος API host αν χρησιμοποιειτε μια αυτο-φιλοξενουμενη εγκατασταση
Παραδειγμα απο τον Πραγματικο Κοσμο
Εδω ειναι ενα πρακτικο παραδειγμα που δειχνει πως μπορειτε να χρησιμοποιησετε το bulk widget σε μια λιστα αναρτησεων blog:
Run 
Ζητηματα Αποδοσης
Το bulk widget βελτιστοποιει αυτοματα την αποδοση με:
- Ομαδοποιηση αιτηματων: Πολλαπλοι αριθμοι σχολιων ανακτωνται σε μια μονο κληση API
- Ορια μεγεθους αιτηματων: Τα αιτηματα διαχωριζονται αυτοματα αν η λιστα URL γινει πολυ μεγαλη (πανω απο 1.000 χαρακτηρες)
- Αποδιπλασιασμος: Πολλαπλα στοιχεια με το ιδιο
data-fast-comments-url-idμοιραζονται τον ιδιο αριθμο
Πολλαπλα Στοιχεια με το Ιδιο URL ID
Μπορειτε να εχετε πολλαπλα στοιχεια στη σελιδα με το ιδιο data-fast-comments-url-id. Ολα θα ενημερωθουν με τον ιδιο αριθμο:
Run 
Τοπικοποιηση
Το bulk widget μορφοποιει αυτοματα τους αριθμους σχολιων βασει των ρυθμισεων γλωσσας του FastComments. Παρεχει καταλληλο κειμενο για:
- Μηδεν σχολια
- Ενα σχολιο
- Πολλαπλα σχολια
Ποτε να Χρησιμοποιησετε Bulk εναντι Single Widget
Χρησιμοποιηστε το Bulk Widget οταν:
- Εχετε πολλαπλους αριθμους σχολιων στην ιδια σελιδα
- Εμφανιζετε μια λιστα αναρτησεων/αρθρων με αριθμους σχολιων
- Η αποδοση ειναι σημαντικη (μειωνει τις κλησεις API)
Χρησιμοποιηστε το Single Widget οταν:
- Χρειαζεστε μονο εναν αριθμο σχολιων στη σελιδα
- Χρειαζεστε ζωντανες ενημερωσεις (το single widget υποστηριζει ενημερωσεις σε πραγματικο χρονο)
- Θελετε περισσοτερο ελεγχο στη συμπεριφορα του μεμονωμενου widget
API πλήθους σχολίων 
Υπάρχουν μερικά endpoints για τη λήψη των μετρήσεων, ανάλογα με το τι θέλετε και αν θέλετε να τις λάβετε από browser, server ή μέσω του API SDK.
Δημόσιες Μετρήσεις Σχολίων
Μπορείτε να λάβετε τις δημόσιες μετρήσεις σχολίων χρησιμοποιώντας τα widgets παραπάνω ή τα APIs που χρησιμοποιούν. Αυτά τα APIs παραμένουν αμετάβλητα από το 2019 και δεν θα αλλάξουν ποτέ.

Αυτό θα επιστρέψει μια δομή όπως:

Η ιδιότητα postfix περιλαμβάνεται πάντα.

Αυτό θα επιστρέψει μια δομή όπως:

Το αντικείμενο counts συμπληρώνεται μόνο για σελίδες που έχουν μετρήσεις. Ο χάρτης translations είναι πάντα παρών καθώς χρησιμοποιείται για το widget.
Συμπεριφορά Δημόσιων Endpoints / Προσωρινή Αποθήκευση
Τα δημόσια endpoints διαθέτουν μηχανισμό προσωρινής αποθήκευσης 60 δευτερολέπτων για την αντιμετώπιση αιχμών επισκεψιμότητας. Εσωτερικά πρόκειται για LRU cache στη μνήμη ανά νήμα στον server, επομένως ενδέχεται να δείτε τις μετρήσεις να αλλάζουν ελαφρώς (να ανεβαίνουν και να κατεβαίνουν προσωρινά) όταν οι χρήστες αφήνουν πολλά σχόλια.
Τα δημόσια endpoints επιστρέφουν πάντα το συνολικό πλήθος σχολίων, όχι το πλήθος των ριζικών σχολίων.
APIs / SDK Επικεντρωμένα στον Server
Ο τρόπος για να λάβετε σχόλια από τον server σας είναι να καλέσετε το Pages API και να λάβετε το αντικείμενο της σελίδας, το οποίο περιέχει το συνολικό πλήθος σχολίων και το πλήθος των ριζικών σχολίων. Παρέχουμε SDKs που σας επιτρέπουν να καλέσετε αυτό το API χωρίς να κατασκευάσετε χειροκίνητα το αίτημα API, και παρέχουν τυποποιημένες τιμές επιστροφής.
Τα widgets μετρητή σχολίων του FastComments παρέχουν έναν απλό και αποδοτικό τρόπο για να εμφανίζετε τον αριθμό σχολίων σε όλο τον ιστότοπό σας.
Ελπίζουμε ότι βρήκατε αυτήν την τεκμηρίωση χρήσιμη.