Download the PHP package escolalms/model-fields without Composer

Model Fields

What does it do

This package allows you to add unlimited extra primitive fields to any model.

Types of fields that can be user

• booleandoc
• number
• varchar
• text
• json

Details documentation is provided as an example

Installing

• composer require escolalms/model-fields
• php artisan migrate
• php artisan db:seed --class="EscolaLms\ModelFields\Database\Seeders\PermissionTableSeeder"

Database

The package allows to add additional fields by creating special meta description values that are saved in database.

Next to metadata descriptions there are values that works with the meta description.

Below are examples of how matadata and values are stored in database

model_fields_metadata table sample rows

model_fields_values table sample rows

See tests folder as rows above are generated from the tests.

Example

The best documentation operates on live example so here it is.

Assuming you have User Model

In order to add extra fields to user model you would need to create new columns in user table with migration and add those fields. This is a standard way of handling this issue, but this package introduces new one.

Option 1. Extending Model

This option replaces Illuminate\Database\Eloquent\Model with EscolaLms\ModelFields\Models\Model

Option 2. Trait in Model.

This option uses EscolaLms\ModelFields\Traits\ModelFields instead of extending class;

Basically that all the steps you need to allow model to be extendable.

Defining new fields on selected Model.

Now lets create new field meta description. We'll be adding new field to user, called description which will be long text.

Interface of this method is as follows

Once new field is added you can use is as any other attribute of model

That's all, your user model is ready to be extended. You can get and set attributes as they were created standard way.

Resources and fields visibility

Using resources is simple, look at the following example

Note. In php 7.4 user array_merge instead of spread ... operator.

Look at the visibility field in example above. Package allows to define visibility of the meta fields. Here we're defining 2 fields, one is public, second admin only.

Now we can have 2 endpoints one that list user with public fields, other with visible to admin only.

Now let's see how Admin Resource would look like.

MetaFieldVisibilityEnum::ADMIN | MetaFieldVisibilityEnum::PUBLIC is a Flagged/Bitwise Enum. MetaFieldVisibilityEnum is just a proposal - you can use as many permissions as you like yet defining values you must use powers of 2, like.

Validation with FormRequest

Example below describes how to fetch validation rules from MetaField

In php 7.4 user array_merge instead of spread ... operator.

Endpoints

All the endpoints are defined in .

Tests

Run ./vendor/bin/phpunit to run tests. See tests folder as it's quite good staring point as documentation appendix.

Test details

Events

This package does not dispatch any events.

Listeners

This package does not listen for any events

How to use this on frontend.

Admin panel

All the endpoints defined in are for admin panel.

There is native component you can use to implement this in admin panel for any model that allows extending

Example in admin panel

List of user model fields

Creating/editing model field

Front Application

See example above how to extend controllers to CRUD model fields to give model

Permissions

Permissions are defined in seeder

Roadmap. Todo. Troubleshooting.

• firstOrCreate doesn't work when passing extra attributes