hanson/speedy

A Laravel Admin Package to create a website quickly

Speedy

Introduce

Speedy is a Laravel admin package build with bootstrap and vue, it contains a sidebar menu , a authentication and a authorization control, _(*1)

中文文档, _(*2)

Install

In your laravel application, execute the following command:, _(*3)

composer require hanson/speedy, _(*4)

add service provider to the app.php:, _(*5)

    'providers' => [
        // Laravel Framework Service Providers...
        //...

        // Package Service Providers
        Hanson\Speedy\SpeedyServiceProvider::class,
        // ...

        // Application Service Providers
        // ...
    ]

publish resource:, _(*6)

php artisan vendor:publish --provider="Hanson\Speedy\SpeedyServiceProvider", _(*7)

after that, you might want to change some config about speedy:, _(*8)

// config/speedy.php
return [
    'class' => [
        'namespace' => 'App\\Models\\',
        'model' => [
            'role' => 'Role',
            'user' => 'User',
            'permission' => 'Permission',
            'permission_role' => 'PermissionRole',
        ]
    ],

    'table' => [
        'role' => 'role',
        'permission' => 'permission',
        'user' => 'users',
        'permission_role' => 'permission_role',
    ],
    // ...
]

By default, models will be storage to App/Models, and user table is user, or you can modify the config wherever you want, _(*9)

    'class' => [
        'namespace' => 'App\\Models\\',
        // 'namespace' => 'App\\', set model namespace as 'App\\'
        // ...
    ],
    'table' => [
        'user' => 'users', 
        // 'user' => 'user',set user table name to users
    ]

if you are using user as your table name, remember to modify the user's migration, _(*10)

install speedy:, _(*11)

php artisan speedy:install, _(*12)

create a new admin user, _(*13)

php artisan speedy:admin admin@email.com --create, _(*14)

or assign admin to an existing user, _(*15)

php artisan speedy:admin admin@email.com, _(*16)

make auth by default, _(*17)

php artisan make:auth, _(*18)

and modify the $redirectTo = '/home' to $redirectTo = /admin in LoginController, _(*19)

Start up a built-in development server, with php artisan serve, visit http://localhost:8000/admin., _(*20)

Menu And Permission

Speedy sidebar Menus is a very convenient component, you just need to modify the speedy config and run a command to recreate the menu., _(*21)

Speedy Permission is simple, it can't deal with complicated situation. Each single menu have a permission to control it. Which mean whoever can see this menu can access everything in it., _(*22)

    # speedy.php
    'menus' => [
        'user' => [
            'display' => 'User',
            'url' => '/admin/user'
        ],
        'role' => [
            'display' => 'Role',
            'url' => '/admin/role'
        ],
        'about' => [
            'display' => 'About HanSon',
            'sub' => [
                'github' => [
                    'display' => 'HanSon\'s Github',
                    'url' => 'https://github.com/hanson',
                    'target' => '_blank'
                ],
                'blog' => [
                    'display' => 'HanSon\'s Blog',
                    'url' => 'http://hanc.cc'
                ]
            ]
        ],
    ]

After modify the menu, run php artisan speedy:menu to recreate the menu and permission., _(*23)

Role

Every user has one role. Speedy user admin as a default role and own every permission, even though you modify the menu and run the recreate menu command., _(*24)

Middleware

Speedy provider a middleware name speedy.auth in Hanson\Speedy\Http\Middleware\SpeedyAdminMiddleware, every admin route must add it to keep application save., _(*25)

Hanson\Speedy\Http\Controllers\BaseController will add middleware automatic., _(*26)

protected $permissionName;

public function __construct()
{
    $this->middleware('speedy.auth:' . $this->permissionName);
}

You can make your admin controller extends Hanson\Speedy\Http\Controllers\BaseController and set $permissionName as the menu key., _(*27)

Validate

Speedy has separate the validate rule in config/validator, in the controller, you can use method $validator = $this->mustValidate('{model}.{method}'); to validate the data. The error will display as you define by resources/lang/en/attributre., _(*28)

View

The blade file will be publish in resources/views/vendor/speedy, and you might want to change the resource link in resources/views/vendor/speedy/layouts/app.blade.php, _(*29)