Filament Socialite

To upgrade to v1, you must republish the configuration and register the plugin in your Panel Provider.

sail artisan vendor:publish --provider="DutchCodingCompany\FilamentSocialite\FilamentSocialiteServiceProvider"

In your App\Providers\Filament\YourPanelProvider:

->plugins([
    \DutchCodingCompany\FilamentSocialite\FilamentSocialitePlugin::make()
])

To support automatic account creation, ensure the password attribute on your User model is nullable in your database migration:

$table->string('password')->nullable();

You can also control registration via a callback in the plugin configuration. For example, to only allow registration if a user already exists:

->registration(fn (string $provider, SocialiteUserContract $oauthUser, ?Authenticatable $user) => (bool) $user)

The package automatically adds two routes per panel for the OAuth flow. You must configure these in your external OAuth application settings.

Panel-specific callback: If your panel ID is admin and the provider is github, the URL is: https://example.com/admin/oauth/callback/github

Multi-panel callback: For stateful OAuth apps, you can use a single callback URL for multiple panels. The panel ID is determined via an encrypted state parameter: https://example.com/oauth/callback/github

In version 3, the plugin uses the panel's configured path instead of its ID to generate callback URLs. If you need to revert to the previous behavior (using the panel ID), you must manually set the slug on the plugin configuration.

FilamentSocialitePlugin::make()
    ->slug('admin') // change this to the panel's ID
    // other config for plugin
)

To use Font Awesome brand icons, install the blade-fontawesome package.

composer require owenvoke/blade-fontawesome

Version 2 refactored the plugin to align with Filament naming conventions and moved several callbacks from the AppServiceProvider directly onto the plugin instance for per-panel configuration.

To automate the renaming of most methods, you can use the provided Rector script.

vendor/bin/upgrade-v2

Install the package via Composer and publish the necessary migrations and configuration files.

Note on versions:

• Filament ^5.0.0 requires package ^3.1
• Filament ^4.0.0 requires package 3.x.x
• Filament ^3.2.44 (SPA mode) requires package 2.x.x or ^1.3.1
• Filament 3.x requires package 1.x.x
• Filament 2.x requires package 0.x.x

composer require dutchcodingcompany/filament-socialite

php artisan vendor:publish --tag="filament-socialite-migrations"
php artisan migrate

You can limit OAuth logins to users from specific domains (useful for SSO) using domainAllowList.

->plugin(
    FilamentSocialitePlugin::make()
        ->registration(true)
        ->domainAllowList(['localhost'])
);

The registration() method allows you to define custom logic for whether a user is allowed to register via a social provider. You can pass a Closure that receives the provider name, the Socialite OAuth user, and the existing application user (if any). The closure must return a bool indicating if the registration is permitted.

Signature: Closure(string $provider, \Laravel\Socialite\Contracts\User $oauthUser, ?\Illuminate\Contracts\Auth\Authenticatable $user): bool

->registration(function (string $provider, $oauthUser, $user): bool {
    // Example: Only allow registration if the email domain is allowed
    return str_ends_with($oauthUser->getEmail(), '@example.com');
})

In v2, providers are no longer configured via plain arrays. They must be instantiated using the Provider class. Scopes and optional parameters (previously in services.php) are now configured directly on the Provider object within the providers() method.

use DutchCodingCompanyilament-socialite\FilamentSocialitePlugin;
use DutchCodingCompany\filament-socialite\Provider;

FilamentSocialitePlugin::make()
    ->providers([
        Provider::make('gitlab')
            ->label('GitLab')
            ->icon('fab-gitlab')
            ->color(Color::hex('#2f2a6b'))
            ->scopes([
                'read:user',
                'public_repo',
            ])
            ->with([
                 'hd' => 'example.com',
            ]),
    ]),