shawnsandy/dash-auth

Dash auth

Dashauth

Dash Auth is simple way to create & manage Bouncer Roles & Abilities., _(*1)

Install

Via Composer, _(*2)

``` json "repositories": [ { "type": "vcs", "url": "https://github.com/shawnsandy/dash-auth" } ],, <sub>(*3)</sub>

* Add the package to your `composer.json` file as VCS repository, sorry there is no packagist install just yet.

``` bash
$ composer require shawnsandy/dash-auth

• From the command prompt run the above to install the package

Usage

Quick Start Laravel 5.5x and greater, <sub>(*4)</sub>

``` txt SUPER_ADMIN_EMAIL=my_super_admin_here@mysite.me, <sub>(*5)</sub>

* Add the SUPER_ADMIN_EMAIL to your .env file with the email of the registered user that will act as your super-admin.

``` bash
php artisan vendor:publish --tag=dashauth-config

• From the console use the --tag option to publish config file

``` php 'roles' => [ 'superadmin' => "Super Admin", 'admin' => "Admin", 'staff' => "Staff", 'editor' => "Editor", 'member' => "Member", ],, <sub>(*6)</sub>

'abilities' => [
    'assign_roles' => 'Assign Roles',
    'manage_users' => 'Manage Users',
    'manage_posts' => 'Manage Posts',
    'manage_admin' => 'Manage Site',
    'manage_systems' => 'Manage Systems',
],

* Edit the config settings (optional), go to `config/dashauth.php`


``` php
Dashauth::routes();

• Add the default dash routes, open routes\web.php file and add the above

, <sub>(*7)</sub>

Setup SuperAdmin Role, <sub>(*8)</sub>

• Set the superadmin email in you .env file SUPERADMIN_EMAIL=youremail@you.com
• Next go to yoursite.com/dashauth and create a super admin
• Manage \ View privileges yoursite.com/dashauth/privileges

Manage Roles Component, <sub>(*9)</sub>

Add the manage roles component to application passing the user info $user = User::find(1), <sub>(*10)</sub>

``` php, <sub>(*11)</sub>

Manage Roles, <sub>(*12)</sub>

@component("dashauth::forms.privileges", [ "user" => $user ) ]) @slot('btn_class') button is-link is-large is-uppercase @endslot @endcomponent, <sub>(*13)</sub>

* Dash auth comes with a simple component to manage roles you can add the component `forms.roles` component to you user record.


![Alt text](/screenshot-manage-ability.jpeg?raw=true)

__Manage Abilities (privileges)__

``` php
 @component('dashauth::components.privileges')
 ```

* Assign and remove abilities to/from using the `dashauth::components.privileges` component.

 __Larvel 5.4x__

Add the service provider to the config/app.php file

``` php
"providers" => [
    ShawnSandy\DashAuth\DashAuthServicesProvider::class,
]

Add the facade to config/app.php file, <sub>(*14)</sub>

``` php aliases => [ "Dashauth" => ShawnSandy\DashAuth\DashAuthFacade::class, ], <sub>(*15)</sub>

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Testing

``` bash
$ composer test

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*16)</sub>

Security

If you discover any security related issues, please email shawnsandy04@gmail.com instead of using the issue tracker., <sub>(*17)</sub>

Credits

• [Shawn Sandy][link-author]
• [All Contributors][link-contributors]

License

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