raymondwilkinson/manager

Easily add new or override built-in providers in Laravel Socialite.

Thursday, June 22, 2017
by RaymondWilkinson
Repository
1 Watchers
0 Stars
124 Installations

PHP
2 Dependents
0 Suggesters
43 Forks
0 Open issues
36 Versions
0 % Grown

The README.md

Socialite Providers Manager

, _(*1)

About

A package for Laravel Socialite that allows you to easily add new providers or override current providers., _(*2)

Benefits

You will have access to all of the providers that you load in using the manager.
Instantiation is deferred until Socialite is called
You can override current providers
You can create new providers
Lumen usage is easy
stateless() can be set to true or false
You can override a config dynamically
It retrieves environment variables directly from the .env file instead of also having to configure the services array.

Available Providers

See the SocialiteProviders list
You can also make your own or modify someone else's

Reference

Creating a Handler

Below is an example handler. You need to add this full class name to the listen[] in the EventServiceProvider., _(*3)

See also the Laravel docs about events.
providername is the name of the provider such as meetup.
You will need to change your the namespacing and class names of course.

namespace Your\Name\Space;

use SocialiteProviders\Manager\SocialiteWasCalled;

class ProviderNameExtendSocialite
{
    public function handle(SocialiteWasCalled $socialiteWasCalled)
    {
        $socialiteWasCalled->extendSocialite('providername', \Your\Name\Space\Provider::class);
    }
}

Creating a Provider

Look at the already created providers for inspiration.
See this article on Medium

Overriding a Built-in Provider

You can easily override a built-in laravel/socialite provider by creating a new one with exactly the same name (i.e. 'facebook')., _(*4)

Dynamically Passing a Config

You can dynamically pass a config by using:, _(*5)

$clientId = "secret";
$clientSecret = "secret";
$redirectUrl = "http://yourdomain.com/api/redirect";
$additionalProviderConfig = ['site' => 'meta.stackoverflow.com'];
$config = new \SocialiteProviders\Manager\Config($clientId, $clientSecret, $redirectUrl, $additionalProviderConfig);
return Socialite::with('provider-name')->setConfig($config)->redirect();

You must call this before you run any Socialite methods., _(*6)

Creating an OAuth1 Server Class

Take a look at the other OAuth1 providers for inspiration., _(*7)

Getting the Access Token Response Body

Laravel Socialite by default only allows access to the access_token. Which can be accessed via the \Laravel\Socialite\User->token public property. Sometimes you need access to the whole response body which may contain items such as a refresh_token., _(*8)

To make this possible, the OAuth2 provider class needs to extend \SocialiteProviders\Manager\OAuth2\AbstractProvider and OAuth1 providers need to utilize the \SocialiteProviders\Manager\OAuth1\AbstractProvider and \SocialiteProviders\Manager\OAuth1\Server., _(*9)

You can access it from the user object like so: $user->accessTokenResponseBody, _(*10)

The Versions

22/06 2017

dev-master

9999999-dev

Easily add new or override built-in providers in Laravel Socialite.

library manager

Easily add new or override built-in providers in Laravel Socialite.

raymondwilkinson/manager

The README.md

Socialite Providers Manager

About

Benefits

Available Providers

Reference

Creating a Handler

Creating a Provider

Overriding a Built-in Provider

Dynamically Passing a Config

Creating an OAuth1 Server Class

Getting the Access Token Response Body

The Versions

dev-master

The Requires

The Development Requires

by Andy Wendt

v3.0.0

The Requires

The Development Requires

by Andy Wendt

v2.2.2

The Requires

The Development Requires

by Andy Wendt

v2.2.1

The Requires

The Development Requires

by Andy Wendt

v2.2.0

The Requires

The Development Requires

by Andy Wendt

v2.1.4

The Requires

The Development Requires

by Andy Wendt

v2.1.3

The Requires

The Development Requires

by Andy Wendt

v2.1.2

The Requires

The Development Requires

by Andy Wendt

v2.1.1

The Requires

The Development Requires

by Andy Wendt

v2.1.0

The Requires

The Development Requires

by Andy Wendt

v2.0.2

The Requires

The Development Requires

by Andy Wendt

v2.0.1

The Requires

The Development Requires

by Andy Wendt

v2.0.0

The Requires

The Development Requires

by Andy Wendt

dev-develop

The Requires

The Development Requires

by Andy Wendt

1.2.4

The Requires

The Development Requires

by Andy Wendt

1.2.3

The Requires

The Development Requires

by Andy Wendt