אתר WordPress (בלי חנות)

התוסף של Joryio ל-WordPress, Joryio, עובד בכל אתר WordPress - לא צריך WooCommerce. באתר בלי חנות הוא עוקב אחר צפיות בעמודים, שולח ל-Joryio את השליחות של טפסי Contact Form 7 ו-Elementor Pro כאנשי קשר, ומציג את הודעות ה-in-app (חלונות קופצים) וה-Web Push שלכם. זה אותו תוסף שחנות WooCommerce משתמשת בו; יכולות החנות נדלקות רק כש-WooCommerce פעיל (ראו אינטגרציית WooCommerce).

התקנת התוסף

1. ב-Joryio, עברו אל הגדרות → אינטגרציות ופתחו את WooCommerce & WordPress
2. לחצו על הורד תוסף. ההורדה היא תמיד הגרסה העדכנית של התוסף
3. בממשק הניהול של WordPress, עברו אל Plugins → Add New → Upload Plugin, העלו את קובץ ה-zip ולחצו על Install Now
4. לחצו על Activate

כדי לעדכן בהמשך, הורידו שוב את התוסף מאותו דף והעלו אותו באותה דרך; WordPress מציע להחליף את הגרסה המותקנת ושומר את ההגדרות והחיבור.

חיבור

1. באותו דף ב-Joryio, העתיקו את כתובת שרת ולחצו על יצירת מפתח API כדי לקבל את מפתח ה-API (הוא מתחיל ב-jry_wc_ - אותו סוג מפתח שחנות משתמשת בו)
2. בממשק הניהול של WordPress, עברו אל Settings → Joryio (באתר בלי WooCommerce התוסף נמצא תחת Settings, לא תחת WooCommerce)
3. הדביקו את מפתח ה-API, ודאו ש-Server URL היא כתובת ה-API של האזור שלכם (למשל https://api-eu1.joryio.com), ולחצו על Connect

דף ההגדרות מציג אז Connected to Joryio עם שם האתר, כתובת האתר ו-Workspace ID. ב-Joryio, הגדרות → אינטגרציות מציג את החיבור כאתר WordPress, עם מה שהוא שולח ל-Joryio - בלי נתוני חנות ובלי כפתורי סנכרון, כי אין חנות לסנכרן.

מגרסת תוסף 1.6.32 לדף ההגדרות יש ארבע לשוניות: Connection, Tracking & identity, In-app & web push ו-Forms (עד שהאתר מחובר, רק Connection). כל לשונית שומרת רק את ההגדרות שלה, ואחרי שמירה הדף מציג Settings saved..

בכל שאר Joryio האתר הוא אתר WordPress ולא חנות: Settings → Apps ובוררי האפליקציות של הודעות In-App ו-Push מציגים את האפליקציה שלו כ-WordPress, הוא לא נספר בין החנויות המחוברות שלכם, הוא לא מוצע כחנות לתוכניות קופונים, ובדיקות החנות (סנכרון, התאמה מתוזמנת וההתראות שלהן) מדלגות עליו.

מה עובד בלי חנות

יכולת	מה היא עושה	איפה מגדירים
מעקב עמודים	סקריפט המעקב רושם כל ביקור בעמוד כ-Page Viewed, ומקשר את המבקר לאיש קשר כשהוא נותן אימייל (טופס, התחברות, הרשמה)	Settings → Joryio → Tracking & identity → Inject Tracking Script (פעיל כברירת מחדל)
טפסים באתר	שליחות של Contact Form 7 ו-Elementor Pro יוצרות או מעדכנות את איש הקשר ורושמות Form Submitted (ראו טפסים באתר)	Settings → Joryio → Forms, או Actions After Submit של הטופס ב-Elementor
הודעות in-app	מציגות את הודעות ה-in-app (חלונות קופצים) של Joryio, כולל הודעות HTML	Settings → Joryio → In-app & web push (פעיל כברירת מחדל)
Web Push	מאפשר למבקרים להירשם להתראות דפדפן, דרך הודעת in-app של הסכמה ל-Push	Settings → Joryio → In-app & web push → Web push (כבוי כברירת מחדל)

הודעות in-app ו-Web Push עובדות כמו בחנות - ההגדרות, ה-service worker והדרישה שהאתר יהיה בשורש הדומיין עבור Web Push מתוארים בהודעות in-app ו-Web Push.

טפסים באתר

רק השדות שמיפיתם יוצאים מהאתר שלכם. שליחה נשלחת כשיש בה אימייל או טלפון תקינים; שליחה בלי אף אחד מהם לא נשלחת.

Contact Form 7

1. עברו אל Settings → Joryio. הלשונית Forms מציגה את כל טפסי Contact Form 7
2. סמנו Send this form to Joryio
3. בחרו List (לא חובה - בלי רשימה הטופס רק שומר את איש הקשר ואת האירוע)
4. בחרו את מצב List subscription, ובמצב ההסכמה - את שדה ה-acceptance של הטופס
5. מפו כל שדה ל-Email, Phone, First name, Last name, Custom attribute (הקלידו את מפתח המאפיין: אותיות לטיניות קטנות, ספרות וקווים תחתונים) או Do not send. מפו לפחות שדה אימייל או טלפון
6. לחצו על Save form settings. רק מנהל מערכת יכול לשנות את הגדרות הטפסים

Elementor Pro

1. ערכו את הטופס ב-Elementor והוסיפו Joryio תחת Actions After Submit
2. בקטע Joryio, בחרו את ה-List ואת מצב List subscription. במצב ההסכמה, הזינו את Consent field ID - המזהה של שדה ה-Acceptance של הטופס, מהלשונית Advanced של השדה
3. הזינו את מזהי השדות של Email, Phone, First name ו-Last name, ומאפיינים מותאמים בשורה לכל אחד בצורה attribute_key = field_id
4. לחצו על Update

הסכמה

כל שליחה יוצרת או מעדכנת את איש הקשר ורושמת את האירוע Form Submitted. רק ההרשמה לרשימה תלויה במצב של הטופס:

מצב	הרשמה לרשימה
This is a signup form - always subscribe	בכל שליחה
Only when a consent field is ticked (ברירת המחדל)	רק כששדה ההסכמה של הטופס - שדה acceptance של Contact Form 7 או שדה Acceptance של Elementor - מסומן

המאפיין consentGiven של האירוע אומר אם ניתנה הסכמה. תיבה לא מסומנת אף פעם לא מבטלת מינוי של אף אחד. כשהרשימה דורשת אישור כפול (double opt-in), Joryio שולח קודם את אימייל האישור ורושם את איש הקשר כשהוא מאשר; עד אז האירוע מציין את הרשימה ב-listsPending.

מה Joryio רושם

• איש הקשר - טופס של מבקר ממלא אימייל וטלפון רק כשאין לאיש הקשר: הוא אף פעם לא משנה את האימייל או הטלפון של איש קשר קיים. לקוח מחובר יכול לעדכן את הטלפון שלו (תוסף 1.6.34): כשלקוח שמחובר לאתר שלכם שולח טופס והאימייל בטופס שייך לאיש הקשר שלו עצמו, הטלפון שהוקלד בטופס מחליף את הטלפון של איש הקשר. התוסף מוכיח מי מחובר באמצעות הוכחה חתומה שנוצרת בשרת שלכם, ורק עבור טופס שנשלח באתר שלכם; האימייל אף פעם לא משתנה בדרך הזו. טופס Contact Form 7 שנשלח דרך ה-REST API של וורדפרס בלי ה-REST nonce מגיע לוורדפרס כלא מחובר, ולכן חל עליו הכלל של מבקר. השמות והמאפיינים המותאמים שמיפיתם נכתבים לאיש הקשר. איש קשר שנוצר מטופס מוצג עם נוצר דרך: טופס באתר
• האירוע - Form Submitted, עם source (cf7 או elementor), formId, formName, pageUrl, consentGiven, consentText (הנוסח של תיבת ההסכמה שסומנה, החל מתוסף 1.6.31), listsSubscribed, listsPending, ה-email וה-phone של הטופס עצמו (בפורמט שבו איש הקשר שומר אותם, כך שטלפון אחר שמבקר הקליד לא הולך לאיבוד) ו-phoneUpdated כשהטלפון בטופס שונה מזה של איש הקשר - true כשאיש הקשר מחזיק בו עכשיו, false כשאיש הקשר שמר את שלו. חברי צוות שאינם מורשים לראות מידע אישי לא רואים את ערכי האימייל והטלפון, והם נמחקים יחד עם האדם. השתמשו בו כדי להתחיל מסע, להפעיל קמפיין או לבנות סגמנט. שאר הערכים שהוזנו בטופס לא נמצאים על האירוע
• רשומת ההסכמה - כשהטופס רושם את איש הקשר לרשימה, היסטוריית המינויים שומרת את הוכחת ההסכמה: הנוסח המדויק של תיבת ההסכמה שהאדם סימן, העמוד שבו נשלח הטופס (pageUrl), השעה וכתובת ה-IP של המבקר (מוצגת רק לחברי צוות שמורשים לראות מידע אישי). ראו הוכחת הסכמה

הוכחת הסכמה

החל מתוסף 1.6.31, כשהאדם מסמן את שדה ההסכמה של הטופס, התוסף שולח גם את מה שהוא הסכים לו:

• הנוסח - הטקסט הגלוי של שדה ההסכמה: הטקסט של תגית acceptance ב-Contact Form 7 ([acceptance your-consent] I agree to receive news by email [/acceptance]), או ה-Acceptance Text של שדה Acceptance ב-Elementor (ואם אין - התווית שלו). קישורים ועיצוב מוסרים; עד 500 תווים. טקסט שכתבתם מחוץ לתגית ה-acceptance בתבנית של Contact Form 7 לא נשלח - כתבו את הנוסח בתוך התגית. ב-Elementor, השדה הוא זה שמופיע ב-Consent field ID (כל מזהה מותאם אישית), והוא חייב להיות שדה Acceptance
• העמוד, השעה וכתובת ה-IP של השליחה של המבקר

תיבה שלא סומנה לעולם לא שולחת את הנוסח שלה, וטופס הרשמה (בלי תיבה) לא שולח נוסח. ההוכחה נכתבת לרשומת הסכמה רק כשהטופס רושם את איש הקשר לרשימה: עם No list אף אחד לא נרשם, ולכן הנוסח נשאר רק באירוע Form Submitted (consentText; כתובת ה-IP לעולם לא נכתבת לאירוע). ברשימה עם אישור כפול ההוכחה נשמרת עם האישור ונרשמת כשהאדם מאשר.

שליחות אף פעם לא מאטות את המבקר: WordPress שם אותן בתור ושולח אותן ברקע עם WP-Cron, ומנסה שוב כש-Joryio לא זמין. ניסיון חוזר אף פעם לא נספר פעמיים. WP-Cron רץ בביקורים באתר, כך שבאתר עם מעט מאוד תנועה, או כש-WP-Cron כבוי, הריצו אותו מ-cron בשרת.

המדריך המלא לטפסים זהה לזה של חנות: טפסים: Elementor ו-Contact Form 7.

זיהוי המבקר. אימייל שמוקלד בטופס באתר מזהה גם את הדפדפן של המבקר כש-זיהוי מבקרים לפי האימייל שהם מקלידים מופעלת (ברירת המחדל). ההגשה עצמה תמיד עוברת לאיש הקשר עם האימייל הזה.

מה דורש WooCommerce

היכולות האלה דורשות WooCommerce באתר:

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

הוספת WooCommerce בהמשך

אם תתקינו WooCommerce באתר שכבר מחובר, WordPress יציג הודעה שמבקשת להתחבר מחדש. עברו אל WooCommerce → Joryio, לחצו על Disconnect, הדביקו שוב את מפתח ה-API ולחצו על Connect: בחיבור התוסף יוצר את מפתח ה-REST של WooCommerce ש-Joryio צריך, ו-Joryio מתחיל לסנכרן את החנות. הגדרות הטפסים נשמרות. מעכשיו האתר הוא חנות - ראו אינטגרציית WooCommerce.

Joryio גם מזהה את זה בעצמו: ההזמנה, העגלה, המוצר או הלקוח הראשונים שהתוסף שולח אחרי ש-WooCommerce פעיל הופכים את האתר לחנות ב-Joryio (האפליקציה שלו מוצגת שוב כ-WooCommerce והוא נספר כחנות), עוד לפני שהתחברתם מחדש. עד החיבור מחדש העדכונים החיים מגיעים, אבל הסנכרון המלא של החנות ממתין למפתח ה-REST - לכן התחברו מחדש כמתואר למעלה. הסרת WooCommerce בהמשך לא מחזירה את החנות לאתר באופן אוטומטי.