Download the PHP package acacha/admin-lte-template-laravel without Composer
On this page you can find all versions of the php package acacha/admin-lte-template-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
More information about acacha/admin-lte-template-laravel
Files in acacha/admin-lte-template-laravel
Informations about the package admin-lte-template-laravel
AdminLTE template Laravel package
A Laravel package that switch default Laravel scaffolding / boilerplate to AdminLTE template with Bootstrap 3.0 and Pratt Landing Page
See demo here:
If you are looking for the Laravel 4 version, use 0.1.5 version/tag and see OLD-README.md
Finally publish files with:
This packages use (no need to install):
- AdminLTE. You can see and AdminLTE theme preview at: http://almsaeedstudio.com/preview/
- Pratt. Pratt Landing Page
- acacha/helpers : Extra helpers for Laravel provided by acacha.
- creativeorange/gravatar: Gravatar support for user's profile images. This could be optional through configuration.
- league/flysystem : Filesystem support.
- laravel/ui : Laravel authentication scaffolding.
- thephpleague/skeleton. This package use/has been adapted to use the phpleague skeleton.
- Acacha llum requires GNU sed. on MAC OS install GNU sed with:
This package assumes that you have in path your composer bin folder:
For example adding this line:
to your ~/.bashrc file
Note: in some systems the path coul be diferent for example:
Please be sure to check you environment.
- Laravel menu: only used with command adminlte:menu that replaces default adminlte menu with a menu with spatie/laravel-menu support.
Laravel 7 and older
- This package works smoothly with Laravel 7.x with 7.x version
- This package works smoothly with Laravel 6.x|5.x with 6.x version
This package installs Laravel routes that you will not find them at routes.php file. The routes installed by package would be find at file:
A file included by AdminLTETemplateServiceProvider:
You can override this routes by changing order of ServiceProviders in config/app.php file so if you put:
Your routes in routes.php file will override default adminlte-laravel routes.
Also you can install manually the routes in routes.php file. Adminlte-laravel use same routes as Laravel make:auth command use, see:
so you can add this lines to routes.php file:
And disable AdminLTETemplateServiceProvider in config/app.php file ( take into account that Adminte-laravel Facades and custom commands will not be available).
See issue https://github.com/acacha/adminlte-laravel/issues/69 for more info
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 access (database name, password, etc)
- Run migrations with command $ php artisan migrate
- Registera a first user and Login with it
AdminLTE is a Free Premium Admin control Panel Theme That Is Based On Bootstrap 3.x created by Abdullah Almsaeed. See:
This commands adds a view to resources/views folder using default adminlte layout:
This commands adds a menu entry to file config/menu.php:
This commands adds a route to routes file using:
For example you can add a route routes/web.php file with URI /about using:
This commands add this entry to routes/web.php
You can create 3 types of routes with option type:
- regular: routes using a clousure with a simple return view command. This is the default one
- controller: routes using a controller.
- resource: routes using a resource controller.
this adds the following:
to file routes/web.php. You can choose the controller name and method with:
If you want to create a resource controller:
this adds the following:
to file routes/web.php.
You can also create routes with other HTTP methods using option method:
You can also add routes to api using option api:
Then the routes will be added to routes/api.php.
Finally use option -a to add actions after route creation:
Last command also create a view with name about.blade.php. Using:
Will create a Controller file with name AboutController and method index.
You can consult all options with:
adminlte:publish | adminlte-laravel:publish
This command is already executed during installation you can (re)execute manually with:
Publish all necessary files from package to Laravel project.
adminlte:sidebar | adminlte-laravel:sidebar
Only publish package sidebar to Laravel project allowing to customize sidebar:
Note: sidebar is already published when you use adminlte-laravel install command.
adminlte:menu | adminlte-laravel:menu
Replaces sidebar view with a sidebar using spatie/laravel-menu:
This command also installs spatie/laravel-menu package and creates a default menu located config/menu.php.
IMPORTANT: Spatie Laravel Menu required PHP7.0 or superior to work
adminlte-laravel:admin | adminlte:admin
Executes make:adminUserSeeder artisan command (see next section) an executes seed. This command adds a default admin user to database.
This command use (if exists) environment variables (.env file) ADMIN_USER, ADMIN_EMAIL and ADMIN_PWD. If this env variables does not exists then user git config (~/.gitconfig) to obtain data and if this info does not exists use Admin ([email protected]) and password 123456 as default.
Create a new seed to add admin user to database. Use:
Social Login/Register with acacha/laravel-social
It's a cinch to add (optional) Social Login/Register support to Laravel Adminlte using acacha/laravel-social package. Execute in your project root folder:
Follow the wizard to configure your social providers Oauth data and enjoy!
More info at https://github.com/acacha/laravel-social.
How to remove social Login?
- Add email html templates
- Add breadcrumps with: https://github.com/davejamesmiller/laravel-breadcrumbs
- Gulp file provided to compile Boostrap and AdminLTE less files
- Partial views (html header, content header, footer, etc.) to easily reuse code
Testing this package
Use phpunit on run composer script test:
Testing laravel project once this package is installed
Once this package is installed in a Laravel project some tests are installed to test package features. There are two kind of tests Feature/Unit tests and Browser tests. To execute Feature/Unit tests execute:
In a new created laravel project with acacha-admintle.laravel installed to test that package is installed correctly. You can also execute Browser tests with Laravel Dusk (please install first manually Dusk package following https://laravel.com/docs/master/dusk):
You can also test this package in a sandbox without need to install. Run script:
All strings are localized using Laravel localization support: https://laravel.com/docs/master/localization
In your config/app.php file you can change locale to change language. You can install only localized files using tag adminlte_lang:
The following languages are supported by default on this package: English, Catalan, Spanish, Dutch and Brazilian Portuguese. Please feel free to submit a new pull request with another languages if you wish.
GNU sed on MAC OS
NOTA: not needed in Laravel 5.5+
Acacha llum need GNU sed to work so replace BSD sed with GNU sed using:
Check you version of sed with:
sed GNU version path is:
Instead of default path of BSD sed (installed by default on MAC OS):
More info at https://github.com/acacha/adminlte-laravel/issues/58
How to use username at login instead of email
And then you can use username instead of email for login.
NOTE: when we are using login by username if login by usernames fails then system try to use the introduced username as an email for login. So users can also login using email.
To come back to email login remove field option from config/auth.php file:
NOTE: Migration required to add username field to users table requires:
Default domain for username registration
Optionally you can define a default domain name for username login. Add domain option:
to file config/auth.php. Then if an user tries to login with no domain the default domain will be appended whe logging.
So with previous example you can type at login:
This script is located in partial blade file (vendor/acacha/admin-lte-template-laravel/resources/views/layouts/partials/htmlheader.blade.php)
Also in file resources/assets/js/bootstrap.js code section:
Allows using directly the trans function in vue templates:
Also you can use inside Vue components code:
Laravel Adminlte messages ara available using prefix adminlte_lang_message:
Feel free to remove/adapt this file to your needs.
Please see CHANGELOG for more information what has changed recently.
Please see CONDUCT for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
- Sergi Tur Badenas
- All Contributors
The MIT License (MIT). Please see License File for more information.