README

Discountable

Make your models discountable with Laravel, allowing you to apply vouchers with lots of options and conditions. Here's a quick example of how to use the package:

$student = Student::find(1);
// Check if the voucher is valid and can be applied (useful for UI validation before applying)
$student->checkVoucher('SUMMER2023', 100);

// Redeem the voucher, applying the discount
$student->redeemVoucher('SUMMER2023', 100);

Installation

You can install the package via composer:

composer require boddasaad/laravel-discountable

php artisan discountable:install

This is the contents of the published config file:

return [
    /*
     * Database table name that will be used to store vouchers.
     */
    'table' => 'vouchers',

    /*
     * Database table name that will be used to store voucher usages.
     */
    'usage_table' => 'voucher_usages',

    /*
     * List of characters that will be used for voucher code generation.
     */
    'characters' => '23456789ABCDEFGHJKLMNPQRSTUVWXYZ',

    /*
     * Voucher code prefix.
     *
     * Example: foo
     * Generated Code: foo-AGXF-1NH8
     */
    'prefix' => null,

    /*
     * Voucher code suffix.
     *
     * Example: foo
     * Generated Code: AGXF-1NH8-foo
     */
    'suffix' => null,

    /*
     * Code mask.
     * All asterisks will be removed by random characters.
     */
    'mask' => '****-****',

    /*
     * Separator to be used between prefix, code and suffix.
     */
    'separator' => '-',
];

Usage

To use the package, you need to add the CanRedeemVouchers trait to your model:

namespace App\Models;

use BoddaSaad\Voucher\Traits\CanRedeemVouchers;

class User extends Authenticatable
{
    use CanRedeemVouchers;
    # ...
}

Creating Vouchers

You can create vouchers using the Voucher Facade. Here's an example of how to create a voucher with various options:

use BoddaSaad\Voucher\Facades\Voucher;

$voucher = Voucher::maximumRedeems(1000)
        ->discount('percentage', 20)
        ->date('2025-01-01', '2025-12-31')
        ->minimumQualifyingAmount(50)
        ->maximumDiscountAmount(100)
        ->maxUsagesPerModel(1)
        ->data(['description' => 'Holiday Discount'])
        ->create();

Voucher Facade Methods

Applying Vouchers

To apply a voucher, you can use the checkVoucher and redeemVoucher methods provided by the CanRedeemVouchers trait.

Check Voucher Validity

This is useful for UI validation before applying the voucher so the user can see if the voucher is valid or not.:

auth()->user()->checkVoucher('SUMMER2023', 100);

This will return an object with the following properties if the voucher is valid:

[
    'valid' => true,
    'final_amount' => 80, // The amount after applying the voucher
    'voucher_id' => 1 // The ID of the voucher
]

If the voucher is not valid, it will return an object with the following properties:

[
    'valid' => false,
    'message' => 'Voucher has expired' // The reason why the voucher is not valid
]

Redeem Voucher

To redeem the voucher and apply the discount, you can use the redeemVoucher method:

auth()->user()->redeemVoucher('SUMMER2023', 100);
// Will return true if the voucher was successfully redeemed, or false if it was not.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Abdur-Rahman Saad
• All Contributors

License

The MIT License (MIT). Please see License File for more information.