Filament Companies

In version 5.x, company features are no longer enabled automatically by calling companies(). To follow the principle of least privilege, you must now explicitly enable each specific feature you want to use. Calling companies(invitations: true) only enables basic company support; you must chain additional methods to enable other functionalities.

// 5.x Configuration Example
FilamentCompanies::make()
    ->companies(invitations: true)           // Only enables basic company support
    ->updateCompanyInformation()             // Explicitly enable company name updates
    ->manageCompanyEmployees()               // Explicitly enable employee management
    ->companyDeletion()                      // Explicitly enable company deletion

If using Laravel's email verification, you must ensure the verification URL is correctly registered so it works on the user profile page. You can do this in two ways:

Option 1: Using the VerifyEmail::createUrlUsing callback (Recommended) Add this to your AppServiceProvider's boot method:

use Filament\Facades\Filament;
use Filament\Notifications\Auth\VerifyEmail;

VerifyEmail::createUrlUsing(function ($notifiable) {
    return Filament::getVerifyEmailUrl($notifiable);
});

Option 2: Registering a manual route Add this to your routes/web.php:

use Filament\Http\Controllers\Auth\EmailVerificationController;

Route::get('/email/verify/{id}/{hash}', [EmailVerificationController::class, '__invoke'])
    ->middleware(['signed'])
    ->name('verification.verify');

To use Socialite providers, add the credentials to your config/services.php file.

Critical: The Redirect URI must follow the pattern: APP_URL/company/oauth/provider/callback (e.g., https://your-app.com/company/oauth/github/callback).

// config/services.php
'github' => [
    'client_id' => env('GITHUB_CLIENT_ID'),
    'client_secret' => env('GITHUB_CLIENT_SECRET'),
    'redirect' => 'https://filament.test/company/oauth/github/callback',
],

Because the package registers a company panel, you must create a custom Tailwind theme to ensure the package's styles are processed.

1. Create a custom theme following the Filament documentation.
2. Add the package's vendor directory to your custom theme's CSS file (e.g., resources/css/filament/company/theme.css) using the @source directive.

@source '../../../../vendor/andrewdwallo/filament-companies/resources/views';

To ensure users land on the Company panel's Register or Login pages when visiting the Laravel Welcome page, you must:

1. Remove the ->default() method from your User panel.
2. Apply the ->default() method to your Company panel configuration.

To install the package, require it via Composer and then run the scaffold command. The scaffold command will prompt you to choose between the Base package or enabling Socialite support.

Prerequisites:

• A fresh Laravel project.
• A configured database.
• Filament Panel Builder installed and a panel created via php artisan filament:install --panels.

composer require andrewdwallo/filament-companies

php artisan filament-companies:install

php artisan migrate:fresh

The package requires a "User" panel (which can be your default Admin panel or a dedicated user panel) to host the Profile and Personal Access Tokens pages. You must register these pages in your panel configuration.

use Walloilament-companies\Pages\User\PersonalAccessTokens;
use Wallo\FilamentCompanies\Pages\User\Profile;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->pages([
            Profile::class,
            PersonalAccessTokens::class,
        ]);
}

The stubs/resources/markdown/terms.md file serves as a template for the application's Terms of Service. To define your application's specific legal terms, edit this file directly. The template includes placeholder sections for:

• Introduction: General overview of the service.
• Usage Terms: Rules regarding how the service should be used.
• User Conduct: Expectations for user behavior.
• Content Ownership: Definitions of who owns user-generated content.
• Limitations of Liability: Legal disclaimers and liability constraints.

You can selectively enable or disable profile features by calling their respective methods on the FilamentCompanies instance within your PanelProvider. If a method is omitted, the feature is disabled by default.

Available profile features:

• updateProfileInformation(): Enables updating profile information.
• updatePasswords(): Enables password updates.
• setPasswords(): Enables setting passwords (only if Socialite is enabled).
• connectedAccounts(): Enables connected account management (only if Socialite is enabled).
• manageBrowserSessions(): Enables browser session management.
• accountDeletion(): Enables account deletion.

->plugin(
    FilamentCompanies::make()
        ->updateProfileInformation()
        ->updatePasswords()
        ->setPasswords()
        ->connectedAccounts()
        ->manageBrowserSessions()
        ->accountDeletion()
);