Extending User Models
Laravel's authorization features are available in models which implement the
By default Laravel does this in
\App\User by extending
Illuminate\Foundation\Auth\User, in which the trait and
Illuminate\Contracts\Auth\Access\Authorizable contract are declared.
If you are creating your own User models and wish Authorization features to be available, you need to implement
Illuminate\Contracts\Auth\Access\Authorizable in one of those ways as well.
Child User Models
Due to the nature of polymorphism and Eloquent's hard-coded mapping of model names in the database, setting relationships for child models that inherit permissions of the parent can be difficult (even near impossible depending on app requirements, especially when attempting to do inverse mappings). However, one thing you might consider if you need the child model to never have its own permissions/roles but to only use its parent's permissions/roles, is to override the
getMorphClass method on the model.
eg: This could be useful, but only if you're willing to give up the child's independence for roles/permissions:
public function getMorphClass()
Extending Role and Permission Models
If you are extending or replacing the role/permission models, you will need to specify your new models in this package's
First be sure that you've published the configuration file (see the Installation instructions), and edit it to update the
models.permission values to point to your new models.
Note the following requirements when extending/replacing the models:
If you need to EXTEND the existing
Permission models note that:
Role model needs to extend the
Permission model needs to extend the
If you need to REPLACE the existing
Permission models you need to keep the following things in mind:
Role model needs to implement the
Permission model needs to implement the
Migrations - Adding fields to your models
You can add your own migrations to make changes to the role/permission tables, as you would for adding/changing fields in any other tables in your Laravel project.
Following that, you can add any necessary logic for interacting with those fields into your custom/extended Models.