zareismail/nova-trust

A Laravel Nova tool for `ACL` based on `laratrust` package.

0.3.0 2020-09-08 04:17 UTC

This package is auto-updated.

Last update: 2024-03-08 12:51:51 UTC


README

Nova Trust is a package that based on Laratrust; a laravel package, that providing user ACL.

Installation

Install the package in a Laravel Nova project via Composer:

composer require zareismail/nova-trust

Publish the nova-trust publishable files:

php artisan vendor:publish --tag="nova-trust"

This command publishing views, config, lang and database migrations into the compatible path. Also, you can publish it separately by the following commands:

php artisan vendor:publish --tag="nova-trust-config"
php artisan vendor:publish --tag="nova-trust-lang"
php artisan vendor:publish --tag="nova-trust-views"
php artisan vendor:publish --tag="nova-trust-migrations"

After publishing; You should run the database migration(s):

php artisan migrate

Then Register the tool by the tools method of the NovaServiceProvider:

// in app/Providers/NovaServiceProvider.php

public function tools()
{
    return [
        // ...
        new \NovaTrust\NovaTrust
    ];
}

At the end, you should insert \NovaTrust\Concerns\InteractsWithNovaTrust trait in the users model.

Configuration

Configuration File

In your config/nova-trust.php file you will find all the package configurations that you can customize

Teams Feature

If you want to use the team's feature; that allows you to attach roles and permissions to a user depending on a team, you must change the teams_strict_check key value to true in your config/nova-trust.php file.

Multiple User Resources

In the config/nova-trust.php file you will find an user_resources array, it contains the information about the multiple user resources and the name of the relationships inside the Role and Permission models. For example:

user_resources' => [
    'users' => 'App\Nova\User',
],

Developer Access

After installation you will saw 403 error; for solving this situation; you can define isDeveloper method in user model that should return true value; that cause the user can access to anything.

Define New Permission

This package uses the abilities and policies public methods, for defining permissions.
So for define new permission, you should follow laravel Authorization docs.

By Default; exists some reserved permission for superior access that's names are: view Any, view, create, update, delete, attach, detach, forceDelete, add.

that means if attach one of the superior permission to a role or user; the user will have permission to do the action for all models. for example; when attached create permission to a user; the user can create anything.

Also, there exist some ownership permissions that attaching one of them to user cause user just access to own resource. for example, when attached updateOwn permission to a user its can just update resources that created.

License

Nova Trust is open-sourced software licensed under the MIT license.