humweb/sociable

Socialite authentication and persistence layer implementation.

Sociable

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

Socialite authentication and persistence layer implementation., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require humweb/sociable, <sub>(*4)</sub>

**Add ServiceProvider**

In the `providers` array add the service providers for this package.
 ```php
 Humweb\Sociable\ServiceProvider::class
 ```

**Publish configuration in Laravel 5**
```bash  
$ php artisan vendor:publish --provider="Humweb\Sociable\ServiceProvider"

Run database migration, <sub>(*5)</sub>

$ php artisan migrate"

Configure user auth driver and provider configs, <sub>(*6)</sub>

<?php

// config/sociable.php

return [

    // Builtin options: laravel, sentinel
    'auth_provider' => 'laravel',

    // Optional provider list, mainly used to list login buttons.
    'providers' => [
        'google',
        'github',
        'twitter'
    ]
];

Add Sociable trait to user model, <sub>(*7)</sub>

class User extends Authenticatable
{
    use Sociable;
}

Getting started

See Humweb\Sociable\Http\Controllers\AuthController.php for: * OAuth login * Link third-party service to a user account, <sub>(*8)</sub>

Example AuthController (Auto-link third-party account after normal login)

<?php

class AuthController extends Controller
{
    /**
     * Login
     */
    public function getLogin(Request $request)
    {

        // Remove social data from session upon request
        if ($request->exists('forget_social')) {
            $request->session()->forget('social_link');
        }

        return view('login');
    }


    public function postLogin(Request $request)
    {

        // Gather credentials
        $credentials = [
            'username' => $request->get('username'),
            'password' => $request->get('password'),
        ];

        if ($user = \Auth::attempt($credentials, $remember)) {

            // Check for social data in session
            if ($request->session()->has('social_link')) {

                // Grab data from session
                $social = $request->session()->get('social_link');
                $user->attachProvider($social['provider'], $social);

                // Remove link data
                $request->session()->forget('social_link');

                return redirect()
                    ->intended('/')
                    ->with('success', 'Account connected to "'.$social['provider'].'" successfully.');
            }

            return redirect()->intended('/');
        }

        // Default error message
        return back()
            ->withInput()
            ->withErrors('Invalid login or password.');
    }

}

Example message for your login page to remove session info

This can help if the user did not want to auto link the accounts after login., <sub>(*9)</sub>

@if (session()->has('social_link'))
    <div class="alert alert-info">
        Login to link your "{{ session('social_link.provider') }}" and "<Your Site>" accounts. <br>
        If this is not what you want <a href="/login?forget_social">click here</a> to refresh.
    </div>
@endif

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*10)</sub>

Testing

bash $ phpunit, <sub>(*11)</sub>

Security

If you discover any security related issues, please email :author_email instead of using the issue tracker., <sub>(*12)</sub>

Credits

• Ryan Shofner

License

The MIT License (MIT). Please see License File for more information., <sub>(*13)</sub>