A Package to Require Approval Before Peristing Model Data

 The Laravel Approval package requires approval of new Model data before being persisted. This package uses Enums and thus requires PHP 8.1 and Laravel 9.

To get started with this package, use the provided MustBeApproved trait on a model:

1use Cjmellor\Approval\Concerns\MustBeApproved;
2 
3class Post extends Model
4{
5    use MustBeApproved;
6 
7    // ...
8}

The package uses a polymorphic relationship to store the data that must be approved in a new table called approvals. You can query approvals and set the state for a given approval using the following methods:

 1use App\Models\Approval;
 2 
 3// Get approvals, rejected models, and pending.
 4Approval::approved()->get();
 5Approval::rejected()->get();
 6Approval::pending()->count();
 7 
 8// Approve, reject or postpone an approval.
 9Approval::where('id', 1)->approve();
10Approval::where('id', 2)->reject();
11Approval::where('id', 3)->postpone();

Finally, if you want to bypass the approval process and persist a model you can use the following method on your model:

1$model->withoutApproval()->update(['title' => 'Some Title']);

You can get started with this package by checking out the repository on Github at cjmellor/approval.

Read More

Create Select Options from Enums, Laravel Models, and more

 Laravel Options by Spatie is a package to create lists of options from different sources:

A typical web application always has many select fields with options. This package makes it simple to transform enums, models, states, and arrays to a unified option structure.

An example from the readme illustrates how this package can help ease working with select options in Laravel applications. Given an enum, you can use this package to build options:

 1enum Hobbit: string
 2{
 3    case Frodo = 'frodo';
 4    case Sam = 'sam';
 5    case Merry = 'merry';
 6    case Pippin = 'pippin';
 7}
 8 
 9Options::forEnum(Hobbit::class)->toArray();
10 
11/* returns the following array
12[
13    ['label' => 'Frodo', 'value' => 'frodo'],
14    ['label' => 'Sam', 'value' => 'sam'],
15    ['label' => 'Merry', 'value' => 'merry'],
16    ['label' => 'Pippin', 'value' => 'pippin'],
17]
18*/
19 
20// Or return JSON
21Options::forEnum(Hobbit::class)->toJson();

Not only can you use Enums, but this package also supports data from various sources, including:

• Models
• Model States (via Spatie Model States)
• Arrays
• Manually

Another neat feature is that you can turn your options into a validation rule:

1$request->validate([
2    // ['in:frodo,sam,merry,pippin']
3    'hobbit' => Options::forEnum(Hobbit::class)->toValidationRule()
4]);

You can learn more about this package, get full installation instructions, and view the source code on GitHub. Also, read Introducing our new Laravel Options package by Freek Van der Herten to get the background and details on this package.

Read More