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.

Used bower packages:

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

Installation

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

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

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

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

---

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.