zfort / social-auth
Easy social auth integration with a lot of available providers
Requires
- php: ~7.0
- illuminate/broadcasting: ^5.4
- illuminate/database: ^5.4
- illuminate/events: ^5.4
- illuminate/routing: ^5.4
- illuminate/support: ^5.4
- socialiteproviders/manager: ~2.0 || ~3.0
Requires (Dev)
- mockery/mockery: ^0.9.8
- orchestra/testbench: ^3.4
- phpunit/phpunit: ^5.7
This package is not auto-updated.
Last update: 2022-02-01 13:06:29 UTC
README
This package give ability to
- Sign In
- Sign Up
- Attach/Detach social network provider to the existing account
Install
Via Composer
$ composer require zfort/social-auth
Now add the service provider in config/app.php file:
'providers' => [ // ... ZFort\SocialAuth\SocialAuthServiceProvider::class, ];
You can publish the migration with:
$ php artisan vendor:publish --provider="ZFort\SocialAuth\SocialAuthServiceProvider" --tag="migrations"
The package assumes that your users table name is called "users". If this is not the case you should manually edit the published migration to use your custom table name.
After the migration has been published you can create the social_providers table for storing supported providers and user_has_social_provider pivot table by running the migrations:
$ php artisan migrate
You can publish the config-file with:
$ php artisan vendor:publish --provider="ZFort\SocialAuth\SocialAuthServiceProvider" --tag="config"
This is the contents of the published config/social-auth.php config file:
return [ /* |-------------------------------------------------------------------------- | Additional service providers |-------------------------------------------------------------------------- | | The social providers listed here will enable support for additional social | providers which provided by https://socialiteproviders.github.io/ just | add new event listener from the installation guide | */ 'providers' => [ // ], 'models' => [ /* * When using the "UserSocialite" trait from this package, we need to know which * Eloquent model should be used to retrieve your available social providers. Of course, it * is often just the "SocialProvider" model but you may use whatever you like. */ 'social' => \ZFort\SocialAuth\Models\SocialProvider::class, /* * User model which you will use as "SocialAuthenticatable" */ 'user' => \App\User::class, ], 'table_names' => [ /* |-------------------------------------------------------------------------- | Users Table |-------------------------------------------------------------------------- | | The table for storing relation between users and social providers. Also there is | a place for saving "user social network id", "token", "expiresIn" if it exist | */ 'user_has_social_provider' => 'user_has_social_provider', /* |-------------------------------------------------------------------------- | Social Providers Table |-------------------------------------------------------------------------- | | The table that contains all social network providers which your application use. | */ 'social_providers' => 'social_providers' ], 'foreign_keys' => [ /* * The name of the foreign key to the users table. */ 'users' => 'user_id', /* * The name of the foreign key to the socials table */ 'socials' => 'social_id' ], /* |-------------------------------------------------------------------------- | Authentication redirection |-------------------------------------------------------------------------- | | Redirect path after success/error login via social network | */ 'redirect' => '/home' ];
Or you can publish and modify view templates with:
$ php artisan vendor:publish --provider="ZFort\SocialAuth\SocialAuthServiceProvider" --tag="views"
Also you can publish and modify translation file:
$ php artisan vendor:publish --provider="ZFort\SocialAuth\SocialAuthServiceProvider" --tag="lang"
Add credetials to your project
File .env
FB_ID = <FacebookID> FB_SECRET = <FacebookSecret> FB_REDIRECT = <your.domain>/social/facebook/callback GOOGLE_ID = <GoogleID> GOOGLE_SECRET = <GoogleSecret> GOOGLE_REDIRECT = <your.domain>/social/google/callback GITHUB_ID = <GithubID> GITHUB_SECRET = <GithubSecret> GITHUB_REDIRECT = <your.domain>/social/github/callback
File config/services.php
'facebook' => [ 'client_id' => env('FB_ID'), 'client_secret' => env('FB_SECRET'), 'redirect' => env('FB_REDIRECT') ], 'google' => [ 'client_id' => env('GOOGLE_ID'), 'client_secret' => env('GOOGLE_SECRET'), 'redirect' => env('GOOGLE_REDIRECT') ], 'github' => [ 'client_id' => env('GITHUB_ID'), 'client_secret' => env('GITHUB_SECRET'), 'redirect' => env('GITHUB_REDIRECT') ]
After that, create your social providers in the database
SocialProvider::create(['label' => 'Facebook', 'slug' => 'facebook']); SocialProvider::create(['label' => 'Google', 'slug' => 'google']); SocialProvider::create(['label' => 'github', 'slug' => 'Github']);
Or add rows directly
You can add additional scopes and parameters to the social auth request
SocialProvider::create([ 'label' => 'github', 'slug' => 'Github', 'scopes' => ['foo', 'bar'], 'parameters' => ['foo' => 'bar'] ]);
To override default scopes
$SocialProvider->setScopes(['foo', 'bar'], true);
Include social buttons into your templates
@include('social-auth::attach') // for authenticated user to attach/detach another socials @include('social-auth::buttons') // for guests to login via
Prepare your user model
Implement SocialAuthenticatable interface
Add UserSocialite trait to your User model
namespace App\Models; use Illuminate\Database\Eloquent\Model; use ZFort\SocialAuth\Traits\UserSocialite; use ZFort\SocialAuth\Contracts\SocialAuthenticatable; class User extends Model implements SocialAuthenticatable { use UserSocialite; ... }
Routes
If you need do some custom with social flow, you should define yourself controllers and put your custom url into routes file.
For example
Route::get('social/{social}', 'Auth\SocialAuthController@getAccount'); Route::get('social/{social}/callback', 'Auth\SocialAuthController@callback'); Route::get('social/{social}/detach', 'SocialAuthController@deleteAccount');
In case if you no need any special functionality ypu can use our default controllers
Customize for your project
Custom User Model
User model we takes from the config('social-auth.models.user');
User Fields Mapping
SocialAuthenticatable interface contains method mapSocialData
for mapping social fields for user model
If you need you can redefine this method for your preferences project in your UserModel
Change log
Please see CHANGELOG for more information on what has changed recently.
Testing
$ composer test
Contributing
Please see CONTRIBUTING and CONDUCT for details.
Security
If you discover any security related issues, please email developer@zfort.com instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.