Administrative interface builder for Laravel (Laravel admin)
PHP JavaScript HTML CSS
Latest commit 689e65d Jan 16, 2017 @butschster butschster fixed #410

README.md

bg

Laravel 5.* Admin Module

Build Status Scrutinizer Code Quality StyleCI Join the chat at https://gitter.im/LaravelRUS/SleepingOwlAdmin Latest Stable Version Total Downloads License

Note: This is the development version. If you are looking for the stable version check out master branch.

SleepingOwl Admin is an administrative interface builder for Laravel.

Official site: http://sleepingowladmin.ru

Requirements

  • php >= 5.6
  • Laravel 5.*
  • Capable hands

Documentation

Docs repo

Demo project

You can download the demo project at https://github.com/SleepingOwlAdmin/demo


Installation

  1. Require this package in your composer.json and run composer update:

    "require": {
      ...
      "laravelrus/sleepingowl": "4.*@dev"
    },
    

    Or composer require laravelrus/sleepingowl:4.*@dev

  2. After composer update, insert service provider SleepingOwl\Admin\Providers\SleepingOwlServiceProvider::class, before Application Service Providers... to the config/app.php

    Example

        ...
        /*
         * SleepingOwl Service Provider
         */
          SleepingOwl\Admin\Providers\SleepingOwlServiceProvider::class,
    
        /*
         * Application Service Providers...
         */
        App\Providers\AppServiceProvider::class,
        ...
  3. Run this command in the terminal (if you want to know more about what exactly this command does, see install command documentation):

$ php artisan sleepingowl:install

Installation

  • After all actions: open config/sleeping_owl.php and change 'middleware' => ['web'] to 'middleware' => []

Authentication

By default, admin module uses Laravel authentication.

If you want to use auth, you can run artisan command php artisan make:auth (https://laravel.com/docs/5.3/authentication) and append middleware auth to config/sleeping_owl.php

...
'middleware' => ['web', 'auth']
...

Supporting of old authentication

If you want to migrate from an older version you can use old auth.

Steps:

  1. Add new user provider in config/auth.php

    'providers' => [
      'users' => [
        'driver' => 'eloquent',
        'model' => App\User::class,
      ],
      'administrators' => [
        'driver' => 'eloquent',
        'model' => SleepingOwl\Admin\Auth\Administrator::class,
      ],
    ],
  2. Add new guards or change existing in config/auth.php

    'guards' => [
      'web' => [
        'driver' => 'session',
        'provider' => 'administrators', // change existing provider
      ],
    
      // or add new
    
      'admin' => [
        'driver' => 'session',
        'provider' => 'administrators',
      ],
    ],
  3. Setting up middleware

    By default auth middleware use default guard, selected in config/auth.php

    'defaults' => [
      'guard' => 'web', <- default
      ...
    ],

    You can change default guard to admin or change middleware in config/sleeping_owl.php to

    'middleware' => ['web', 'auth:admin'],

Used npm packages:

"devDependencies": {
   "jquery": "^2.1.4",
   "underscore": "1.8.3",
   "bootstrap": "^3.3.7",
   "eonasdan-bootstrap-datetimepicker": "^4.15.35",
   "font-awesome": "^4.6.3",
   "moment": "^2.14.1",
   "nestable": "^0.2.0",
   "noty": "^2.3.8",
   "sortablejs": "1.4.2",
   "select2": "^4.0.3",
   "metismenu": "^2.5.2",
   "datatables.net": "^1.10.12",
   "admin-lte": "^2.3.5",
   "x-editable": "^1.5.1",
   "dropzone": "4.3.0",
   "i18next": "^3.4.1",
   "vue": "^1.0.26",
   "vue-resource": "^0.9.3",
   "sweetalert2": "^4.1.0",
   "magnific-popup": "^1.1.0"
}

Copyright and License

Admin was written by Sleeping Owl for the Laravel framework and is released under the MIT License. See the LICENSE file for details.