laravel-package laravel-oauth {🖫 16, ⚐ 10, ★ 31}

mckenziearts/laravel-oauth

Social OAuth authentication for Laravel 5. Drivers: Facebook, Twitter, Google, LinkedIn, Github

Thursday, July 19, 2018
by Mckenziearts
Repository
2 Watchers
31 Stars
16 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
10 Versions
0 % Grown

The README.md

, _(*1)

![Total Downloads][ico-downloads] , _(*2)

Introduction

Social OAuth authentication for Laravel 5 which provides oAuth support in PHP 5.3+ and is very easy to integrate with any project which requires an oAuth client. This package use Laravel Socialite. For Laravel 4 look this package, _(*3)

Supported services

The library supports OAuth 2.0 compliant services. A list of currently implemented services can be found below. More services will be implemented soon., _(*4)

Included service implementations:, _(*5)

OAuth2
- Facebook
- GitHub
- Google
- Instagram
- LinkedIn
- Bitbucket
- Twitter
- Dribbble
- Pinterest
- Youtube
- Gitlab
more to come!

Laravel Support version, _(*6)

Laravel	laravel-oauth
<=5.5	^1.0
6.0	^1.1

Installation

Include the package in your project using Composer, _(*7)

shell $ composer require mckenziearts/laravel-oauth, _(*8)
Add the service provider to your config/app.php providers array:, _(*9)

For Laravel 5.5.+ - you're done., _(*10)
```
Mckenziearts\LaravelOAuth\LaravelOAuthServiceProvider::class,
```

Publish the Vendor Assets files by running:, _(*11)

php artisan vendor:publish --provider="Mckenziearts\LaravelOAuth\LaravelOAuthServiceProvider"

Now that we have published a few new files to our application we need to reload them with the following command:, _(*12)
```
composer dump-autoload
```

Configuration

When you published the vendor assets you added a new file inside of your config folder which is called config/laravel-oauth.php. This file contains a bunch of configuration you can use to configure your connexion using social networks., _(*13)

First, you have to add your service like is defined on The official documentation of Socialite available here. Just setup your Oauth services for your application. Laravel/socialite is automatically installed by this package., _(*14)

Usage

Fisrt of all in the config/laravel-oauth.php file you must define the default users table name to simplify migrations. By default users table is used, _(*15)
```
'users' => [
  'table'   => 'users',
],
```
Secondly you must specify the providers to use for social login in the providers array. To active a provider set the value to true, _(*16)
```
'providers' => [
  'facebook'  => true,
  'google'    => true,
  'github'    => true,
],
```

The last configuration is to stylize the button by editing class name and add or remove icon, _(*17)

, _(*18)

Next, if you may want to re-publish the laravel-oauth assets, config, and the migrations run the following command:, _(*19)

php artisan vendor:publish --tag=laravel-oauth.assets --force
php artisan vendor:publish --tag=laravel-oauth.config --force
php artisan vendor:publish --tag=laravel-oauth.migrations --force

Next to make sure you have the latest database schema run:, _(*20)
```
php artisan migrate
```
Inside of your master.blade.php file include a header yield. Inside the head of your master or app.blade.php add the following:, _(*21)
```
@yield('css')
```
Add the blade directive to your view where you want to display the socials buttons. The directive takes a parameter login to display the login text or resgister for the text related to the registration, _(*22)
```
@socialite('login')
```
Add the style of the buttons by adding this to your view in the section in the @yield('css') who defined in your master layout, _(*23)

@section('css')
    <link href="{{ url('/vendor/mckenziearts/laravel-oauth/assets/css/socialite.css') }}" rel="stylesheet">
@endsection

In the Auth\LoginController of your application, add the OAuthSocialite trait:, _(*24)

namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use Illuminate\Foundation\Auth\AuthenticatesUsers;
use Mckenziearts\LaravelOAuth\Traits\OAuthSocialite;

class LoginController extends Controller
{
  use OAuthSocialite;
  ..

With this feature you can overwrite the present methods on the trait if you want to customize them even more, _(*25)

Add this routes to your default web route file, _(*26)

Route::get('/auth/{provider}', 'Auth\LoginController@redirectToProvider');
Route::get('/callback/{provider}', 'Auth\LoginController@handleProviderCallback');