aventure-cloud/eloquent-status-recorder

Eloquent model's status management with history

Eloquent Status Recorder

, _(*1)

Any eloquent model can have Status management with just one trait. Declare status statically but store status history four your models in the database., _(*2)

• Author: Valerio Barbera - valerio@aventuresrl.com
• Author Website: www.aventuresrl.com

Install

composer require aventure-cloud/eloquent-status-recorder, _(*3)

Config

Publish configuration file in your project:, _(*4)

php artisan vendor:publish --provider="AventureCloud\EloquentStatusRecorder\EloquentStatusRecorderServiceProvider" --tag="config", _(*5)

Migration

We provide a migration script to create statuses table. To publish migration script execute:, _(*6)

php artisan vendor:publish --provider="AventureCloud\EloquentStatusRecorder\EloquentStatusRecorderServiceProvider" --tag="migrations", _(*7)

And run with artisan command:, _(*8)

php artisan migrate --path=/database/migrations, _(*9)

Use

Attach HasStatus trait to your models and configure statuses values for each models indipendently., _(*10)

class Order extends Model {
    use HasStatus;

    protected $statuses = [
        'opened'    => [],
        'paid'      => ['from'     => 'opened'],
        'approved'  => ['from'     => 'paid'],
        'shipped'   => ['from'     => ['paid', 'approved']],
        'arrived'   => ['from'     => 'shipped'],
        'cancelled' => ['not-from' => ['arrived']],
    ];
}

Utility methods

$order = Order::find(1);

/* 
 * Current status
 * instance of model configured in config('eloquent-status-recorder.status_model')
 */
$order->status;

/* 
 * List of all available statuses for current model
 */
$order->statuses();

/* 
 * Available statuses after current status value based on "from" and "not-from" rules
 */
$order->nextAvailableStatuses();

/* 
 * Change status
 */
$order->changeStatusTo('shipped');

Auto-run callbacks

In some cases, you need to do something after a specific status is set. For example, send an mail after an order is "shipped". This package invokes a method after status change by the convention of on + status_name (camel cased):, _(*11)

class Order extends Model {
    use HasStatus;

    protected $statuses = [
        'opened'    => [],
        'paid'      => ['from'     => 'opened'],
        'approved'  => ['from'     => 'paid'],
        'shipped'   => ['from'     => ['paid', 'approved']],
        'arrived'   => ['from'     => 'shipped'],
        'cancelled' => ['not-from' => ['arrived']],
    ];

    public function onShipped()
    {
        // Send email to the user
    }
}

Events

Every time a status change happen two event will fire with attached the current eloquent model instance and the given status: - StatusChanging (Before status is saved) - StatusChanged (After status change is performed), _(*12)