kawsuj/knock

Provides role-based application permissions for Laravel applications using security tags

Knock: Roles and Permissions

Description

Provides a simple framework for Laravel 5.2 projects requiring user roles and permissions. It includes a user interface to manage your application's users and their permitted actions., _(*1)

Installation

** Please note that these installation notes assume you have a clean installation of Laravel 5.2. Running the database migration will delete and recreate your users table if you already have one.
**, _(*2)

Edit composer.json

Edit your application's composer.json file to add this package to the require section as follows:, _(*3)

"require": {
    "kawsuj/knock": "dev-master"
}

Update Composer

cd to your application's root folder and update composer as follows:, _(*4)

composer update

Edit config/app.php

Edit your application's config/app.php file:, _(*5)

Add the following to the providers section:, _(*6)

yajra\Datatables\DatatablesServiceProvider::class,
Collective\Html\HtmlServiceProvider::class,
Knock\KnockServiceProvider::class,

Add the following to the aliases section:, _(*7)

'Form'      => Collective\Html\FormFacade::class,
'Html'      => Collective\Html\HtmlFacade::class,
'Datatables'=> yajra\Datatables\Datatables::class,
'Knock' =>  Knock\Facades\Knock::class,

Edit config/auth.php

Edit your application's config/auth.php file:, _(*8)

Change the providers/users/model array as follows:, _(*9)

'model' => Knock\User::class,

Change the passwords/users/email array as follows:, _(*10)

'email' => 'knock::auth.emails.password',

Publish

cd to your application's root folder to publish assets, migrations, seeds, and middleware as follows:, _(*11)

php artisan vendor:publish --tag=knock

Edit app/Http/Kernel.php

Edit your application's app/Http/Kernel.php file and add the following to the $routeMiddleware array:, _(*12)

'knock' => \App\Http\Middleware\RedirectIfNotKnockUser::class,

Database Migration

cd to your application's root folder and run the database migration, _(*13)

php artisan migrate

Database Seeder

cd to your application's root folder and run the database seeder., _(*14)

Note: You may need to run composer dump-autoload before running the seeder, _(*15)

composer dump-autoload
php artisan db:seed --class=KnockDatabaseSeeder

The installation is now complete!, _(*16)

Navigate to http://your-installation-url/knock, _(*17)

Sign in

For access to Users And Permissions and, _(*18)

username: developer@some-email-address.com, _(*19)

password: secret, _(*20)

For access to Users but NOT Permissions and, _(*21)

username: user-admin@some-email-address.com, _(*22)

password: secret, _(*23)

When signed in, you will be directed to the Knock home page where there are further user instructions., _(*24)