batv45/laravel-balance

Maintains a history of balance movements in the eloquent models. This simple package will keep track of the balance of your models. You can increase, decrease, reset and set the balance. It is also possible to check if a model has a positive balance or no balance.

1.0.3 2023-03-25 03:21 UTC

Requires

• php: ^7.4|^8.0
• cknow/laravel-money: ^7.0
• illuminate/support: ^7.0|^8.0|^9.0|^10.0

MIT

• Batuhan OK

• money
• laravel
• balance
• laravel-balance
• balance-history
• batv45

README

Maintains a history of balance movements in the eloquent models. This simple package will keep track of the balance of your models. You can increase, decrease, reset and set the balance. It is also possible to check if a model has a positive balance or no balance.

Installation

You can install the package via composer:

composer require batv45/laravel-balance

You can publish and run the migrations with:

php artisan vendor:publish --provider="Batv45\Balance\BalanceServiceProvider" --tag="migrations"
php artisan migrate

You can publish the config file with:

php artisan vendor:publish --provider="Batv45\Balance\BalanceServiceProvider" --tag="config"

This is the contents of the published config file:

<?php

return [

    /*
    |--------------------------------------------------------------------------
    | Table name
    |--------------------------------------------------------------------------
    |
    | Table name to use to store balance history transactions.
    |
    */

    'table' => 'balance_history',
    'model' => \Batv45\Balance\Balance::class,

    /**
     * ex: 1000 or 100
     * type: int
     */
    'multiplier' => 1000

];

Usage

Adding the HasBalance trait will enable balance functionality on the Model.

use Illuminate\Foundation\Auth\User as Authenticatable;
use Batv45\Balance\HasBalance;

class User extends Authenticatable
{
    use HasBalance;
}

Basic operations

$user->increaseBalance(2575);
$user->balance; // 25.75

$user->decreaseBalance(2575);
$user->balance; // 0

$user->modifyBalance(-2537);
$user->balance; // -25.37

$user->modifyBalance(3037);
$user->balance; // 5

Reset balance

It's also possible to reset the balance and directly setting a new value.

$user->resetBalance(); // 0

$user->resetBalance(10); // 10

Check if model has balance

Check if there is a positive balance or a balance greater than that provided.

$user->hasBalance();
$user->hasBalance(2575);

Check if model has no balance

Check if there is no more balance.

$user->hasNoBalance();

Add reference and description to history

It is possible to add a reference to any of the above methods by passing an array as a second parameter with the data of the referenced model and a description.

use App\Models\Podcast;

$podcast = Podcast::find(1);

$user->decreaseBalance(2575, [
    'description' => 'Purchase of a podcast.',
    'reference' => $podcast
]);

$user->increaseBalance(2575, [
    'description' => 'Paypal Deposit.'
]);

Contributing

Please see CONTRIBUTING for details.

License

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