WP Manifestindependent plugin directory
manifest / ecommerce / promotion

Promotion Engine self-updates

A self-contained promotions engine for WooCommerce (% / ₪ discount, Buy X Pay Y, Buy X Get Y). Works standalone, and can sync promotion definitions from Giorgio via API. Display name is a placeholder — rebrand via PROMENG_DISPLAY_NAME.

by Original Concepts · github.com/originalconcepts/promotion · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/originalconcepts/promotion/archive/refs/heads/main.zip

Ships its own WordPress updater (built-in updater), so new versions show up under Dashboard → Updates.

Readme github.com/originalconcepts/promotion ↗

Promotion Engine — תוסף מבצעים ל-WooCommerce

מנוע מבצעים עצמאי ל-WooCommerce, בנוי כך שיתחבר בהמשך ל-Giorgio דרך API. שם התצוגה הוא placeholder — ניתן לשנותו במקום אחד: PROMENG_DISPLAY_NAME בקובץ הראשי.

עיקרון ארכיטקטוני

התוסף הוא המנוע. הוא מחשב מחירים ב-PHP ומחיל אותם על הסל של WooCommerce. הוא לא תלוי ב-Giorgio בזמן ריצה — הקופה ממשיכה לעבוד גם אם Giorgio לא זמין.

ללקוחות Giorgio (שלב 3): הגדרות מבצע ייכנסו מ-Giorgio אל הטבלאות כאן (source = 'giorgio', לקריאה בלבד ב-WP), ואירועי מימוש ידווחו חזרה למעלה כדי שהדשבורד המאוחד ב-Giorgio יכלול את פעילות האתר. כל הקרסים (hooks) לכך כבר במקום: עמודות source / external_id / reported_to_giorgio, ה-cron promeng_giorgio_sync, ו-action ה-promeng_register_types.

מה עובד עכשיו (v0.1)

מבצע מסוג % / ₪ הנחה — מקצה לקצה:

  • יצירה/עריכה/רשימה במסך ניהול ("מבצעים" בתפריט הראשי)
  • מיקוד: כל המוצרים / מוצרים ספציפיים / קטגוריות ספציפיות / כל הסל
  • מוצרים מוחרגים (ל"כל המוצרים" ו"קטגוריות")
  • תנאי קנייה: לפחות X פריטים / מעל X ש"ח
  • אחוז או סכום קבוע
  • תזמון: טווח תאריכים + ימי שבוע
  • הגבלה ללקוח (נאכפת מול טבלת המימושים)
  • תווית "במבצע" / שם המבצע בקטלוג (כשמסומן)
  • הודעת חיסכון בסיכום הסל
  • טוגל סטטוס, שכפול, מחיקה ברשימה
  • רישום מימושים על הזמנה (לבסיס הדשבורד והדיווח ל-Giorgio)

החלה בסל: הנחות פר-שורה דרך set_price, הנחת כל-סל דרך fee שלילי — שני ה-hooks הסטנדרטיים של WooCommerce.

מה עדיין לא (שלבים הבאים)

שלב 2 — סוגי מבצע נוספים + קופונים

  • קנה X שלם Y, קנה X קבל Y (ה-interface וה-engine כבר מוכנים לקלוט אותם)
  • הזנת קוד קופון בקופה ואימותו (כרגע רק מבצעים אוטומטיים מוחלים)
  • הקצאת "הגבל ל X פריטים" לפי החוק הישראלי (כרגע ההנחה חלה על כל היחידות)

שלב 3 — אינטגרציית Giorgio

  • סנכרון הגדרות Giorgio → תוסף
  • דיווח מימושים תוסף → Giorgio
  • חסימת UI היצירה כשמחובר ל-Giorgio (הלוגיקה ל-read-only כבר קיימת)

שלב 4 — ליטוש

  • כל וריאנטי הודעות העידוד/חיסכון מהאפיון (לפני הגעה לכמות, מתנה אוטומטית, פופאפ בחירה)
  • מסך הגדרות (תוספת מעל כמות, הזמנות טלפוניות, מבצע על מוזלים)
  • חוקיות ערימה (stacking) חוצה-מבצעים — ההחלטה העקרונית שדיברנו עליה
  • i18n מלא, בדיקות אוטומטיות

התקנה

  1. דחוס את התיקייה promotion-engine ל-zip (או השתמש ב-zip המצורף).
  2. WP Admin → תוספים → העלאת תוסף → בחר את ה-zip → הפעל.
  3. דורש WooCommerce פעיל.
  4. תפריט "מבצעים" יופיע בצד.

הערה: נבדק לתקינות תחביר (PHP 8.3). בדיקת אינטגרציה חיה מול WooCommerce צריכה להתבצע על סביבת בדיקה לפני עלייה לפרודקשן.