Qore Tenant

This module adds Tenant functionality to your application. It can be added to any model of your choosing.

Installation

1. Install the package via composer:

composer require qore-works-business/qore-tenant

php artisan qore-tenant:install

2. Add the plugin to the plugins() section of the applications panel service provider:

use QoreWorksBusiness\QoreRelation\QoreTenantPlugin;

class QorePanelServiceProvider extends QorePanelServiceProviderBase
{

public function panel(QorePanel|Panel $panel): QorePanel

    return parent::panel($panel)
        // ....
        ->plugins([
            QoreTenantPlugin::make(),
        ]);
}

3. Add the Tenantable contract and HasTenant trait to your model.

use QoreWorksBusiness\QoreTenant\Concerns\HasTenant;
use QoreWorksBusiness\QoreTenant\Contracts\Tenantable;

class Company implements Tenantable
{
    use HasTenant;

    // ...

4. If you want to use the TenantRelationManager to manage Tenants from QWB, add the TenantRelationManager to your filament resource.

use QoreWorksBusiness\QoreTenant\Resources\RelationManagers\TenantRelationManager;

public static function getRelations(): array
{
    return [
        // ...
        TenantRelationManager::class,
    ];
}

5. If you want to use Tenant information in blade files you can use the TenantComposer view composer in your AppServiceProvider.

use QoreWorksBusiness\QoreTenant\View\Composers\TenantComposer;

public function boot(): void
{
    view()->composer([
        // any blade files
        'application.portal.layouts.app',
        'application.portal.layouts.guest',
    ], TenantComposer::class);
}

6. To route to the correct subdomain you can use the TenantBySubdomainMiddleware middleware. You can use this for most QWB applications (website, portal). Currently Statamic websites are not supported out of the box, but can work with Laravel subdomain routing.

//config/portal.php
use QoreWorksBusiness\QoreTenant\Http\Middleware\TenantBySubdomainMiddleware;

return [
    'middleware' => [
        'web',
        TenantBySubdomainMiddleware::class,
    ],
    // ...
];

7. Add your main domain to the .env

MAIN_DOMAIN=