הוספת תגובות לאתרי Shopify
FastComments זמין ב-חנות האפליקציות של Shopify. התקן את האפליקציה והוסף בלוקים של FastComments לכל פוסט בבלוג, דף מוצר או דף מותאם אישית מתוך עורך התבניות של Shopify. אין צורך לערוך קוד.
כאשר אתה מתקין את האפליקציה, Shopify מגדירה את חשבון FastComments שלך, מקשרת את הדומיין של החנות שלך ומחברת את החיוב באופן אוטומטי. אין צורך להירשם ב-fastcomments.com בנפרד.
הדפים במדריך זה מכסים כל בלוק של FastComments שהאפליקציה מספקת, כיצד כניסה יחידה (Single Sign-On) עובדת עבור הלקוחות שלך ב-Shopify, וכיצד לייבא את ההערות הקיימות מ-Shopify לפני המעבר.
התקנת אפליקציית FastComments 
התקנה מ‑Shopify App Store
- פתח את רשימת FastComments ב‑Shopify App Store.
- לחץ על הוסף אפליקציה ובחר את התוכנית שברצונך במהלך תהליך ההתקנה.
- לאחר השלמת ההתקנה Shopify מפנה אותך חזרה לממשק הניהול של FastComments בתוך Shopify.
זהו כל תהליך ההתקנה. אין צורך להדביק דבר בקבצי התבנית שלך.
מה מוגדר עבורך
ההתקנה מריצה את כל מה שהיית עושה ידנית:
- נוצר tenant של FastComments עבור החנות שלך וקושר לדומיין החנות.
- כתובת ה‑URL של החנות שלך מתווספת לדומיינים המורשים של ה‑tenant, כך שהתגובות ייטענו בלי שגיאת דומיין.
- נכתב metafield בחנות בשם
fastcomments.tenant_idכדי שכל בלוק ידע נגד איזה tenant להציג. - כניסה אחידה (Single sign-on) עבור הלקוחות שלך ב‑Shopify מופעלת כברירת מחדל.
- החיוב מתבצע דרך Shopify Managed Pricing. החיובים מופיעים בחשבון Shopify הרגיל שלך. שדרג, הורד או בטל דרך הגדרות > אפליקציות וערוצי מכירה > FastComments בממשק הניהול של Shopify.
אם החנות שלך כבר הייתה לקוח של FastComments לפני שהתקנת את האפליקציה, ההתקנה משתמשת ב‑tenant הקיים במקום ליצור חדש.
הממשק המוטמע
כאשר אתה פותח את אפליקציית FastComments מתוך ממשק הניהול של Shopify, תגיע ללוח שעם אריחים של לחיצה אחת שמקשרים לממשק הניהול המלא של FastComments:
- Dashboard: הגדרות חשבון, שימוש ופרטי המנוי.
- Moderation Queue: אישור, דחייה ותשובה להערות ברחבי החנות.
- Customize: התאמת צבעי הווידג'ט, פונטים, כללי מודרציה וקונפיגורציה.
- Ratings & Reviews Helper: הגדרת דירוגי כוכבים ושאלות סקירה אם ברצונך להשתמש בבלוק סיכום הביקורות.
כל אריח פותח את FastComments בעזרת קישור כניסה לשימוש חד‑פעמי, כך שאין צורך בכניסה נפרדת.
הבא: הוספת בלוקים לחנות שלך
פתח את עורך התבניות של Shopify שלך (חנות מקוונת > ערכות נושא > התאם אישית), פתח את התבנית שבה ברצונך להוסיף תגובות או ביקורות, ולחץ על הוסף בלוק. בלוקי FastComments יופיעו תחת אפליקציות. שאר המדריך זה מכסה כל אחד מהם.
הוספת תגובות לפוסטים בבלוג ולמוצרים
The FastComments block הוא ווידג'ט התגובות הראשי. הוסף אותו לתבניות פוסט בבלוג, תבניות מוצר, או לכל דף אחר שבו תרצה חוט דיון או צ'אט חי.
הוספת הבלוק
- פתח את עורך הנושא של Shopify (חנות מקוונת > ערכות נושא > התאמה אישית).
- בחר את התבנית שבה תרצה שהתראות יופיעו: פוסט בבלוג, מוצר, או כל תבנית דף/חלק אחרת.
- בקטע שבו אתה רוצה שהתראות יופיעו, לחץ על הוסף בלוק.
- תחת אפליקציות, בחר FastComments.
- לחץ על שמור.
הבלוק מופיע מיד. אין צורך להזין Tenant ID; הטננט של החנות שלך מקושר אוטומטית כאשר אתה מתקין את האפליקציה.
הגדרות
| הגדרה | מה זה עושה | ברירת מחדל |
|---|---|---|
| Tenant ID (אופציונלי) | מעביר את ה-Tenant של FastComments שעליו הבלוק מוצג. השאר ריק כדי להשתמש בטננט שהחנות קבעה אוטומטית. ניתן למצוא Tenant ID ידני ב-fastcomments.com/auth/my-account/api-secret. | (ריק) |
| SSO | מבצע הרשמה/כניסה אוטומטית של המבקר לחשבון הלקוח שלו ב-Shopify לפני פרסום תגובה. ראו כניסה אוטומטית ללקוחות Shopify. | מופעל |
| Commenting Style | Threaded עבור תגובות מקוננות והצבעות, או Streaming עבור זרם צ'אט בזמן אמת. | Threaded |
| Custom URL ID | מעביר את מזהה הדף שזוהה אוטומטית. השתמש בזה כשאתה רוצה ששני כתובות URL ישתפו חוט תגובות אחד. | (זוהה אוטומטית) |
כיצד נבחר מזהה הדף
כל חוט תגובות מקושר למזהה URL. הבלוק בוחר אחד באופן אוטומטי:
- תבנית פוסט בבלוג:
shopify-article-{article.id}, אשר יציב גם כאשר הסלאג או הכותרת משתנים. - תבנית מוצר:
shopify-product-{product.id}, אשר יציב גם כאשר הסלאג או הכותרת משתנים. - תבניות אחרות: נתיב הבקשה.
אם תקבע את Custom URL ID, ערך זה ישמש במקום. השתמש באותו Custom URL ID במספר בלוקים (לדוגמה, בגרסה מקומית של דף מוצר) כדי לשתף חוט תגובות אחד.
Threaded מול Streaming
Threaded הוא ברירת המחדל. המבקרים משיבים זה לזה, מצביעים, וכלי המודרציה פועלים כמצופה. מתאים במיוחד לפוסטים בבלוג וביקורות על מוצרים.
Streaming מבטל את ההיררכיה ומציג תגובות חדשות בזמן אמת ככל שמפורסמות, בדומה לזרם צ'אט. מתאים במיוחד להשקות מוצרים, אירועים חיים ודפי קהילה.
מספר בלוקים באותו דף
ניתן להוסיף את הבלוק יותר מפעם אחת לאותה תבנית. לדוגמה, סיכום ביקורות בראש דף מוצר ו-בלוק FastComments בתחתית. הבלוקים משתפים מזהה URL, כך שהסיכום משקף את התגובות שמתחתיו.
טיפים
- הבלוק מסתיר את עצמו בתצוגת העורך של הנושא עם הודעה צהובה אם הוא לא מצליח למצוא טננט. אם זה מופיע בחנות החיה שלך, התקן מחדש את אפליקציית FastComments.
- בדף מוצר, הבלוק של FastComments משמש גם כאשף הביקורות של המוצר. שילב אותו עם FastComments - Reviews Summary לסיכום דירוג כוכבים בחלק העליון של הדף.
הוספת סמל המציג את מספר התגובות
הבלוק FastComments - Comment Count מציג ספירת תגובות קטנה עבור דף בודד. השתמש בו ברשימות פוסטים בבלוג, בכרטיסי מוצרים, או בכל תבנית שמקשרת לדף עם תגובות, כדי שמבקרים יוכלו לראות כמה פעיל כל אשכול לפני שהם נכנסים אליו.
הוספת הבלוק
- פתח את עורך התבנית של Shopify.
- פתח את התבנית שבה תרצה שהספירה תופיע. לדוגמה, תבנית Blog (רשימת הפוסטים) או מקטע רשימת מוצרים.
- לחץ על Add block באזור שמציג כל פריט.
- תחת Apps, בחר ב־FastComments - Comment Count.
- לחץ על Save.
הגדרות
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (אופציונלי) | מעקף את השוכר (tenant) של FastComments ממנו הספירה קוראת. השאר ריק כדי להשתמש בשוכר שהוגדר אוטומטית לחנות. | (ריק) |
| Custom URL ID | מעקף את מזהה הדף שהספירה מחפשת. השתמש בזה כאשר הספירה נמצאת בדף שונה מהבלוק של FastComments שהיא עוקבת אחריו. | (זוהה אוטומטית) |
כיצד הספירה מתאמת לאשכול התגובות
בלוק ספירת התגובות משתמש באותה לוגיקת זיהוי אוטומטי כמו הבלוק FastComments:
- תבנית פוסט בבלוג:
shopify-article-{article.id} - תבנית מוצר:
shopify-product-{product.id} - תבניות אחרות: נתיב הבקשה
אם הגדרת Custom URL ID בבלוק FastComments בעמוד, הגדר את אותו Custom URL ID בבלוק ספירת התגובות כך שהם יפנו לאותו אשכול.
טיפים
- הספירות לכל פריט בעמוד נמשכות בבקשה אחת, כך שהוספת הבלוק לכל פריט ברשימה ארוכה אינה מייצרת קריאות נוספות.
- שימוש צפוי הוא בלוק אחד של ספירת תגובות לכל מאמר או מוצר ברשימה; ניתן להוסיף את הבלוק כמה פעמים שצריך.
הוספת פיד של תגובות אחרונות
הבלוק FastComments - תגובות אחרונות מציג את התגובות האחרונות בכל החנות שלך. השתמש בו כדי להראות פעילות טרייה בסרגל צד, בתחתית הדף, או במדור בעמוד הבית.
הוסף את הבלוק
- פתח את עורך התבניות של Shopify.
- פתח את התבנית שבה ברצונך שהפיד יופיע. מדור בסרגל צד, עמוד הבית או אינדקס הבלוג יתאימו היטב.
- לחץ על Add block במדור שבו הוא אמור להימצא.
- תחת Apps, בחר ב- FastComments - Recent Comments.
- לחץ על Save.
הגדרות
| הגדרה | מה זה עושה | ברירת מחדל |
|---|---|---|
| Tenant ID (optional) | קובע מאיזה tenant של FastComments הפיד יקרא. השאר ריק כדי להשתמש ב-tenant שהוגדר אוטומטית לחנות. | (ריק) |
| Number of comments | כמה תגובות אחרונות להציג. טווח 1 עד 50. | 5 |
טיפים
- כל תגובה מקושרת לעמוד שבו נכתבה, כך שהבלוק משמש גם כהצעת ניווט ל־"על מה אנשים מדברים כרגע".
- הפיד הוא ברמת כל החנות. כדי להציג תגובות אחרונות לעמוד יחיד, השתמש בבלוק FastComments בעמוד המדובר במקום.
הוספת פיד של דיונים אחרונים
The FastComments - Recent Discussions block מציג את הדפים בחנות שלך עם פעילות ההערות העדכנית ביותר, ערך אחד לכל דף. השתמש בו כאשר ברצונך שהמבקרים יגלו שרשורים פעילים במקום הערות בודדות.
הוספת הבלוק
- פתח את עורך ערכת הנושא של Shopify.
- פתח את התבנית שבה אתה רוצה את הפיד, כגון סרגל צד, כותרת תחתונה, אינדקס בלוג, או מקטע בדף הבית.
- לחץ על Add block בחלק שבו הוא צריך להיות.
- תחת Apps, בחר ב-FastComments - Recent Discussions.
- לחץ על Save.
הגדרות
| הגדרה | מה עושה | ברירת מחדל |
|---|---|---|
| Tenant ID (אופציונלי) | עוקף את ה‑tenant של FastComments שממנו הפיד קורא. השאר ריק כדי להשתמש ב‑tenant שהוגדר אוטומטית עבור החנות. | (blank) |
| Number of comments | כמה שיחות עדכניות להציג. טווח 1 עד 50. | 20 |
שיחות עדכניות מול הערות עדכניות
שני הבלוקים מושכים את אותם הנתונים, אך הם מציגים תצוגות שונות:
- Recent Comments: רשימה שטוחה של ההערות הבודדות האחרונות. מתאים ל-"מה שנאמר זה עתה".
- Recent Discussions: ערך אחד לכל דף, ממויין לפי הפעילות העדכנית ביותר. מתאים ל-"אילו שרשורים פעילים כרגע".
אתה יכול להשתמש בשניהם באותה חנות. לדוגמה, Recent Comments בסרגל הצד של הבלוג ו‑Recent Discussions בדף הבית.
הוספת רשימת הדפים המובילים
The FastComments - Top Pages block lists the pages on your store with the most comment activity overall. Use it to surface your most-discussed posts or products.
הוספת הבלוק
- פתח את עורך התבנית של Shopify.
- פתח את התבנית שבה ברצונך שהרשימה תופיע, כגון סרגל צד, תחתית (footer), או מדור אינדקס הבלוג.
- לחץ על Add block בחלק שאמור להכיל אותו.
- תחת Apps, בחר ב-FastComments - Top Pages.
- לחץ על Save.
הגדרות
| הגדרה | מה היא עושה | ברירת מחדל |
|---|---|---|
| Tenant ID (אופציונלי) | לדרוס את ה-tenant של FastComments שממנו הרשימה קוראת. השאר ריק כדי להשתמש ב-tenant שמוגדר אוטומטית לחנות. | (ריק) |
Top Pages לעומת Recent Discussions
- Top Pages מדורג לפי סך המעורבות, כך שפוסטים מסוימים נוטים להישאר קרובים לראש במשך זמן מה. מתאים לסרגל צד של 'פוסטים פופולריים'.
- Recent Discussions מדורג לפי הפעילות האחרונה ביותר, כך שהרשימה מתחלפת תדיר. מתאים לפאנל של 'מה חם כרגע'.
הוספת סיכום ביקורות
The FastComments - Reviews Summary block shows an aggregated star rating and review breakdown for a page. Pair it with the FastComments block on product templates for the standard reviews layout: summary up top, review form and reviews below.
Prerequisite: set up Ratings & Reviews
The Reviews Summary block displays the rating questions you configured for your store. Set those up first:
- Open the FastComments app in your Shopify admin.
- Click the Ratings & Reviews Helper tile (or open Ratings & Reviews Helper directly).
- Add the questions you want each reviewer to answer (overall star rating, "how was the fit", etc.).
Without questions configured, the summary block has nothing to aggregate.
Add the block
- Open the Shopify theme editor.
- Open the Product template (or the page template where you want the summary).
- Click Add block near the top of the page section, above where the FastComments block will be.
- Under Apps, select FastComments - Reviews Summary.
- Add a FastComments block lower on the same page if you haven't already, so visitors can leave reviews.
- Click Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | מגדיר מאיזה tenant של FastComments הבלוק הסיכום קורא. השאר ריק כדי להשתמש ב-tenant שהוגדר אוטומטית לחנות. | (ריק) |
| Custom URL ID | מחליף את מזהה הדף שלפיו הבלוק הסיכום מבצע אגירה. השתמש בכך כאשר הסיכום נמצא בדף שונה מהבלוק FastComments שהוא משקף. | (זוהה אוטומטית) |
How the summary matches the reviews
The Reviews Summary block uses the same auto-detection logic as the FastComments block:
- תבנית מוצר:
shopify-product-{product.id} - תבנית פוסט בבלוג:
shopify-article-{article.id} - תבניות אחרות: נתיב הבקשה
For a normal product page, the summary and the comment thread share a URL ID automatically, with no configuration needed.
Tips
- הסיכום הוא לקריאה בלבד. כדי לאסוף חוות דעת, יש להציב בלוק FastComments באותו דף.
- אם תשנה את שאלות הדירוג ב-Ratings & Reviews Helper לאחר שאספת חוות דעת, הסיכום יחושב מחדש בהתאם לערכת השאלות החדשה.
התחברות אוטומטית של לקוחות Shopify
The FastComments block תומך ב‑single sign-on כך שלקוחות Shopify שלך יכולים להגיב בשם עצמם מבלי ליצור חשבון FastComments נפרד.
איך זה עובד
כאשר מבקר שנכנס לחנות שלך פותח דף עם החלק FastComments:
- החלק מזהה את האובייקט
customerשל Shopify. - הוא שולח את שם הלקוח והדוא"ל שלו ל‑FastComments דרך בקשת פרוקסי חתומה.
- FastComments יוצר או משייך משתמש עם מפתח
shopify-{customerId}, כך שהלקוח זהה תמיד ממופה לאותו משתמש FastComments לאורך סשנים והתקנות מחדש. - שם המבקר מופיע בתגובות שלו. הוא לא מתבקש להתחבר שוב.
אם המבקר אינו מחובר לחנות, החלק חוזר למצב תגובות אנונימיות (או לזרימת ההתחברות של FastComments, בהתאם להגדרות הווידג'ט שלך).
כיבוי SSO
SSO מופעל כברירת מחדל עבור כל חלק FastComments. כדי לכבות אותו בחלק ספציפי:
- פתח את עורך ערכת הנושא של Shopify.
- פתח את התבנית שמכילה את החלק ולחץ על החלק כדי לבחור אותו.
- בטל את הסימון של SSO.
- לחץ על Save.
כבה את SSO אם אתה רוצה שהמגיבים יבחרו זהות נפרדת לשיחה. לדוגמה, דף קהילה פנימי שבו הצוות מגיב תחת שם תצוגה שונה.
מה FastComments מקבל
הנתונים של SSO שנשלחים עבור כל לקוח כוללים:
- מזהה משתמש שמקורו במזהה הלקוח של Shopify (
shopify-{customerId}). - כתובת הדוא"ל של הלקוח (משמשת לזיהוי המשתמש; אינה מוצגת לציבור).
- שם התצוגה של הלקוח (משמש כשם המחבר של התגובה).
לא נשלחת היסטוריית הזמנות, תשלומים או נתוני כתובת. הנתונים נחתמים בצד השרת; הדפדפן של הלקוח לעולם לא רואה אישור.
קישורי כניסה ויציאה
כאשר SSO מופעל, קישורי הכניסה והיציאה של וידג'ט התגובות מצביעים ל‑/account/login ול‑/account/logout, הנתיבים הסטנדרטיים של חשבון הלקוח ב‑Shopify. אין צורך להגדיר דבר. הקישורים פועלים עבור כל חנות עם חשבונות לקוחות מופעלים.
ייבוא תגובות קיימות
אם כבר יש לך תגובות בפוסטים של הבלוג ב-Shopify וברצונך לשמר אותן, ייבא אותן ל-FastComments לפני שתכבה את מערכת התגובות המובנית של Shopify.
הייבוא חייב להתבצע בעוד מערכת התגובות המובנית של Shopify עדיין פעילה ונראית. ברגע שתכבה אותה, FastComments כבר לא יוכל לקרוא את התגובות.
כיצד להתחיל ייבוא
- ודא שאפליקציית FastComments מותקנת בחנות שלך.
- השאר את מערכת התגובות המובנית של Shopify מופעלת בינתיים.
- פתח כרטיס תמיכה והודע לנו אילו בלוגים לייבא.
הייבוא מתבצע בפחות מיום.
לאחר שהתייחסויות/התגובות הקיימות ב-FastComments, הוסף את בלוק ה-FastComments לתבנית פוסט הבלוג שלך והסר או כבה את התגובות המובנות של Shopify. ראה הוספת תגובות לפוסטים ולמוצרים.
אם אינך צריך לשמור את התגובות הקיימות, ניתן לדלג על דף זה.
התאמה אישית
צבעים, גופנים, כללי המודרציה, תגיות HTML המותרות ותגובות אנונימיות ניתנים כולם להתאמה כדי להתאים למיתוג החנות שלך.
פתח את אפליקציית FastComments בממשק הניהול של Shopify ולחץ על האריח התאמה אישית כדי לפתוח את מסך התאמת הווידג'ט. הוא משתמש בקישור התחברות לשימוש יחיד, לכן אין צורך בהתחברות נפרדת.
לרשימה המלאה של אפשרויות ההתאמה, עיין ב-מדריך ההתאמות והתצורה.
שגיאות דומיין
אם התקנת את FastComments מחנות האפליקציות של Shopify, הדומיין של החנות שלך נוסף אוטומטית לדומיינים המורשים של ה-tenant ולא אמורה להופיע שגיאת דומיין. דף זה חל אם ביצעת את נתיב ההתקנה הידני, או אם החזית החנות שלך מוגשת על דומיין מותאם אישית שלא נרשם ב-Shopify בזמן התקנת האפליקציה.
ייתכן שתקבל שגיאת הרשאה שנראית כך:
זה אומר ש-FastComments לא מזהה את הדומיין שעליו הווידג'ט נטען כמאושר עבור ה-tenant שלך.
כדי לתקן זאת, הוסף את הדומיין לחשבון FastComments שלך: Configure Domains.
התקנה ידנית (מתקדם)
אם אינך יכול להתקין את Shopify App Store app, עדיין ניתן להוסיף את FastComments על‑ידי עריכת התבנית (theme) שלך. נתיב זה שימושי כאשר ברצונך לחבר Tenant של FastComments שבבעלותך, או כאשר אתה משלב את המערכת בחנות Shopify שבה האפליקציה אינה אפשרות.
התקנה באמצעות האפליקציה היא הנתיב הנתמך לרוב החנויות. השתמש בדרך זו רק אם האפליקציה אינה מתאימה.
Step 1: Disable Shopify's native comments
בלוח הניהול של Shopify, עבור אל Blog posts > Manage blogs, פתח כל בלוג והגדר Comments are disabled בפאנל הימני. שמור.
זה מונע הצגת מערכת התגובות המובנית של Shopify לצד FastComments.
Step 2: Open the blog theme template
בממשק הניהול של Shopify:
- Go to Online Store > Themes.
- Under your current theme, click Actions > Edit code.
- In the file browser on the left, open Sections and click
main-article.liquid.
This is the template Shopify renders for a single blog article.
Step 3: Paste the FastComments snippet
Scroll to roughly line 100 of main-article.liquid, just after the closing </div> of the article body. Paste the following snippet:
Replace "demo" with your own Tenant ID from fastcomments.com/auth/my-account/api-secret. Click Save.
Step 4: Authorize your shop domain
Open a blog post on your live store. If you see an authorization error instead of the comment widget, FastComments needs to know your store is allowed to use this tenant. See Domain Errors.
Adding FastComments to other pages
The same snippet works on any Liquid template, including product pages, custom pages, and the home page. Paste it where you want comments to appear and adjust urlId if you want a stable identifier per page (for example, urlId: "{{ product.id }}" on a product template).