README

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.

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.
**

Edit composer.json

Edit your application's composer.json file to add this package to the require section as follows:

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

Update Composer

cd to your application's root folder and update composer as follows:

composer update

Edit config/app.php

Edit your application's config/app.php file:

Add the following to the providers section:

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

Add the following to the aliases section:

'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:

Change the providers/users/model array as follows:

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

Change the passwords/users/email array as follows:

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

Publish

cd to your application's root folder to publish assets, migrations, seeds, and middleware as follows:

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:

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

Database Migration

cd to your application's root folder and run the database migration

php artisan migrate

Database Seeder

cd to your application's root folder and run the database seeder.

Note: You may need to run composer dump-autoload before running the seeder

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

The installation is now complete!

Navigate to http://your-installation-url/knock

Sign in

For access to Users And Permissions and

username: developer@some-email-address.com

password: secret

For access to Users but NOT Permissions and

username: user-admin@some-email-address.com

password: secret

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