artemzi / sleepingowladmin

🦉 Administrative interface builder for Laravel (Laravel admin)

Laravel >=5.2 Admin Module

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.

Changelog: look at changes first

Official site: http://sleepingowladmin.ru

Requirements

• php >= 5.6
• Laravel >= 5.2
• Capable hands

Documentation

• Russian
• English

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

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.