README

Laravel 5.2 后台管理模块

Note: 这是开发分支，如果你需要稳定版本，请检出 master branch.

这是一个管理界面生成器，很简单的接入在Laravel.

使用到的bower包:

• jquery
• bootstrap
• bootbox
• datetimepicker
• fontawesome
• moment
• nestable
• noty
• ckeditor
• Sortable
• select2
• flow.js
• ekko-lightbox
• metisMenu
• datatables
• startbootstrap-sb-admin-2

安装

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

"require": {
  "php": ">=5.5.9",
  "laravel/framework": "5.2.*",
  ...
  "laravelrus/sleepingowl": "4.*@dev"
},

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

1. 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,
    ...

1. 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

Laravel 5.1 usage

SleepingOwl are compatible with Laravel 5.1. But full performance is not guaranteed.

Installation

• See Installation section of Laravel 5.2
• After all actions: open config/sleeping_owl.php and change 'middleware' => ['web'] to 'middleware' => []

Upgrade from 4.18.x to 4.19.x

HtmlAttributes

Class has been moved to composer package kodicomponents\support for using in other projects and methods have been changed for more compatibility.

• setAttribute -> setHtmlAttribute
• setAttributes -> setHtmlAttributes
• getAttribute -> getHtmlAttribute
• getAttributes -> getHtmlAttributes
• hasAttribute -> hasHtmlAttribute
• replaceAttribute -> replaceHtmlAttribute
• removeAttribute -> removeHtmlAttribute
• clearAttributes -> clearHtmlAttributes
• hasClass -> hasClassProperty

Navigation

Navigation classes have been move to composer package kodicomponents\navigation for using in other projects.

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.2/authentication) and append middleware auth to config/sleeping_owl.php

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,
  ],
],

1. 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',
  ],
],

1. 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'],

Demo project

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

Documentation

• Russian
• English

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.