adamibrahim/superauth

Laravel 5.6 Authentication Package

Laravel 5.6 Superauth

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

• Laravel 5.6 Authentication package with
• Multi user type with roles (superadmin, admin, editor, user and featured user)
• User redirect to proper page (profile / admin dashboard)
• Registered user email confirmation using trait (Traits\AuthRedirect)
• User roles sync (include test views url /admin/test, /test/profile )
• Using Laravel Queue Jobs
• Customizable Markdown template for notifications (Confirm Email and Reset password)
• User soft delete (active/inactive)
• Auth roles editing method for testing at profile and dashboard
• All content, message and alerts are localized, languages files in two languages (English, Russian), to insert language switcher please visit my localization easy package adamibrahim/localization

Demo

• Demo account
• Username : admin@example.com
• Password : 123456

You can see working demo, _(*2)

Login / Profile / Dashboard Routes

``` bash - /login (user --not moderator-- login ) - /test/profile (user --not moderator-- profile ) - /admin/login (Moderator login) - /admin/test (Moderator dashboard), <sub>(*3)</sub>

## Install

``` bash
$ composer require adamibrahim/superauth

If you are installing at laravel 5.5 or higher then you may go directly to Publish other wise you will need to edit composer.json, register the Service Provider and the middleware

composer.json

Add this code to your composer.json under the autoload at your main directory, <sub>(*4)</sub>

``` bash "psr-4": { "Adam\Superauth\": "vendor/adamibrahim/superauth/src" }, <sub>(*5)</sub>

##### Service Provider

At file config/app.php register service provider under * Package Service Providers...

``` bash
Adam\Superauth\SuperauthServiceProvider::class,

Middleware

if you are using Laravel version lower than 5.5 then you need to register the moderators and Visitor middleware at your App\Http\Kernel.php - At protected $routeMiddleware = [ ] array add the below code, <sub>(*6)</sub>

``` bash 'moderators' => \Adam\Superauth\Middleware\Moderators::class, 'visitor' => \Adam\Superauth\Middleware\Visitor::class,, <sub>(*7)</sub>

##### Publishing

###### This will overwrite your User.php model 

``` bash
$ php artisan vendor:publish --tag=Superauth --force

Database Migrating

run the Artisan migration command, <sub>(*8)</sub>

``` bash $ php artisan migrate, <sub>(*9)</sub>

### Seeding
Run the Artisan Seeding command

``` bash
$ php artisan db:seed --class=Adam\Superauth\database\seeds\RolesTableSeeder

Artisan Seed Error

If you receive Class not found Error:, <sub>(*10)</sub>

ReflectionException : Class Adam\Superauth\database\seeds\RolesTableSeeder does not exist

Then you may need to dump-autoload by running this command ``` bash $ composer dump-autoload, <sub>(*11)</sub>

Then run the seeding command once again

``` bash
$ php artisan db:seed --class=Adam\Superauth\database\seeds\RolesTableSeeder

Job Queues

I'm Using Queues to send emails (speed up the app) however if you don't wish to use it you can change at your .env file, <sub>(*12)</sub>

QUEUE_DRIVER=sync

Change log

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

Testing

bash $ composer test, <sub>(*14)</sub>

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details., <sub>(*15)</sub>

Security

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

Credits

• Hostato
• All Contributors

License

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