romegadigital/multitenancy-nova-tool

A Laravel Nova tool to manage multitenancy.

4.0.0 2023-05-31 23:40 UTC

This package is auto-updated.

Last update: 2024-03-01 00:12:52 UTC


README

Total Downloads

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.

index

create

Installation

Install the package via Composer:

composer require romegadigital/multitenancy-nova-tool

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.

// in app/Providers/NovaServiceProvider.php

public function tools()
{
    return [
        // ...
        new \RomegaDigital\MultitenancyNovaTool\MultitenancyNovaTool,
    ];
}

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.

php artisan multitenancy:super-admin admin@example.com

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:

// in app/Nova/User.php

use Laravel\Nova\Fields\BelongsToMany;

public function fields(Request $request)
{
    return [
        // ...
        BelongsToMany::make('Tenants', 'tenants', \RomegaDigital\MultitenancyNovaTool\Tenant::class),
    ];
}

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

use Laravel\Nova\Fields\BelongsTo;

public function fields(Request $request)
{
    return [
        // ...
        BelongsTo::make('Tenants', 'tenant', \RomegaDigital\MultitenancyNovaTool\Tenant::class),
    ];
}

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.

// in app/Tenant.php

namespace App\Models;

use RomegaDigital\Multitenancy\Models\Tenant as TenantModel;

class Tenant extends TenantModel
{
    // ... define relationships
    public function products()
    {
        return $this->hasMany(\App\Product::class);
    }
}

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

// in config/multitenancy.php

// ...
'tenant_model' => \App\Models\Tenant::class,

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

// in app/Nova/Tenant.php

namespace App\Nova;

use Illuminate\Http\Request;
use Laravel\Nova\Fields\HasMany;
use RomegaDigital\MultitenancyNovaTool\Tenant as TenantResource;

class Tenant extends TenantResource
{
    public static $model = \App\Models\Tenant::class;

    /**
    * Get the fields displayed by the resource.
    *
    * @param  \Illuminate\Http\Request  $request
    * @return array
    */
    public function fields(Request $request)
    {
        return array_merge(parent::fields($request),
        [
            // ... define relationships
            HasMany::make('Products'),
        ]);
    }

}

Middleware

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

// in config/nova.php

// ...

'middleware' => [
    // ...
    \RomegaDigital\Multitenancy\Middleware\TenantMiddleware::class,
    \Vyuldashev\NovaPermission\ForgetCachedPermissions::class,
],

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:

// in app/Providers/AuthServiceProvider.php

// ...
protected $policies = [
    // ...
    \RomegaDigital\Multitenancy\Models\Tenant::class => \App\Policies\TenantPolicy::class,
];

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.