
שפה 🇮🇱 עברית
התקנת Shopify
הוספת תגובות לאתרי 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 lists the pages on your store with the most recent comment activity, one entry per page. Use it when you want visitors to discover active threads rather than individual comments.
Add the block
- Open the Shopify theme editor.
- Open the template where you want the feed, such as a sidebar, footer, blog index, or homepage section.
- Click Add block in the section that should hold it.
- Under Apps, select FastComments - Recent Discussions.
- Click Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Override which FastComments tenant the feed reads from. Leave blank to use the store's automatically-configured tenant. | (blank) |
| Number of comments | How many recent discussions to show. Range 1 to 50. | 20 |
Recent Discussions vs Recent Comments
Both blocks pull from the same data, but they show different views:
- Recent Comments: a flat list of the latest individual comments. Best for "what was just said".
- Recent Discussions: one entry per page, ordered by most recent activity. Best for "which threads are alive right now".
You can use both on the same store. For example, Recent Comments in the blog sidebar and Recent Discussions on the home page.
הוספת רשימת הדפים המובילים 
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 supports single sign-on so your Shopify customers can comment as themselves without creating a separate FastComments account.
How it works
When a visitor who is logged into your store opens a page with the FastComments block:
- The block detects the Shopify
customerobject. - It sends the customer's name and email to FastComments through a signed app proxy request.
- FastComments creates or matches a user keyed by
shopify-{customerId}, so the same customer always maps to the same FastComments user across sessions and re-installs. - The visitor's name shows up on their comments. They are not prompted to log in again.
If the visitor is not logged into the store, the block falls back to anonymous commenting (or the FastComments sign-in flow, depending on your widget configuration).
Turning SSO off
SSO is on by default for every FastComments block. To turn it off on a specific block:
- Open the Shopify theme editor.
- Open the template that contains the block and click the block to select it.
- Uncheck SSO.
- Click Save.
Turn SSO off if you want commenters to choose a separate identity for the conversation. For example, an internal community page where staff comment under a different display name.
What FastComments receives
The SSO payload sent for each customer contains:
- A user ID derived from the Shopify customer ID (
shopify-{customerId}). - The customer's email (used to identify the user; not displayed publicly).
- The customer's display name (used as their comment author name).
No order history, payment, or address data is sent. The payload is signed server-side; the customer's browser never sees a credential.
Login and logout links
When SSO is on, the comment widget's sign-in and sign-out links point at /account/login and /account/logout, the standard Shopify customer account routes. There is nothing to configure. The links work for any store with customer accounts enabled.
ייבוא תגובות קיימות 
אם כבר יש לך תגובות בפוסטים של הבלוג ב-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).