פלאגאין WIZSHOP– מתכנתים ומפתחים

תיעוד זה מיועד למתכנתי אתרים / מפתחים אשר מעוניינים לבצע התאמה של תצוגת החנות הדיפולטית לערכת הנושא עימה האתר פועל , או ליצור עיצוב עצמאי לתוסף.

כמו כן מתכנתים יוכלו לבצע הרחבות לתצורת הפלאגאין הדיפולטית וליצור אלמנטים נוספים לחנות.

רכיבים המרכיבים את דף תוצאות החיפוש (search-product.php)

נא לפנות לסעיף הקודם.

תבנית זו זהה לתבנית של דף הפריטים בקטגוריה, היא מציגה את אותם הרכיבים.

Back To Top

עמודים וקבצים הנוצרים בעת ההתקנה

  1. חנות – v-shop.php – דף הראשי של החנות, מכיל תצוגה של הקטגוריות הראשיות עם שם ותמונה.
  2. כניסה למערכת – sign-in.php – התחברות לאתר ללקוחות פרטיים שנרשמו בעבר ואפשרות לשחזר סיסמא.
  3. כניסה למערכת – לקוחות עסקיים – sign-in-b2b.php – התחברות לאתר ללקוחות עסקיים שהוקמו בחשבשבת ואפשרות לשליחת הסיסמה לדוא"ל של הלקוח שהוגדר במשרד האחורי.
  4. רשימת משאלות – wish-list.php – רשימת הפריטים שהמשתמש מעבירה לרשימת המשאלות ואפשרות להעביר אותם לסל הקניות.
  5. קניות קודמות – past-purchases.php – רשימת כל הפריטים שנרכשו ע"י אותו לקוח באתר ואפשרות להעביר אותם לסל הקניות או לסל הקבוע.
  6. סל קבוע – permanent-cart.php – מציג רשימת פריטים שהועברו לסל הקבוע לאחר שנרכשו ואפשרות להעביר אותם לסל הקניות ללא חיפוש.
  7. סל קניות – my-cart.php – מציג את הפריטים שהועברו לסל, אפשרות לשלוח בקשה לשיחה טלפונית מהחנות בנוגע לסל, סכומים, כפתור מעבר להמשך הרכישה.
  8. פרטי התקשרות – cart-call.php – המשתמש באתר ימלא את הפרטים שלו בטופס בדף הזה כאשר הוא מעוניין לשלוח את הסל למשרד האחורי ולהמתין לשיחת טלפון להשלמת ההזמנה.
  9. רכישה – purchase.php – בדף זה המשתמש בוחר את שיטה המשלוח ורואה את סיכום הרכישה שלו לפני שליחת ההזמנה. חלון הסליקה נמצא בדף זה ב-iframe.
  10. פרטי לקוח – user-details.php – טופס הכולל שדות שלקוח פרטי צריך למלא בעת ההרשמה למערכת ושני סוגי הלקוחות צריכים לאשר בעת הרכישה (אלא אם מוגדר אחרת בכלי ניהול).
  11. תרומות – donor-details.php – בדף זה התורם מתחבר למערכת ומזין את סכום התרומה והתשלומים.
  12. פרטי תורם – donor-details.php – רישום למערכת התרומות.

Back To Top

שינוי רכיבי הפריטים והפריט באמצעות פרמטרים

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

filter='#q/חולצה’

