למי זה מתאים
בעל עסק קטן שמוכר מוצרים או שירותים דרך אתר וורדפרס, רוצה להציע קופונים דינמיים, לעקוב אחרי השימוש בהם ולשמור על חוויית קנייה חלקה. אם יש לך ידע בסיסי ב‑PHP ו‑Composer, והאתר שלך רץ על אחסון משותף או VPS, המדריך הזה נכתב בדיוק בשבילך.
מה צריך להכין
- אתר וורדפרס פעיל עם גישה לקבצים (FTP/SSH) ולמסד הנתונים.
- שרת שמאפשר הרצת Laravel (PHP ≥ 8.0, Composer, MySQL).
- תוסף “Insert Headers and Footers” או דומה, להוספת קוד JavaScript בוורדפרס.
- חשבון במערכת ניהול קוד (GitHub/Bitbucket) – לא חובה, אבל מומלץ לגיבוי.
- תכנון בסיסי של מבנה הקופון (קוד, אחוז/סכום, תוקף, תנאים).
צעדים
- הקמת פרויקט Laravel – פתח תיקייה חדשה, הרץ `composer create-project laravel/laravel coupon-api` ובדוק שה‑API פועל ב‑`php artisan serve`.
- הגדרת מודל וקונטרולר – צור מודל `Coupon` עם שדות `code`, `discount_type`, `value`, `expires_at`, `usage_limit`. הרץ `php artisan make:model Coupon -m` והוסף מיגרציה מתאימה, לאחר מכן `php artisan make:controller CouponController`.
- בניית API בסיסי – בקונטרולר הוסף פעולות `index`, `store`, `show`, `validateCoupon`. השתמש ב‑`Route::apiResource('coupons', CouponController::class);` בקובץ `api.php`. וודא שה‑API מחזיר JSON עם סטטוס 200 כאשר הקופון תקף, ו‑401 אם אינו תקף.
- הגדרת אימות CORS – בקובץ `cors.php` או דרך middleware, אפשר קריאות מ‑`yourwordpresssite.com` בלבד כדי למנוע גישה חיצונית.
- פריסה ל‑Production – העלה את קבצי Laravel ל‑subdomain נפרד (לדוגמה `api.yoursite.com`) או לתיקייה תחת אותו דומיין. עדכן את קובץ `.env` עם פרטי חיבור למסד הנתונים של וורדפרס (ניתן להשתמש באותו DB).
- הוספת קריאת API בוורדפרס – בעזרת תוסף “Insert Headers and Footers”, הוסף קוד JavaScript שמקשיב לאירוע של שינוי שדה הקופון בטופס הקנייה. הקוד ישלח בקשת POST ל‑`https://api.yoursite.com/api/coupons/validateCoupon` עם הקוד שהוזן, יקבל את התוצאה ויציג הודעה מתאימה למשתמש.
- שמירת שימוש בקופון – לאחר שהקופון אומת, שלח קריאת POST נוספת ל‑`/api/coupons/{id}/use` (תוסיף פעולה ב‑Controller) שתעדכן את `usage_count`. כך תוכל לעקוב אחרי מספר הפעמים שכל קופון נוצל.
- הצגת סטטיסטיקות בממשק ניהול – צור דף אדמין פשוט ב‑Laravel שמציג טבלה של קופונים, מספר שימושים, ותאריך תפוגה. אפשר להוסיף פילטרים לפי תאריך או סוג קופון.
- הגדרת תזכורות אוטומטיות – השתמש ב‑Laravel Scheduler (`php artisan schedule:run`) וב‑Mailables כדי לשלוח מייל ללקוחות עם קופון שמפגין תוקף קרוב. קבע משימה שתופעל כל יום בבוקר.
- בדיקות קצה‑קצה – השתמש ב‑Postman או Insomnia כדי לבדוק את כל ה‑endpoints, וודא שה‑CORS פועל, שה‑validation מחזיר שגיאות נכונות, ושה‑usage limit מתעדכן.
טעויות נפוצות
- לא להפריד את סביבת ה‑API – הרצת Laravel באותו תיקייה של וורדפרס עלולה לגרום לקונפליקטים ב‑.htaccess. עדיף להפריד subdomain או תיקייה ייעודית.
- שכחת לאבטח את ה‑API – חשיפת ה‑endpoints ללא Token או CORS פתוח מאפשרת לכל אחד לנסות קופון. השתמש ב‑Laravel Sanctum או API Token.
- אי‑התאמה של פורמט התאריך – תאריך תפוגה בפורמט `Y-m-d` עלול להיכשל במחשבים שמגדירים אזור זמן שונה. השתמש ב‑Carbon והגדר `timezone` באפליקציה.
- חוסר עדכון השדה `usage_count` – אם לא מוסיפים פעולה שמעדכנת את השימוש, הקופון יישאר פתוח לניצול בלתי מוגבל.
- לא לבצע קאשינג – קריאות API בכל שינוי שדה עלולות להכביד על השרת. השתמש ב‑localStorage או ב‑transient של וורדפרס כדי לשמור תוצאה של קופון שכבר אומת.
סיכום
בנייה של מערכת קופונים חכמה ב‑Laravel והחיבורה לאתר וורדפרס היא משימה ניתנת להשגה אפילו עם משאבים מוגבלים. בעזרת 10 הצעדים הפשוטים למעלה, אתה מקבל API מאובטח, ממשק ניהול ברור, ותזכורות שמגבירות את המרות. זכור להפריד את סביבת Laravel, לאבטח את הקריאות, ולעקוב אחרי שימוש הקופונים – כך תוכל להציע ללקוחות שלך חוויית קנייה ממוקדת, לחסוך זמן ולשפר את הרווחיות של העסק הקטן שלך.
