JS SDK למוצר הביקורות Flashy Reviews

תיאור הפיצ’ר:
החל מהגרסה האחרונה של פלאשי, ניתן למשוך את חוות הדעת שלקוחות מילאו – ישירות דרך ה-API בצד לקוח (Client Side).
הפתרון מיועד ללקוחות שמעוניינים לעצב ולהציג את הביקורות באתרם בעיצוב עצמאי, ללא שימוש בווידג’טים המובנים של פלאשי.

הערה: בעתיד יתווסף גם API בצד שרת (Server Side), אך לצורך הצגה באתר, מומלץ להשתמש ב-Client Side API.


איך זה עובד?

השליפה מתבצעת באמצעות פונקציה ב-JavaScript SDK של פלאשי:

flashy.reviews.get(item_id, total_reviews, page)

פרמטרים:

  1. item_id – מזהה המוצר - 0 לכלל המוצרים או את ה ID של המוצר שתרצו ביקורות עליו
  2. total_reviews – מספר הביקורות שברצונכם לקבל (לדוגמה: 10).
  3. page – מספר העמוד (מתאים לפאג’ינציה; לדוגמה: 1 עבור העמוד הראשון).

דוגמאות שימוש

1. שליפת כלל הביקורות בכל המוצרים:

flashy.reviews.get(0, 10, 1)

הקוד יחזיר עד 10 ביקורות מכלל המוצרים, מהעמוד הראשון.

2. שליפת ביקורות עבור מוצר ספציפי:

flashy.reviews.get(12345, 5, 1)

הקוד יחזיר עד 5 ביקורות של המוצר שמזההו 12345, מהעמוד הראשון.


Promise ו-Async/Await

הפונקציה מחזירה Promise, ולכן ניתן להשתמש ב-then או ב-await.

שימוש עם await:

async function loadReviews() {
  const reviews = await flashy.reviews.get(0, 10, 1);
  console.log(reviews);
}
loadReviews();

שימוש עם then:

flashy.reviews.get(0, 10, 1).then((reviews) => {
  console.log(reviews);
});

💡 טיפים

  • מומלץ להטמיע פאג’ינציה כדי לטעון ביקורות בהדרגה.
  • ודאו שאתם שולפים את ה-item_id הנכון עבור מוצרים ספציפיים.
  • לשמירה על מהירות טעינה, מומלץ להגביל את מספר הביקורות שנשלפות בבת אחת.