reliqarts/vanillasso

A way to connect your Laravel 5.* application into Vanilla Forum via jsConnect.

Laravel-VanillaSSO

This package allows you to use jsConnect of Vanilla Forums in your Laravel 5 application and is a fork of pdefreitas/vanillasso., _(*1)

, _(*2)

 , _(*3)

SSO (Single Sign-on) will save your time if you want to implement a forum on your Laravel 5 application., _(*4)

The package is availabe on Packagist https://packagist.org/packages/reliqarts/vanillasso, _(*5)

Installation

1. Install via composer; in console:, _(*6)

   composer require reliqarts/vanillasso
   

   or require in composer.json:, _(*7)

   {
       "require": {
           "reliqarts/vanillasso": "dev-master"
       }
   }
   

   then run composer update in your terminal to pull it in., _(*8)

2. Edit the providers array in app.php (app/config/app.php), _(*9)

   'providers' => [
       // ...
       'ReliQArts\VanillaSSO\VanillaSSOServiceProvider',
       // ...
   ],
   

3. Publish the vanillasso.php config file to make it accessible in app/config/packages/reliqarts/vanillasso/vanillasso.php, _(*10)

    php artisan config:publish reliqarts/vanillasso
   

Routes

An endpoint is automatically set based on your config. Default endpoint is: login/forum., _(*11)

Configuration

You can directly edit config\vanillasso.php or add it to your application., _(*12)

The configuration file looks like this:, _(*13)

return [
    // The string client ID that you set up in the jsConnect settings page.
    "client_id" => "",

    // The string secred that you set up in the jsConnect settings page.
    "secret" => "",

    // Endpoint
    "endpoint" => "",

    // User profile pic url.
    "profile_pic_url" => "http://mysite.dev/profile/pic/{user_id}",

    // Route related options.
    'routes' => [
        // Set the bindings for vanillasso
        'bindings' => [
            'middleware' => [
                'web',
                'auth',
            ]
        ]
    ],
];

Please note that this plugin supports MD5 and SHA1 hashes from JSconnect., _(*14)

License

Check LICENSE for more information., _(*15)

Credits

I want to thank Todd Burry from Vanilla Forums. This file helped producing this package: https://github.com/vanilla/jsConnectPHP/blob/master/functions.jsconnect.php, _(*16)

Trouble

If you use Vanilla 2.1 there is an annoying bug that you have to alter a table in order to jsConnect 1.4.1 be supported:, _(*17)

ALTER TABLE GDN_UserAuthenticationProvider ADD IsDefault BOOLEAN NOT NULL DEFAULT FALSE;