Repository files navigation

A Laravel 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 seeOLD-README.md

composer require"acacha/admin-lte-template-laravel"

Finally publish files with:

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

This packages use (no need to install):

• Composer
• Laravel
• 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:

brew install gnu-sed --with-default-names

This package assumes that you have in path your composer bin folder:

/YOUR_PATH_TO_HOME/.composer/vendor/bin

For example adding this line:

export PATH=${PATH}:~/.composer/vendor/bin

to your ~/.bashrc file

Note: in some systems the path coul be diferent for example:

export PATH=${PATH}:~/.config/composer/vendor/bin

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.

• 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:

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

A file included by AdminLTETemplateServiceProvider:

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

You can override this routes by changing order of ServiceProviders in config/app.php file so if you put:

App\Providers\RouteServiceProvider::class

After

Acacha\AdminLTETemplateLaravel\Providers\AdminLTETemplateServiceProvider::class

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:

https://github.com/laravel/framework/blob/5.2/src/Illuminate/Auth/Console/stubs/make/routes.stub

so you can add this lines to routes.php file:

Route::auth();Route::get('/home','HomeController@index');

And disable AdminLTETemplateServiceProvider in config/app.php file ( take into account that Adminte-laravel Facades andcustom commands will not be available).

See issue#69 for more info

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:

https://github.com/almasaeed2010/AdminLTE

Adminlte-laravel supports global recognized avatar (http://gravatar.com) using package creativeorange/gravatar (https://github.com/creativeorange/gravatar).

This commands adds a view toresources/views folder using default adminlte layout:

php artisan make:view about

This commands adds a menu entry to fileconfig/menu.php:

php artisan make:menu link menuname

Example:

php artisan make:menu /contact

This commands adds a route to routes file using:

php artisan make:route linkname

For example you can add a routeroutes/web.php file with URI/about using:

php artisan make:route about

This commands add this entry to routes/web.php

You can create 3 types of routes with optiontype:

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

Examples:

php artisan make:route about --type=controller

this adds the following:

Route::get('about','AboutController@index');

to fileroutes/web.php. You can choose the controller name and method with:

php artisan make:route about MyController@method --type=controller

If you want to create a resource controller:

php artisan make:route about --type=resource

this adds the following:

Route::resource('about','About@index');

to fileroutes/web.php.

You can also create routes with other HTTP methods using optionmethod:

php artisan make:route save --method=post

You can also add routes to api using optionapi:

php artisan make:route save --api

Then the routes will be added toroutes/api.php.

Finally use option-a to add actions after route creation:

php artisan make:route about -a

Last command also create a view with nameabout.blade.php. Using:

php artisan make:route about -a --type=controller

Will create a Controller file with nameAboutController and method index.

You can consult all options with:

php artisan make:route --help

This command is already executed during installation you can (re)execute manually with:

php artisan adminlte:publish

Publish all necessary files from package to Laravel project.

Only publish package sidebar to Laravel project allowing to customize sidebar:

php artisan adminlte:sidebar

Note: sidebar is already published when you useadminlte-laravel install command.

Replaces sidebar view with a sidebar usingspatie/laravel-menu:

php artisan adminlte:menu

This command also installs spatie/laravel-menu package and creates a default menu locatedconfig/menu.php.

IMPORTANT: Spatie Laravel Menu required PHP7.0 or superior to work

Executes make:adminUserSeeder artisan command (see next section) an executes seed. This command adds a default admin user to database.

php artisan adminlte:adminFile /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php createdUser Sergi Tur Badenas(sergiturbadenas@gmail.com) with the environemnt password (env var ADMIN_PWD) created succesfully!

This command use (if exists) environment variables (.env file) ADMIN_USER, ADMIN_EMAIL and ADMIN_PWD. If this env variables does not exists thenuser git config (~/.gitconfig) to obtain data and if this info does not exists use Admin (admin@example.com) and password 123456 as default.

Create a new seed to add admin user to database. Use:

php artisan make:adminUserSeederFile /home/sergi/Code/AdminLTE/acacha/adminlte-laravel_test/database/seeds/AdminUserSeeder.php created

It's a cinch to add (optional) Social Login/Register support to Laravel Adminlte usingacacha/laravel-social package. Execute in your project root folder:

adminlte-laravel social

Follow the wizard to configure your social providers Oauth data and enjoy!

More info athttps://github.com/acacha/laravel-social.

Remove line

@include('auth.partials.social_login')

in filesresources/views/auth/login.blade.php andregister.blade.php

• 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

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

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

Use phpunit on run composer script test:

$ composertest

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:

./vendor/bin/phpunit

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 followinghttps://laravel.com/docs/master/dusk):

php artisan dusk:installtouch database/testing.database.sqlitephp artisan serve --env=dusk.local &php artisan dusk

You can also test this package in a sandbox without need to install. Run script:

./test.sh

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:

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

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.

NOTA: not needed in Laravel 5.5+

Acacha llum need GNU sed to work so replace BSD sed with GNU sed using:

brew install gnu-sed --with-default-names

Check you version of sed with:

man sed

sed GNU version path is:

$ which sed/usr/local/bin/sed

Instead of default path of BSD sed (installed by default on MAC OS):

/usr/bin/sed

More info at#58

Execute command:

php artisan adminlte:username

And then you can use username instead of email for login.

NOTE: when we are using login by username if login by usernames fails thensystem try to use the introduced username as an email for login. So userscan also login using email.

To come back to email login removefield option fromconfig/auth.php file:

'providers' => ['users'=> ['driver'=>'eloquent','model'=> App\User::class,'field'=>'username' // Adminlte laravel. Valid values:'email' or'username'    ],

NOTE: Migration required to add username field to users table requires:

composer require doctrine/dbal

Optionally you can define a default domain name for username login. Add domain option:

'defaults' => ['guard' =>'web','passwords' =>'users','domain' =>'defaultdomain.com',],

to fileconfig/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:

sergiturbadenas

and system/javascript will replace that with:

sergiturbadenas@defaultdomain.com

Laravel adminlte package by default publish Laravel translations into Javascript/Vue.js adding to HTML header the following script:

<script>    //See https://laracasts.com/discuss/channels/vue/use-trans-in-vuejs    window.trans = @php        // copy all translations from /resources/lang/CURRENT_LOCALE/* to global JS variable        $lang_files = File::files(resource_path() . '/lang/' . App::getLocale());        $trans = [];        foreach ($lang_files as $f){$filename=pathinfo($f)['filename'];$trans[$filename]=trans($filename);}        $trans['adminlte_lang_message'] = trans('adminlte_lang::message');        echo json_encode($trans);    @endphp</script>

This script is located in partial blade file (vendor/acacha/admin-lte-template-laravel/resources/views/layouts/partials/htmlheader.blade.php)

So global variable window.trans contains all Laravel translations at can be used in any Javascript file.

Also in fileresources/assets/js/bootstrap.js code section:

Vue.prototype.trans = (key) => {    return _.get(window.trans, key, key);};

Allows using directly the trans function in vue templates:

{{ trans('auth.failed') }}

Also you can use inside Vue components code:

this.trans('auth.failed')

Laravel Adminlte messages ara available using prefixadminlte_lang_message:

{{ trans('adminlte_lang_message.username') }}

Feel free to remove/adapt this file to your needs.

Please seeCHANGELOG for more information what has changed recently.

Please seeCONTRIBUTING andCONDUCT for details.

If you discover any security related issues, please emailsergiturbadenas@gmail.com instead of using the issue tracker.

• Sergi Tur Badenas
• All Contributors

The MIT License (MIT). Please seeLicense File for more information.

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