PHPackages chrisreedio/socialment - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Authentication & Authorization](/categories/authentication) 4. / 5. chrisreedio/socialment ActiveLibrary[Authentication & Authorization](/categories/authentication) chrisreedio/socialment ====================== Provides Socialite functionality for Filament. v5.1.0(3w ago)111103.2kโ†“41.1%18[1 issues](https://github.com/chrisreedio/socialment/issues)[4 PRs](https://github.com/chrisreedio/socialment/pulls)1MITPHPPHP ^8.2CI passing Since Sep 6Pushed 2w ago2 watchersCompare [ Source](https://github.com/chrisreedio/socialment)[ Packagist](https://packagist.org/packages/chrisreedio/socialment)[ Docs](https://github.com/chrisreedio/socialment)[ GitHub Sponsors](https://github.com/chrisreedio)[ RSS](/packages/chrisreedio-socialment/feed)WikiDiscussions 5.x Synced 3d ago READMEChangelog (10)Dependencies (32)Versions (43)Used By (1) Socialment - Socialite OAuth Support for Filament ================================================= [](#socialment---socialite-oauth-support-for-filament) [![Socialment](https://private-user-images.githubusercontent.com/77644584/263834245-53dd1b45-d775-4335-a7ec-ae18456bcab4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI5MjE5MzksIm5iZiI6MTc4MjkyMTYzOSwicGF0aCI6Ii83NzY0NDU4NC8yNjM4MzQyNDUtNTNkZDFiNDUtZDc3NS00MzM1LWE3ZWMtYWUxODQ1NmJjYWI0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA3MDElMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNzAxVDE2MDAzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTI3OWUwMzM1OGE0MTFiMzNmZTNkZmVkZmVmNGEzY2Y1NmYxOGVjZjg1MDFhNTdmNjNhNjE3ZDVjZDMxOGRiMDEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.SIBRGuTkx9UTNLbjvF52PfLS4OFLkrumZYvEtulHrbE)](https://private-user-images.githubusercontent.com/77644584/263834245-53dd1b45-d775-4335-a7ec-ae18456bcab4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI5MjE5MzksIm5iZiI6MTc4MjkyMTYzOSwicGF0aCI6Ii83NzY0NDU4NC8yNjM4MzQyNDUtNTNkZDFiNDUtZDc3NS00MzM1LWE3ZWMtYWUxODQ1NmJjYWI0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA3MDElMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNzAxVDE2MDAzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTI3OWUwMzM1OGE0MTFiMzNmZTNkZmVkZmVmNGEzY2Y1NmYxOGVjZjg1MDFhNTdmNjNhNjE3ZDVjZDMxOGRiMDEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.SIBRGuTkx9UTNLbjvF52PfLS4OFLkrumZYvEtulHrbE) [![Latest Version on Packagist](https://camo.githubusercontent.com/15ad8d9e920ed2afe48469636da187bab7c06646a81a9f76b805ba1ddb47fcbf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636872697372656564696f2f736f6369616c6d656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chrisreedio/socialment)[![Tests Action Status](https://github.com/chrisreedio/socialment/actions/workflows/run-tests.yml/badge.svg)](https://github.com/chrisreedio/socialment/actions/workflows/run-tests.yml/badge.svg)[![Code Style Action Status](https://github.com/chrisreedio/socialment/actions/workflows/fix-php-code-styling.yml/badge.svg)](https://github.com/chrisreedio/socialment/actions/workflows/fix-php-code-styling.yml/badge.svg)[![PHPStan Action Status](https://github.com/chrisreedio/socialment/actions/workflows/phpstan.yml/badge.svg)](https://github.com/chrisreedio/socialment/actions/workflows/phpstan.yml/badge.svg)[![Total Downloads](https://camo.githubusercontent.com/355417dfb52dfe2aeff45eb45a194d554280b6f9c0316824ddca6eb2823fc5ca/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636872697372656564696f2f736f6369616c6d656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chrisreedio/socialment) Table of Contents ----------------- [](#table-of-contents) - [About](#about) - [Installation](#installation) - [Basic Setup](#basic-setup) - [Provider Configuration](#provider-configuration) - [Advanced Configuration](#advanced-configuration) - [Customization](#customization) - [SPA Authentication](#spa-authentication) - [Testing](#testing) - [Contributing](#contributing) --- About ----- [](#about) Bring up-to-date and simple Socialite support to your Filament admin panel with this plugin. Adds OAuth buttons to your login page. **โœจ Key Features:** - ๐Ÿ” Easy OAuth integration with Filament panels - ๐ŸŽจ Customizable provider buttons with icons - ๐Ÿ”— Supports all Laravel Socialite providers - ๐ŸŽฏ Per-panel provider configuration - ๐Ÿ”ง Extensible with custom login hooks - ๐Ÿ“ฑ Experimental SPA authentication support **Perfect for:** Laravel and Filament users seeking straightforward OAuth integration. ### Demo [](#demo) ๐ŸŽฎ **Demo Project:** [ChrisReedIO/Socialment-Demo](https://github.com/chrisreedio/socialment-demo) *Not yet updated to v4.* [![Login Screen Preview](https://private-user-images.githubusercontent.com/77644584/265894206-c07c6518-df0b-4143-8826-efa3cbdaa681.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI5MjE5MzksIm5iZiI6MTc4MjkyMTYzOSwicGF0aCI6Ii83NzY0NDU4NC8yNjU4OTQyMDYtYzA3YzY1MTgtZGYwYi00MTQzLTg4MjYtZWZhM2NiZGFhNjgxLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA3MDElMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNzAxVDE2MDAzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTZiYmE0MzFmZWFkMzcyYWJmODUyNGYyY2MwZDE2OTFkNTI0Mjk1ZTlhMmE3ZDE3Y2JlYjc3YzZkZmIyY2U2NjgmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.YjIw2XlwXOqRh_5W6xUa0KF27VL5QYQR9i3hW77qRs0)](https://private-user-images.githubusercontent.com/77644584/265894206-c07c6518-df0b-4143-8826-efa3cbdaa681.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI5MjE5MzksIm5iZiI6MTc4MjkyMTYzOSwicGF0aCI6Ii83NzY0NDU4NC8yNjU4OTQyMDYtYzA3YzY1MTgtZGYwYi00MTQzLTg4MjYtZWZhM2NiZGFhNjgxLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA3MDElMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNzAxVDE2MDAzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTZiYmE0MzFmZWFkMzcyYWJmODUyNGYyY2MwZDE2OTFkNTI0Mjk1ZTlhMmE3ZDE3Y2JlYjc3YzZkZmIyY2U2NjgmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.YjIw2XlwXOqRh_5W6xUa0KF27VL5QYQR9i3hW77qRs0) ### References [](#references) This package extends [Laravel Socialite](https://laravel.com/docs/master/socialite). Socialite currently supports authentication via Facebook, Twitter, LinkedIn, Google, GitHub, GitLab, and Bitbucket out of the box. ๐Ÿ“š **Useful Links:** - [Socialite Documentation](https://laravel.com/docs/master/socialite) - [Socialite Providers Community](https://socialiteproviders.com/) - Additional provider packages --- Installation ------------ [](#installation) Install the package via Composer: ``` composer require chrisreedio/socialment ``` Basic Setup ----------- [](#basic-setup) ### 1. Run Installation Command [](#1-run-installation-command) Perform the initial setup: ``` php artisan socialment:install ``` ### 2. Add Styling Support [](#2-add-styling-support) Edit your panel's custom `theme.css` and add: ``` @source '../../../../vendor/chrisreedio/socialment/resources'; ``` Important **Don't skip this step!** Without it, the plugin styling won't be applied. If you don't have a custom theme, you should create one before adding the source. To learn more about creating a custom theme, see the [Filament documentation](https://filamentphp.com/docs/4.x/styling/overview#creating-a-custom-theme). ### 3. Panel Configuration [](#3-panel-configuration) Include the plugin in your panel configuration: ``` // In your PanelProvider (e.g., app/Providers/Filament/AdminPanelProvider.php) $panel ->plugins([ // ... Other Plugins \ChrisReedIO\Socialment\SocialmentPlugin::make(), ]) ``` --- Provider Configuration ---------------------- [](#provider-configuration) ### Overview [](#overview) You need to configure OAuth providers in two places: 1. **Laravel Socialite** - Install provider packages and configure credentials 2. **Socialment** - Register providers with your Filament panel ### Step 1: Install & Configure Socialite Provider [](#step-1-install--configure-socialite-provider) Choose from [stock providers](https://laravel.com/docs/master/socialite) or [community providers](https://socialiteproviders.com/). **Example: GitHub (Stock Provider)** Add to `config/services.php`: ``` 'github' => [ 'client_id' => env('GITHUB_CLIENT_ID'), 'client_secret' => env('GITHUB_CLIENT_SECRET'), 'redirect' => env('GITHUB_REDIRECT_URI'), ], ``` **Example: Azure Active Directory (Community Provider)** Install the provider package: ``` composer require socialiteproviders/microsoft-azure ``` Add to `config/services.php`: ``` 'azure' => [ 'client_id' => env('AZURE_CLIENT_ID'), 'client_secret' => env('AZURE_CLIENT_SECRET'), 'redirect' => env('AZURE_REDIRECT_URI'), 'tenant' => env('AZURE_TENANT_ID'), 'proxy' => env('PROXY'), // optional ], ``` Add to `app/Providers/EventServiceProvider.php`: ``` protected $listen = [ // ... other listeners \SocialiteProviders\Manager\SocialiteWasCalled::class => [ // ... other providers \SocialiteProviders\Azure\AzureExtendSocialite::class.'@handle', ], ]; ``` ### Step 2: Register with Socialment [](#step-2-register-with-socialment) Add providers to your panel configuration: ``` $panel->plugins([ \ChrisReedIO\Socialment\SocialmentPlugin::make() ->registerProvider('github', 'fab-github', 'GitHub') ->registerProvider('azure', 'fab-microsoft', 'Azure Active Directory'), ]); ``` **Parameters:** - `provider_name` - Matches your `config/services.php` key - `icon` - Font Awesome brand icon ([search icons](https://fontawesome.com/search?o=r&f=brands)) - `label` - Display name for the button ### OAuth Redirect URLs [](#oauth-redirect-urls) Note **URL Pattern:** `https://yourdomain.com/login/{provider}/callback` **Examples:** - GitHub: `https://yourdomain.com/login/github/callback` - Azure: `https://yourdomain.com/login/azure/callback` --- Advanced Configuration ---------------------- [](#advanced-configuration) ### Visibility Control [](#visibility-control) Control when OAuth buttons appear: ``` $panel->plugins([ \ChrisReedIO\Socialment\SocialmentPlugin::make() ->visible(fn () => config('app.env') !== 'production') ]); ``` ### Custom Login Route [](#custom-login-route) Set a custom route for failed logins: ``` $panel->plugins([ \ChrisReedIO\Socialment\SocialmentPlugin::make() ->loginRoute('filament.staff.auth.login') // Or use a closure ->loginRoute(fn () => SomeFunctionToGetTheRouteName()) ]); ``` ### Login Hooks [](#login-hooks) Add custom logic before/after login: ``` // In a service provider's boot() method use ChrisReedIO\Socialment\Models\ConnectedAccount; use ChrisReedIO\Socialment\Facades\Socialment; use ChrisReedIO\Socialment\Exceptions\AbortedLoginException; public function boot(): void { // Pre-login hook Socialment::preLogin(function (ConnectedAccount $connectedAccount) { // Custom pre-login logic here Log::info('User about to login', ['provider' => $connectedAccount->provider]); }); // Post-login hook Socialment::postLogin(function (ConnectedAccount $connectedAccount) { Log::info('User logged in with ' . $connectedAccount->provider . ' account', [ 'user' => $connectedAccount->user->email, ]); }); } ``` #### Pre-login Hook: External Service Access Control [](#pre-login-hook-external-service-access-control) Use the pre-login hook to verify user access via an external service before allowing authentication: ``` use ChrisReedIO\Socialment\Models\ConnectedAccount; use ChrisReedIO\Socialment\Facades\Socialment; use ChrisReedIO\Socialment\Exceptions\AbortedLoginException; use Illuminate\Support\Facades\Http; public function boot(): void { // Check to see of the use has sufficient permissions to access the application. Socialment::preLogin(function (ConnectedAccount $connectedAccount) { // Sets up a hook on the 'plugin' itself // Handle custom post login logic here. $groups = (new GraphConnector($connectedAccount->token)) ->users()->groups($connectedAccount->provider_user_id); // Grab the results from the lazy collection $groupNames = collect($groups->pluck('displayName')->all()); // Filter the list of system roles by the groups the user is a member of in Azure AD $roles = Role::all()->filter(fn ($role) => $groupNames->contains($role->sso_group)); // Sync the user's roles with the filtered list $connectedAccount->user->roles()->sync($roles); // If the user has no roles, abort the login if ($connectedAccount->user->roles->isEmpty()) { throw new AbortedLoginException('You are not authorized to access this application.'); } }); } ``` ### Configuration File [](#configuration-file) Publish and customize the config: ``` php artisan vendor:publish --tag="socialment-config" ``` **Key config options:** ``` return [ 'view' => [ 'prompt' => 'Or Login Via', // Text above provider buttons 'providers-list' => 'socialment::providers-list', // Custom view ], 'models' => [ 'user' => '\\App\\Models\\User', // Custom user model ], ]; ``` --- Customization ------------- [](#customization) ### Custom Views [](#custom-views) Publish and customize the views: ``` php artisan vendor:publish --tag="socialment-views" ``` Views will be copied to `resources/views/vendor/socialment/`. ### Font Awesome Icons [](#font-awesome-icons) This package uses [Blade Font Awesome](https://github.com/owenvoke/blade-fontawesome) by [Owen Voke](https://github.com/owenvoke). Search for brand icons on the [Font Awesome Website](https://fontawesome.com/search?o=r&f=brands). --- SPA Authentication ------------------ [](#spa-authentication) Caution **๐Ÿงช Experimental Feature** This feature is still in development and highly experimental. Expect breaking changes and bugs. Use at your own risk. This feature may be spun off into a separate package in the future. ### Overview [](#overview-1) Enable shared authentication between your Filament backend and Single Page Application frontend. Both must be hosted on the same domain. ### Setup Steps [](#setup-steps) **1. Add SPA routes** to `routes/web.php`: ``` // Pass your SPA route prefix (default: 'spa') Route::spaAuth('dashboard'); Route::middleware('auth:sanctum') ->prefix('dashboard') ->as('dashboard.') ->group(function () { // Your SPA API routes }); ``` **2. Update CORS configuration** in `config/cors.php`: ``` 'paths' => [ // ... Other Paths 'spa/*', // Or your custom prefix ], 'supports_credentials' => true, ``` **3. Set environment variables:** ``` SANCTUM_STATEFUL_DOMAINS="https://frontend.localhost:3000,https://backend.localhost" SESSION_DOMAIN=".localhost" SESSION_SECURE_COOKIE=true SPA_URL="https://frontend.localhost:3000" ``` **Key points:** - `SESSION_DOMAIN` should start with a period (`.localhost`) - `SPA_URL` points to your frontend application - Both frontend and backend must share the same root domain ### SPA Configuration [](#spa-configuration) Update the config file: ``` 'spa' => [ 'home' => env('SPA_URL', 'http://localhost:3000'), 'responses' => [ // Custom JsonResource for API responses // 'me' => \App\Http\Resources\UserResponse::class, ], ], ``` --- Testing ------- [](#testing) Note Tests have yet to be written for this package. They are on the TODO list. PRs welcome! ``` composer test ``` --- Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Chris Reed](https://github.com/chrisreedio) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 62 โ€” FairBetter than 99% of packages Maintenance96 Actively maintained with recent releases Popularity49 Moderate usage in the ecosystem Community22 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 87.2% of commits โ€” single point of failure How is this calculated?**Maintenance (25%)** โ€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** โ€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** โ€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** โ€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~40 days Recently: every ~7 days Total 26 Last Release 23d ago Major Versions v3.10.1 โ†’ v4.0.0-beta.12025-08-20 v4.0.0-beta.1 โ†’ v5.0.0-beta.12026-02-09 4.x-dev โ†’ v5.0.12026-06-01 3.x-dev โ†’ 5.x-dev2026-06-12 PHP version history (2 changes)v3.0.0-betaPHP ^8.1 v4.0.0-beta.1PHP ^8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/77644584?v=4)[Chris Reed](/maintainers/chrisreedio)[@chrisreedio](https://github.com/chrisreedio) --- Top Contributors [![chrisreedio](https://avatars.githubusercontent.com/u/77644584?v=4)](https://github.com/chrisreedio "chrisreedio (231 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (17 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (9 commits)")[![atmonshi](https://avatars.githubusercontent.com/u/1952412?v=4)](https://github.com/atmonshi "atmonshi (6 commits)")[![pepperfm](https://avatars.githubusercontent.com/u/36007880?v=4)](https://github.com/pepperfm "pepperfm (1 commits)")[![ziming](https://avatars.githubusercontent.com/u/679513?v=4)](https://github.com/ziming "ziming (1 commits)") --- Tags authauthenfilamentfilamentphplaraveloauthoauth2socialitelaravelAuthenticationsocialitefilamentchrisreediosocialment ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/chrisreedio-socialment/health.svg) ``` [![Health](https://phpackages.com/badges/chrisreedio-socialment/health.svg)](https://phpackages.com/packages/chrisreedio-socialment) ``` ### Alternatives [rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin)[stephenjude/filament-two-factor-authentication Filament Two Factor Authentication: Google 2FA + Passkey Authentication 84215.9k9](/packages/stephenjude-filament-two-factor-authentication)[marcelweidum/filament-passkeys Use passkeys in your filamentphp app 6649.5k1](/packages/marcelweidum-filament-passkeys)[dutchcodingcompany/filament-socialite Social login for Filament through Laravel Socialite 2191.1M10](/packages/dutchcodingcompany-filament-socialite)[andrewdwallo/filament-companies A comprehensive Laravel authentication and authorization system designed for Filament, focusing on multi-tenant company management. 35156.4k2](/packages/andrewdwallo-filament-companies)[stephenjude/filament-jetstream A Laravel starter kit built with Filament inspired by Jetstream. 17760.2k3](/packages/stephenjude-filament-jetstream) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)