looxii / mojito

Mojito admin is a component of laravel, vue, element build backend system

Mojito

Mojito is a backend management system based on Laravel, Vue, Element.

Simplified Chinese

中文README

Screenshot

Feature

• Quickly derive multiple backend systems
• Built-in role, permissions, user, menu management
• OAuth 2.0 and support multi-table authentication
• Complete PHPUnit test
• The minimum unit of API privilege is routing, and the minimum unit of page privilege is button or link.
• SPA
• Multi-tab page
• Support for multi-language configuration
• Simple page layout

Requirements

• Laravel >= 5.5.0
• Vue >= 2.5.17
• Element >= 2.4.6

Compatibility

Laravel	Mojito admin
5.5, 5.6	1.0.*
5.7+	1.1.*

Installation

First install laravel and make sure you have the correct database connection configured.

composer require moell/mojito

If there is a conflict caused by the random_compat version, manually add moell/mojito to composer.json and then composer update to install.

Then run the following command to publish the resource:

php artisan mojito:install

Successful execution of the command will generate configuration files, data migration, and building SPA files.

Add the appropriate guards and providers to config/auth.php as follows:

'guards' => [
        ...
        'admin' => [
            'driver' => 'passport',
            'provider' => 'admin'
        ]
    ],

'providers' => [
        ...
        'admin' => [
            'driver' => 'eloquent',
            'model' => \Moell\Mojito\Models\AdminUser::class,
        ]
    ],

Add oauth.providers and mojito.permission in the middle of the $routeMiddleware property in app/Http/Kernel.php and replace the auth middleware with the following:

class Kernel extends HttpKernel
{
    protected $routeMiddleware = [
        // 'auth' => \Illuminate\Auth\Middleware\Authenticate::class,
        'auth' => \SMartins\PassportMultiauth\Http\Middleware\MultiAuthenticate::class,
        'oauth.providers' => \SMartins\PassportMultiauth\Http\Middleware\AddCustomProvider::class,
        'mojito.permission' => \Moell\Mojito\Http\Middleware\Authenticate::class,
    ];
}

Perform data migration, data filling

php artisan migrate

php artisan db:seed --class="Moell\Mojito\Database\MojitoTableSeeder"

Passport installation and configuration

php artisan passport:install

After successful execution, obtain the corresponding password to grant the client's ID and secret and configure it to the corresponding resources/config/index.js :

export default {
  admin: {
    authorize: {
      clientId: ID,
      clientSecret: secret
    }
}

Install JavaScript Dependencies

npm install
npm install -D vuex@^3.0.1 vue-router@^3.0.1 vue-i18n@^8.1.0 localforage@^1.7.2 element-ui@^2.9.1

Add admin.js to webpack.mix.js

mix.js('resources/assets/js/app.js', 'public/js')
    .sass('resources/assets/sass/app.scss', 'public/css')
    //.js('resources/js/admin.js', 'public/js') laravel5.7+
    .js('resources/assets/js/admin.js', 'public/js')

Run Mix

#npm run watch
npm run production

Log in

url: http://localhost/mojito#/admin/login

email: [e-mail]

password: secret

Dependent on open source software

• Laravel
• Vue
• Element UI
• laravel/passport
• smartins/passport-multiauth
• spatie/laravel-permission
• orchestra/testbench

Reward

License

Apache License Version 2.0 see http://www.apache.org/licenses/LICENSE-2.0.html