Download the PHP package romegadigital/multitenancy-nova-tool without Composer

Multitenancy Nova Tool

This package is meant to integrate with the Multitenancy Package to bring multitenancy functionality and management to Laravel's Nova.

This package automatically includes the Multitenancy Package as a dependency. Please read the documentation on how to integrate it with your existing app.

• Multitenancy Nova Tool
  • Installation
  • Usage
  • Define Inverse Relationships
  • Middleware
  • Policies
  • To Do

Installation

Install the package via Composer:

Then follow the Installation instructions to set up the Multitenancy Package.

Next, you must register the tool with Nova. This is typically done in the tools method of the NovaServiceProvider.

This package requires Super Administrator or access admin permissions. This can be added either through the included permission management tool under "Roles & Permissions" or through our assign super-admin command.

Hint If you already executed multitenancy:install, a role with the name Super Administrator and a permission access admin attached was already created. Therefore you only need to add the role to a user.

Usage

New menu items labeled "Multitenancy" and "Roles & Permissions" will appear in your Nova app after installing this package.

To see the Tenant relation in the user detail view, add a BelongsToMany field to your app/Nova/User resource:

On each Nova resource that is tenantable, a BelongsTo field is required in order to see the relation to the Tenant model:

Define Inverse Relationships

In order to display all related data to the Tenant model, you need to first implement a Tenant model that extends the package's provided model.

Next, update your config file to point to your new model.

Then create a Tenant Nova resource that extends the package's resource.

Middleware

To scope Nova results to the Tenant being utilized, add the middleware to Nova:

Accessing Nova at the admin subdomain will remove scopes and display all results. Only users given the correct permissions, such as Super Administrator, will be able to access this subdomain.

Policies

By default, the Multitenancy resource will only be visible on the admin subdomain to users with appropriate access to this subdomain. You may override the policy to allow more access to the resource by defining a policy within your project. And then within your AuthServiceProvider, register the policy:

You can override the Permission and Role model policies by setting the policy file up in you config/multitenancy.php file. Look for policies.role and policies.permission.