
שפה 🇮🇱 עברית
התקנה
ממשקי API לספירת תגובות
FastComments מספקת ווידג'טים קלים ועצמאיים לספירת תגובות שיכולים להציג את מספר התגובות לדפים או לפוסטים ספציפיים. ווידג'טים אלה נפרדים מהווידג'ט הראשי של ההערות ומיועדים לשימוש בכל מקום שבו ברצונך להציג ספירת תגובות ללא ממשק ההערות המלא.
ישנם שני סוגים של ווידג'טים לספירת תגובות זמינים:
- ווידג'ט ספירת תגובות - להצגת ספירת התגובות של דף יחיד
- ווידג'ט ספירת תגובות מרובה - להצגה יעילה של ספירות תגובות עבור מספר דפים באותו דף
מאמר זה מכסה את הווידג'טים של VanillaJS. גם הספריות שלנו ל-React/Angular/וכדומה כוללות ווידג'טים משלהן.
התקנת ווידג'ט ספירת תגובות 
וידג'ט ספירת התגובות מעוצב להצגת מספר התגובות של דף יחיד. הוא קל משקל ומספק עדכונים בזמן אמת אם מוגדר.
התקנה בסיסית
Run 
אפשרויות תצורה
הפונקציה FastCommentsCommentCount מקבלת את אפשרויות התצורה הבאות:
- tenantId (נדרש): מזהה הדייר שלך ב-FastComments
- urlId (אופציונלי): מזהה הדף. ברירת מחדל היא
window.location.hrefאם לא צוין - numberOnly (אופציונלי): אם
true, מציג רק את המספר ללא טקסט. ברירת מחדל היאfalse - isLive (אופציונלי): אם
true, הספירה תתעדכן אוטומטית. ברירת מחדל היאfalse
דוגמאות מתקדמות
URL ID מותאם אישית
Run 
הצגת מספר בלבד
Run 
עדכונים חיים
Run 
שיטות הוידג'ט
הוידג'ט מחזיר אובייקט עם השיטות הבאות:
- destroy(): מסיר את הוידג'ט ומנקה את כל הטיימרים
- update(config): מעדכן את הוידג'ט עם תצורה חדשה
דוגמת שימוש
Run 
עיצוב
הוידג'ט מרנדר HTML פשוט עם ספירת התגובות ומגיע עם עיצוב מינימלי. אתה יכול להתאים אישית את המראה עם CSS:
Run 
התקנת אצווה של ווידג'טים לספירת תגובות 
וידג'ט ספירת התגובות המרובות מעוצב להצגה יעילה של ספירות תגובות עבור דפים מרובים באותו דף. במקום לבצע קריאות API בודדות לכל ספירת תגובות, וידג'ט זה מקבץ בקשות לביצועים אופטימליים.
התקנה בסיסית
Run 
איך זה עובד
הוידג'ט המרובה עובד על ידי:
- סריקת הדף לאיתור אלמנטים עם המחלקה
fast-comments-count - קריאת התכונה
data-fast-comments-url-idמכל אלמנט - קיבוץ בקשות API לשליפת ספירות תגובות מרובות ביעילות
- עדכון כל אלמנט עם ספירת התגובות המתאימה
אפשרויות תצורה
הפונקציה FastCommentsCommentCountBulk מקבלת את אפשרויות התצורה הבאות:
- tenantId (נדרש): מזהה הדייר שלך ב-FastComments
- apiHost (אופציונלי): מארח API מותאם אישית אם אתה משתמש במופע מתארח עצמאית
דוגמה מהעולם האמיתי
הנה דוגמה מעשית המראה כיצד תוכל להשתמש בוידג'ט המרובה ברשימת פוסטים בבלוג:
Run 
שיקולי ביצועים
הוידג'ט המרובה מייעל אוטומטית את הביצועים על ידי:
- קיבוץ בקשות: ספירות תגובות מרובות נשלפות בקריאת API יחידה
- מגבלות גודל בקשה: בקשות מתפצלות אוטומטית אם רשימת ה-URL הופכת גדולה מדי (מעל 1,000 תווים)
- ביטול כפילויות: אלמנטים מרובים עם אותו
data-fast-comments-url-idחולקים את אותה ספירה
אלמנטים מרובים עם אותו URL ID
אתה יכול לקבל אלמנטים מרובים בדף עם אותו data-fast-comments-url-id. כולם יעודכנו עם אותה ספירה:
Run 
לוקליזציה
הוידג'ט המרובה מעצב אוטומטית ספירות תגובות בהתבסס על הגדרות השפה שלך ב-FastComments. הוא מספק טקסט מתאים עבור:
- אפס תגובות
- תגובה אחת
- תגובות מרובות
מתי להשתמש בוידג'ט מרובה לעומת וידג'ט בודד
השתמש בוידג'ט המרובה כאשר:
- יש לך ספירות תגובות מרובות באותו דף
- אתה מציג רשימת פוסטים/מאמרים עם ספירות תגובות
- הביצועים חשובים (מפחית קריאות API)
השתמש בוידג'ט הבודד כאשר:
- אתה צריך רק ספירת תגובות אחת בדף
- אתה צריך עדכונים חיים (הוידג'ט הבודד תומך בעדכונים בזמן אמת)
- אתה רוצה יותר שליטה על התנהגות הוידג'ט הבודד
ממשקי API לספירת תגובות 
ישנן מספר נקודות קצה לקבלת הספירות, בהתאם למה שאתה רוצה ואם אתה רוצה לקבל אותן מדפדפן, שרת או באמצעות ה-API SDK.
ספירות תגובות ציבוריות
אתה יכול לקבל את ספירות התגובות הציבוריות באמצעות הווידג'טים למעלה או באמצעות ה-APIs שהם משתמשים בהם. APIs אלה נשארו ללא שינוי מאז 2019 ולעולם לא ישתנו.

זה יחזיר מבנה כמו:

המאפיין postfix תמיד כלול.

זה יחזיר מבנה כמו:

האובייקט counts מאוכלס רק עבור דפים שיש להם ספירות. המפה translations תמיד נוכחת מכיוון שהיא משמשת לווידג'ט.
התנהגות נקודות קצה ציבוריות / מטמון
לנקודות הקצה הציבוריות יש מנגנון מטמון של 60 שניות לטיפול בעומסי תנועה. באופן פנימי זהו מטמון LRU לכל תהליכון בזיכרון בשרת, כך שאתה עשוי לראות שהספירות משתנות מעט (עולות ואז יורדות זמנית) כאשר אנשים משאירים הרבה תגובות.
נקודות הקצה הציבוריות תמיד מחזירות את ספירת התגובות הכוללת, לא את ספירת תגובות השורש.
APIs בצד השרת / SDK
הדרך לקבל תגובות מהשרת שלך היא לקרוא ל-Pages API ולקבל את אובייקט הדף, שמכיל את ספירת התגובות הכוללת וספירת תגובות השורש. אנו מספקים SDKs שמאפשרים לך לקרוא ל-API זה מבלי לבנות את בקשת ה-API ידנית ומספקים ערכי החזרה מוקלדים.
ווידג'טים של FastComments לספירת תגובות מספקים דרך פשוטה ויעילה להצגת ספירות תגובות ברחבי האתר שלך.
אנו מקווים שמצאתם את התיעוד הזה מועיל.