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

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

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

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

  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

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

ניתן ליצור קובץ 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

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

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

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

Back To Top