PHPackages                             ronappleton/socialiser - 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. ronappleton/socialiser

ActiveLibrary[Authentication & Authorization](/categories/authentication)

ronappleton/socialiser
======================

Extends Laravels Socialite with extra providers and usage

023[5 PRs](https://github.com/ronappleton/socialiser/pulls)PHP

Since Jan 8Pushed 3y agoCompare

[ Source](https://github.com/ronappleton/socialiser)[ Packagist](https://packagist.org/packages/ronappleton/socialiser)[ RSS](/packages/ronappleton-socialiser/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (6)Used By (0)

[![License](https://camo.githubusercontent.com/70dfef8df3269d1f23aceaf240ed35e739020a1fe7ad166d702549305bc0bfc2/68747470733a2f2f706f7365722e707567782e6f72672f6c61726176656c2f736f6369616c6974652f6c6963656e73652e737667)](https://packagist.org/packages/laravel/socialite)

Introduction
------------

[](#introduction)

Socialiser is a rebuild of Laravel Socialite which provides an expressive, fluent interface to OAuth authentication with Facebook, Instagram, Twitter, Google, YouTube, LinkedIn, GitHub and Bitbucket. It handles almost all of the boilerplate social authentication code you are dreading writing.

This adaption of Socialite goes further by adding in the controllers, seperate configuration, migration, and storage of social data to allow super speed integration of social services into your application, If using Laravel version 5.5+ you can require this package and link your buttons, Socialiser will take care of registering and connecting to your chosen social services storing your social data .

In-fact the only manual step you will need to take if planning on storing the social data is to run the artisan command:

```
    php artisan socialiser:migrate

```

\*\*NOTE: If you want to link your user to their social data though, open up config/socialiser and set your fully namespaced user model i.e: App\\User, socialiser will then add the foreign key back to the users id when running its migration. The name of the user model is irrelevant, as is the name of the user table, just set fully namespaced user model and socialiser will find your user table, you can also set the primary key column in the configuration too, if left blank socialiser will assume 'id' as per Laravel standards. You can in-fact set the model, table and id column name within the config file

Socialiser will also add its own routes:

```
    socialiser/login/{provider}
    socialiser/login/{provider}/callback

    socialiser/connect/{provider}
    socialiser/connect/{provider}/callback

```

These are what allows us to get running out of the box (bar aquiring your api keys).

We have seperations for login and connect to allow us to limit which services we can register by or connect to, these can be set in the socialiser.php file in config folder.

Additionally within the config file you can set the fully namespace user model you are using, allowing the socialiser migration to add the foreign key so the socialiser\_provider\_user

**We are not accepting new adapters.**

**If you are using Laravel 5.3 or below, please use [Socialite 2.0](https://github.com/laravel/socialite/tree/2.0).**

Adapters for other platforms are listed at the community driven [Socialite Providers](https://socialiteproviders.github.io/) website.

License
-------

[](#license)

Laravel Socialite is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)

Official Documentation
----------------------

[](#official-documentation)

In addition to typical, form based authentication, Laravel also provides a simple, convenient way to authenticate with OAuth providers using [Laravel Socialite](https://github.com/laravel/socialite). Socialite currently supports authentication with Facebook, Twitter, LinkedIn, Google, GitHub and Bitbucket.

To get started with Socialite, use Composer to add the package to your project's dependencies:

```
composer require laravel/socialite

```

### Configuration

[](#configuration)

After installing the Socialite library, register the `Laravel\Socialite\SocialiteServiceProvider` in your `config/app.php` configuration file:

```
'providers' => [
    // Other service providers...

    Laravel\Socialite\SocialiteServiceProvider::class,
],
```

Also, add the `Socialite` facade to the `aliases` array in your `app` configuration file:

```
'Socialite' => Laravel\Socialite\Facades\Socialite::class,
```

You will also need to add credentials for the OAuth services your application utilizes. These credentials should be placed in your `config/services.php` configuration file, and should use the key `facebook`, `twitter`, `linkedin`, `google`, `github` or `bitbucket`, depending on the providers your application requires. For example:

```
'github' => [
    'client_id' => 'your-github-app-id',
    'client_secret' => 'your-github-app-secret',
    'redirect' => 'http://your-callback-url',
],
```

If the `redirect` option contains a relative path, it will automatically be resolved to a fully qualified URL.

### Basic Usage

[](#basic-usage)

Next, you are ready to authenticate users! You will need two routes: one for redirecting the user to the OAuth provider, and another for receiving the callback from the provider after authentication. We will access Socialite using the `Socialite` facade:

```