Inštalácia

Pridajte balík cez Composer, potom publikujte a spustite migrácie. Service provider sa zaregistruje automaticky a money-for-laravel aj package-toolkit-for-laravel sa nainštalujú ako závislosti — bez manuálnej registrácie:

composer require roundly-consulting/coupons-for-laravel

php artisan vendor:publish --tag="coupons-migrations"
php artisan migrate

Migrácie sa len publikujú: balík sám žiadnu nenačítava, takže migrate pred publikovaním nič nevytvorí. Publikovanie skopíruje coupons a potom coupon_redemptions do database/migrations s časovými pečiatkami o sekundu od seba, takže odkazovaná tabuľka vždy vznikne skôr. Opätovné publikovanie prepíše tie isté súbory namiesto vytvorenia duplikátov.

Voliteľné publikovanie

Konfiguračný súbor je voliteľný — každý kľúč má predvolenú hodnotu a všetky okrem jedného sa dajú nastaviť cez env. Publikujte ho, len ak chcete niečo prepísať:

php artisan vendor:publish --tag="coupons-config"

Preklady publikujte, ak chcete upraviť alebo preložiť hlásenia validačného pravidla a názvy typov zliav:

php artisan vendor:publish --tag="coupons-translations"

Pred migrovaním

Ak vaše modely zákazníkov — zvyčajne User — používajú primárne kľúče UUID alebo ULID, nastavte coupons.key_type ešte pred spustením migrácie. Určuje typ polymorfného stĺpca redeemer v coupon_redemptions (pozrite si Zákazníci a limity na zákazníka).

Prehľad

Balík pridáva sekciu Coupons do príkazu about v Laraveli:

php artisan about --only=coupons

• Model — použitá trieda modelu kupónu.
• Default currency — coupons.default_currency, alebo INVALID: … s dôvodom, ak nie je reťazcom.
• Redeemer tracking — ON alebo OFF.
• Generated codes — len dĺžka a veľkosť abecedy, napr. „6 chars from a 36-symbol alphabet“. Samotná abeceda sa nikdy nevypíše; nepoužiteľná hodnota code.* sa zobrazí ako INVALID: … s názvom kľúča a príkaz nezlyhá.
• Route key — stĺpec, podľa ktorého sa viaže {coupon}, alebo INVALID: … s dôvodom.