WP Manifestindependent plugin directory
manifest / ecommerce / promotion

Promotion Engine

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.

★ 0stars
v0.9.30latest · 23d ago

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/originalconcepts/promotion/archive/refs/heads/main.zip
Updates itself. It ships its own updater, so new versions appear under Dashboard → Updates.

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 צריכה להתבצע על סביבת בדיקה לפני עלייה לפרודקשן.

Releases

1 release.

Tag
Published
v0.9.30 latest
Oct 14, 2026 23d ago

These releases are tags only. The author does not attach a packaged zip, so there are no download counts to report.