איך להתקין סוכן ב-WordPress וב-WooCommerce
שלוש דרכים להטמיע קוד ב-WordPress, איך הסוכן קורא את קטלוג WooCommerce, מה לעשות עם תוספי מטמון ואיך לקשר את הצ'אט לעגלת הקניות.
ב-WordPress, קוד ההטמעה מוכנס בשלוש דרכים. בחרו לפי רמת הנוחות שלכם בעריכת קבצי תבנית.
שיטה 1: תוסף להטמעת קוד (מומלץ)#
זו האפשרות הבטוחה ביותר: העריכה לא תאבד בעת עדכון התבנית.
- התקינו כל תוסף להטמעת סקריפטים: WPCode, Insert Headers and Footers, Code Snippets.
- פתחו את הגדרות התוסף ומצאו את השדה המיועד לקוד בפוטר – בדרך כלל הוא נקרא Footer או Body (before closing tag).
- הדביקו את השורה מממשק הניהול ושמרו.
שיטה 2: קובץ התבנית#
- מראה → עורך קבצי תבנית.
- פתחו את
footer.php. - הדביקו את הקוד לפני
</body>. - עדכנו את הקובץ.
חשוב: ערכו את תבנית הבת. בעת עדכון תבנית האב, הקובץ יידרס יחד עם הקוד שלכם.
שיטה 3: דרך functions.php#
למי שמעדיף לעבוד עם קוד. ב-functions.php של תבנית הבת:
add_action('wp_footer', function () {
echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="your-slug" async></script>';
});את שורת הסקריפט המדויקת קחו מממשק הניהול, באמצעות הכפתור “העתק קוד”.
קטלוג מ-WooCommerce#
ציינו את כתובת האתר בהגדרות והפעילו את הניתוח. הסורק קורא את מוצרי WooCommerce דרך נתונים מובנים של העמודים: שם, מחיר, זמינות, תיאור, תמונות, קטגוריות.
מה כדאי לדעת:
- מוצרים עם וריאציות מופיעים בכרטיס המוצר עם טווח מחירים ומאפיינים.
- מוצרים מוסתרים וטיוטות אינם נקראים – וכך צריך להיות.
- מוצרים למשתמשים מחוברים בלבד הסוכן לא יראה: הוא גולש באתר כמבקר רגיל.
- אם יש לכם ייצוא מוצרים ב-CSV, ניתן להעלות אותו בקטע “קטלוג” – לפעמים זה מהיר ומדויק יותר מסריקה.
עגלת קניות ותשלום#
ב-WooCommerce, בדרך כלל לא מפעילים תשלום בצ'אט: לחנות יש קופה משלה עם משלוח, מיסים וקופונים.
ציינו בהגדרות קישור לעגלת הקניות, לרוב https://your-domain/cart או /עגלת-קניות. הסוכן יפנה את הקונה לשם.
כדי לראות אילו דיאלוגים הופכים להזמנות, הוסיפו קטע פיקסל רכישה לעמוד “תודה על ההזמנה”. ב-WooCommerce זהו תבנית checkout/thankyou.php או אותו תוסף להטמעת קוד עם תנאי לעמוד ההזמנה.
כפתור בצ'אט מוסיף מוצר לעגלת הקניות של WooCommerce#
כרטיסי מוצרים בתשובות הסוכן אינם תמונות ליופי בלבד. לכל אחד מהם יש קישור לעמוד המוצר בחנות שלכם, והסוכן יודע להשתמש במנגנון הסטנדרטי של WooCommerce להוספה לעגלת הקניות: כתובת מסוג ?add-to-cart=123.
הקונה לוחץ על הכפתור בצ'אט, המוצר מגיע לעגלת הקניות, ומשם הקופה שלכם עובדת עם כל תוספי המשלוח, הקופונים והמיסים. אין צורך באינטגרציות או מפתחות לכך: המנגנון מובנה ב-WooCommerce מלידה.
אם הקישור מוביל לעמוד מוצר עם וריאציות, הסוכן פותח אותו – הקונה צריך לבחור את המידה והצבע בעצמו, וזה נכון: להציב עבורו אפשרות זה מסוכן.
דבר נוסף שכדאי לדעת: הסוכן רואה את העמוד שבו נפתח הצ'אט. הוא קורא את סימון המוצר – שם, מק"ט, מחיר – ומגיב בהקשר. מבקר עומד על כרטיס מוצר וכותב “יש משהו זול יותר?” – הסוכן מבין למה להשוות ומציע חלופה מהקטלוג שלכם, ולא עצה מופשטת.
הסיבה העיקרית לכך ש“הווידג'ט לא הופיע” ב-WordPress היא מטמון (קאש). לאחר הטמעת הקוד:
- נקו את מטמון התוסף: WP Rocket, W3 Total Cache, LiteSpeed או כל תוסף אחר שמותקן אצלכם.
- נקו את מטמון ה-CDN, אם אתם משתמשים ב-Cloudflare.
- בדקו את האתר במצב גלישה בסתר.
אם בתוסף מופעל “איחוד וטעינה מושהית של סקריפטים”, הוסיפו את הסקריפט שלנו לרשימת ההחרגות: איחוד סקריפטים חיצוניים עלול לפעמים לשבש את הטעינה.
ערכת נושא בהירה וכהה#
הווידג'ט תומך בשתיהן. בהגדרות ניתן לבחור ערכת נושא בהירה, כהה או “כמו של המבקר” – האפשרות האחרונה עוקבת אחר הגדרות המערכת של המכשיר ומוגדרת כברירת מחדל.
זה נוח אם בתבנית ה-WordPress שלכם יש מתג יום ולילה: השאירו “כמו של המבקר”, והצ'אט יתאים למה שהאדם כבר בחר אצלו.
תוספי מטמון#
בדיקה#
- כפתור הצ'אט מופיע בפינה הימנית התחתונה בכל עמוד באתר.
- שאלה על מוצר מציגה כרטיס מוצר עם מחיר.
- כפתור ההזמנה מוביל לעגלת הקניות של WooCommerce.
- בנייד, הכפתור אינו חוסם את התפריט ואת עגלת הקניות.
שאלות נפוצות#
האם נדרש תוסף נפרד של Commerce Agents#
לא. מספיקה שורת קוד אחת, תוסף נפרד אינו נדרש ואינו מותקן.
הווידג'ט לא הופיע, מה לבדוק קודם#
מטמון: תוסף מטמון ו-CDN. לאחר מכן – ודאו שהקוד הוטמע בפוטר, ולא בווידג'ט צדדי שרירותי, ושהתבנית אכן מציגה את wp_footer().
האם הסוכן יידע על הנחות וקופונים#
לגבי קופונים – לא: הם מיושמים בעגלת הקניות של WooCommerce. הסוכן מציג את המחירים שהיו בעת הסריקה, כולל מחיר מבצע, אם הוא מוצג בעמוד המוצר.
האם זה יאט את האתר#
הסקריפט אסינכרוני, שוקל מעט ואינו חוסם את רינדור העמוד. ההשפעה על PageSpeed מינימלית.
האם ניתן להציג את הווידג'ט רק בחנות ולא בבלוג#
כן, אם מטמיעים את הקוד דרך תוסף עם תנאי הצגה או ב-functions.php עם בדיקת is_woocommerce(). במקרה הפשוט, הסוכן בכל העמודים אינו מפריע: הוא עונה גם על שאלות לגבי משלוח מהבלוג.