[wizshop-element name='products-grid' filter='#q/חולצה’]

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

filter='#q/חולצה’

[wizshop-element name='products-grid' filter='#c/מבצע’]

  • פריט: ניתן להגדיר את מפתח הפריט כפרמטר.

לדוגמא:

אם רוצים להציג ב-sidebar פריט עם המפתח "חולצה ירוקה" יש לקרוא לרכיב באמצעות שורטקוד עם הפרמטר

id=’חולצה ירוקה’

[wizshop-element name='product-item' id='חולצה ירוקה']

ניתן לשלב את סעיפים 2 ו-3 וליצור למשל גריד פריטים מהגריד הרגיל ולמקמו בדף הראשי.

נניח ורוצים להציג גריד פריטים מקטגוריית "מבצעים" ללא כפתור העברה לסל. יש ליצור קובץ PHP חדש המבוסס על products-grid.php אך ללא כפתור ההעברה לסל, לשמור אותו תחת שם אחר, כגון index-grid.php ולקרוא לו באמצעות השורטקוד הבא:

[wizshop-element name='index-grid' filter='#c/מבצעים']

 

Back To Top

רכיבים המרכיבים את דף הפריט (single-product.php)

התבנית של דף הפריט יכולה להציג אחד או יותר מהרכיבים הבאים:

  1. product-item.php – רכיב זה כולל את חלקי הפריט השונים (שם, מקט, תמונה ועוד) ואת הפעולות שניתן לבצע עימו (העברה לסל, הוספה לרשימת המשאלות). הפריט מוצג בהתאם למקט הנמצא בכתובת האתר.
  2. visited-items.php – רכיב המציג את הפריטים בהם המשתמש צפה לאחרונה. ניתן לשלבו בכל עמוד באתר.
  3. product-location.php – רכיב זה מציג את הקטגוריה אליהן הפריט משתייך.

Back To Top

יצירת רכיבים חדשים

ניתן ליצור קובץ PHP חדש עם רכיב/ים מהחנות ולקרוא לו באמצעות שורטקוד. מבנה השורטקוד הוא כדלקמן:

[wizshop-element name='שם הקובץ'’]

לדוגמא –

אם רוצים להציג את רכיב ההתחברות לאתר בצורה מצומצמת בדף הראשי, רק אימייל וסיסמא, בלי אפשרות להרשם או לשחזר סיסמא, יש ליצור קובץ PHP עם החלקים הרצויים ולמקם אותו במחיצה theme-child/wizshop/include/. לאחר מכן יש לקרוא לקובץ באמצעות השורטקוד.

Back To Top

שימוש ברכיבים ברחבי האתר, לא רק בדפים שנוצרים בעת התקנת התוסף

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

Back To Top

הסבר כללי על צורת העבודה עם רכיבי החנות

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

לפני שנעשות התאמות עיצוביות לרכיבי החנות, החנות תוצג עם העיצוב ומבנה ברירת המחדל.

מבנה זה מוצג בצבעים ניטרליים ובתצורה קבועה מראש של הרכיבים.

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

במידה ורוצים לשנות משהו במבנה או עיצוב החנות ניתן לעשות זאת דרך הקבצים הנמצאים ב-FTP של הוורדפרס.

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

ברוב המקרים ניתן להכנס לעריכת הדף ולראות את השורטקוד, פרמטר ה-name מצביע על שם הקובץ.

דוגמא:

השורטקוד:

[wizshop-element name='my-cart' lang='he']

הקובץ:

my-cart.php

יוצאי הדופן הם דף הפריטים בקטגוריה ודף הפריט. כאן לא מדובר על שורטקוד הקורא לקובץ php אלא על דפים דינמיים הבנויים כולם ע"י php חיצוני. פירוט נוסף עליהם בהמשך.

לאחר שמאתרים את הקובץ ומעוניינים לערוך אותו, יש להעתיק אותו למחיצה

theme-child/wizshop/include/

שם הקובץ צריך להישאר זהה למה שהיה, כדי שהמערכת תדע לפנות אליו.

בעותק הקובץ ניתן לעשות את השינויים הרצויים במבנה הרכיב. ניתן לשנות את סדר הרכיבים או את האלמנטים של ה-html, להוסיף Class-ים או ID, אבל חשוב לא למחוק או לשנות מאפיינים (כל מה שמתחיל ב- data-wiz) או משתנים ({{מסולסלים}}).

שינויים בעיצוב (CSS) ניתן להכניס לקובץ style.css אשר נמצא במחיצה

theme-child/wizshop/css

חשוב לציין: רוב רכיבי החנות בנויים בפורמט של שכפול. למשל בדף הפריטים בקטגוריה (products-grid.php) יש בפועל רק תבנית לפריט אחד, התבנית הזו משתכפלת בעת טעינת הדף בהתאם לפריטים שיש בקטגוריה שבה צופים. כנ"ל לגבי סל הקניות – השורות שמייצגות את הפריטים בסל משתכפלות בהתאם לפריטים שיש בסל וכו'.

Back To Top

דפים הנבנים באמצעות תבנית (template)

בעת התקנת התוסף, נוצרת במחיצת התוסף תיקיה בשם templates.

בתיקיה זו ישנם 3 קבצים – דף פריטים, דף פריט ודף תוצאות חיפוש. דפים האלה, בשונה מהקבצים היושבים במחיצת include, לא נכנסים לאזור התוכן של דף הוורדפרס אלא בונים אותו בשלמותו כולל תוכן, sidebar ו – footer.

Back To Top

רכיבים המרכיבים את דף הפריטים בקטגוריה (archive-product.php)

התבנית  של דף הפריטים יכולה להציג אחד או יותר מהרכיבים הבאים:

  1. products-grid.php – רכיב זה מכיל את הפריטים עצמם. הפריטים מוצגים בהתאם לקטגוריה שנבחרה. לא ניתן לראות רכיב זה אלא אם ניגשים אליו דרך קטגוריה של החנות או מקלידים ישירות את כתובת האתר הכולל את שם הקטגוריה.
    ניתן לקחת את רכיב זה ולעצבו בצורת טבלה / שורות או כל דרך אחרת שבה מעוניינים להציג את הפריטים בחנות.
  2. page-items.php – רכיב המאפשר מצד אחד למתכנת האתר להגדיר כמה פריטים מוצגים בדף, ואם הוא בוחר בכך גם מאפשר למשתמש באתר לשנות את ההגדרה הזו לאותו הסשן.
  3. page-navigation.php – רכיב זה מציג את מספרי העמודים של הקטגוריה הנבחרת.
  4. page-sort.php – רכיב המיון של המוצרים. ניתן להגדיר בו את מיון ברירת המחדל שלפיו הפריטים יסתדרו בעת טעינת הקטגוריה ולאפשר למשתמש באתר לשנותו.
  5. products-view.php – רכיב המאפשר מעבר בין תצוגות שונות של המוצרים (גריד, טבלה ועוד), בהתאם להגדרת המתכנת וקיומן של תצוגות נוספות.

Back To Top

שימוש בשורטקודים

תוסף החנות הוירטואלית מבית חשבשבת מאפשר גמישות רבה בשימוש ברכיבי החנות.

גמישות זו מתבטאת במספר דרכים:

Back To Top

רכיבים שאינם עמודי וורדפרס הנוצרים בעת ההתקנה

  1. customer-bar.php  – רכיב זה מכיל את הקישורים לדפי ההתחברות. ברגע שישנו לקוח מחובר, הוא מציג את שם הלקוח, קישורים לעדכון פרטי הלקוח, קניות קודמות, סל קבוע, תרומות והתנתקות הלקוח. מתאים לשימוש בתוך התפריט העליון של האתר.
  2. mini-cart.php – סל קטן המתאים לשימוש בתוך התפריט העליון של האתר. מציג את מספר הפריטים בסל ובעת מעבר עכבר, מציג תצוגה מינימלית של הפריטים עצמם וכפתורים המובילים לסל ולרכישה.
  3. cat.php – רכיב המציג את קטגוריות החנות בפורמט הכולל את  שם הקטגוריה והתמונה שקושרה אליו דרך מסך קטגוריות בוורדפרס.
  4. find-product.php – רכיב חיפוש המציג את שורת החיפוש עם כפתור והשלמה אוטומטית. ניתן למקמו בתפריט העליון או ב-sidebar.
  5. search-location.php – רכיב המציג את מספר הפריטים שנמצאו לאחר החיפוש.

Back To Top