twocngdagz / adminlte-laravel

A Laravel 5 package that switchs default Laravel scaffolding/boilerplate to AdminLTE template and Pratt Landing Page with Bootstrap 3.0

#AdminLTE template Laravel 5 package A Laravel 5 package that switch default Laravel scaffolding / boilerplate to AdminLTE template with Bootstrap 3.0 and Pratt Landing Page

See demo here:

http://demo.adminlte.acacha.org/

If you are looking for the Laravel 4 version, use 0.1.5 version/tag and see OLD-README.md

#Requirements

• Composer
• Laravel
• AdminLTE. You can see and AdminLTE theme preview at: http://almsaeedstudio.com/preview/
• Pratt. Pratt Landing Page

Laravel 5.2

New version 2.0 supports Laravel 5.2 and now comes with an installer (Laravel/Spark way;-) ).

So easy to install!

Install globally with composer:

composer global require "acacha/adminlte-laravel-installer=~1.0"

And convert any Laravel fresh installation to AdminLTE/Pratt with:

laravel new laravel-with-admin-lte
cd laravel-with-admin-lte
adminlte-laravel install

Enjoy!

Laravel 5.2 manual installation

Follow the typical Laravel package installation steps:

 laravel new laravel-with-admin-lte
 cd laravel-with-admin-lte

Add admin-lte Laravel package with:

 composer require "acacha/admin-lte-template-laravel:2.*"

To register the Service Provider edit config/app.php file and add to providers array:

/*
* Acacha AdminLTE template provider
 */
Acacha\AdminLTETemplateLaravel\Providers\AdminLTETemplateServiceProvider::class,

To Register Alias edit config/app.php file and add to alias array:

/*
* Acacha AdminLTE template alias
*/
'AdminLTE' => Acacha\AdminLTETemplateLaravel\Facades\AdminLTE::class,

Publish files with:

php artisan vendor:publish --tag=adminlte --force

Use force to overwrite Laravel Scaffolding packages. That's all! Open the Laravel project in your browser or homestead machine and enjoy!

Laravel 5.1 notes

By default Laravel 5.1 does not include default auth routes. Versions > 1.0 < 2.0 of this package add the necessary routes for you

See old README file file for notes of which routes are registered.

###Installation

First install Laravel (http://laravel.com/docs/5.0/installation) and then Create a new Laravel project:

 laravel new laravel-with-admin-lte
 cd laravel-with-admin-lte

Add admin-lte Laravel package with:

 composer require "acacha/admin-lte-template-laravel:1.*"

Register ServiceProvider editing config/app.php file and adding to providers array:

// AdminLTE template provider         
Acacha\AdminLTETemplateLaravel\app\Providers\AdminLTETemplateServiceProvider::class,

Publish files with:

 php artisan vendor:publish --force --provider="Acacha\AdminLTETemplateLaravel\app\Providers\AdminLTETemplateServiceProvider"

Use force to overwrite Laravel Scaffolding packages. That's all! Open the Laravel project in your browser or homestead machine and enjoy!

Note: use the following for Laravel <5.1 versions:

 // AdminLTE template provider
 'Acacha\AdminLTETemplateLaravel\app\Providers\AdminLTETemplateServiceProvider',

##Laravel Routes

This package add Laravel routes that you will not find them at routes.php file. The routes installed by package would be find at file:

https://github.com/acacha/adminlte-laravel/blob/master/src/Http/routes.php

File included by AdminLTETemplateServiceProvider:

https://github.com/acacha/adminlte-laravel/blob/master/src/Providers/AdminLTETemplateServiceProvider.php

See issue mdbootstrap#47 if you want to change default welcome/landing page route.

##First steps, database creation, migrations and login

Once package installed you have to follow the usual steps of any laravel project to Login to the admin interface:

• Create a database. I recommend the use of laravel Homestead ()
• Create/check .env file and configure database acces (database name, password, etc)
• Run migrations with command $ php artisan migrate
• Registera a first user and Login with it

##AdminLTE

AdminLTE is a Free Premium Admin control Panel Theme That Is Based On Bootstrap 3.x created by Abdullah Almsaeed. See:

https://github.com/almasaeed2010/AdminLTE

Roadmap

• Implement Facebook, Google and maybe twitter and github Login with Socialite
• Add email html templates

Documentation TODO

• Gulp file provided to compile Boostrap and AdminLTE less files
• Partial views (html header, content header, footer, etc.) to easily reuse code
• Add breadcrumps with: https://github.com/davejamesmiller/laravel-breadcrumbs

Packagist

https://packagist.org/packages/acacha/admin-lte-template-laravel

More info

http://acacha.org/mediawiki/AdminLTE#adminlte-laravel

Tests

Execute:

phpunit

In new created laravel project with acacha-admintle.laravel installed to test package is installed correctly.

Social Login

FAQ:

How can I remove social login links in register and login pages?

Remove line @include('auth.partials.social_login') in files resources/views/auth/login.blade.php and register.blade.php

Social login links in login/register pages returns 404 not found

TODO: See package https://github.com/acacha/acacha-socialite

See also

https://github.com/acacha/adminlte-laravel-installer