Download the PHP package dantecoding/laravel-adminlte without Composer
On this page you can find all versions of the php package dantecoding/laravel-adminlte. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dantecoding/laravel-adminlte
More information about dantecoding/laravel-adminlte
Files in dantecoding/laravel-adminlte
Package laravel-adminlte
Short Description Easy AdminLTE integration with Laravel
License MIT
Informations about the package laravel-adminlte
Easy AdminLTE integration with Laravel 5
This package provides an easy way to quickly set up AdminLTE with Laravel 5. It has no requirements and dependencies besides Laravel, so you can start building your admin panel immediately. The package just provides a Blade template that you can extend and advanced menu configuration possibilities. A replacement for the make:auth
Artisan command that uses AdminLTE styled views instead of the default Laravel ones is also included.
- Installation
- Updating
- Usage
- The
make:adminlte
artisan command- Using the authentication views without the
make:adminlte
command
- Using the authentication views without the
- Configuration
- Menu
- Custom menu filters
- Menu configuration at runtime
- Active menu items
- Plugins
- Menu
- Translations
- Customize views
- Issues, Questions and Pull Requests
1. Installation
-
Require the package using composer:
-
Add the service provider to the
providers
inconfig/app.php
:Laravel 5.5 uses Package Auto-Discovery, so doesn't require you to manually add the ServiceProvider
- Publish the public assets:
2. Updating
-
To update this package, first update the composer package:
- Then, publish the public assets with the
--force
flag to overwrite existing files
3. Usage
To use the template, create a blade file and extend the layout with @extends('adminlte::page')
.
This template yields the following sections:
title
: for in the<title>
tagcontent_header
: title of the page, above the contentcontent
: all of the page's contentcss
: extra stylesheets (located in<head>
)js
: extra javascript (just before</body>
)
All sections are in fact optional. Your blade template could look like the following.
Note that in Laravel 5.2 or higher you can also use @stack
directive for css
and javascript
:
You now just return this view from your controller, as usual. Check out AdminLTE to find out how to build beautiful content for your admin panel.
4. The make:adminlte
artisan command
Note: only for Laravel 5.2 and higher
This package ships with a make:adminlte
command that behaves exactly like make:auth
(introduced in Laravel 5.2) but replaces the authentication views with AdminLTE style views.
This command should be used on fresh applications, just like the make:auth
command
4.1 Using the authentication views without the make:adminlte
command
If you want to use the included authentication related views manually, you can create the following files and only add one line to each file:
-
resources/views/auth/login.blade.php
: -
resources/views/auth/register.blade.php
-
resources/views/auth/passwords/email.blade.php
resources/views/auth/passwords/reset.blade.php
By default, the login form contains a link to the registration form.
If you don't want a registration form, set the register_url
setting to null
and the link will not be displayed.
5. Configuration
First, publish the configuration file:
Now, edit config/adminlte.php
to configure the title, skin, menu, URLs etc. All configuration options are explained in the comments. However, I want to shed some light on the menu
configuration.
5.1 Menu
You can configure your menu as follows:
With a single string, you specify a menu header item to separate the items.
With an array, you specify a menu item. text
and url
or route
are required attributes.
The icon
is optional, you get an open circle if you leave it out.
The available icons that you can use are those from Font Awesome.
Just specify the name of the icon and it will appear in front of your menu item.
Use the can
option if you want conditionally show the menu item. This integrates with Laravel's Gate
functionality. If you need to conditionally show headers as well, you need to wrap it in an array like other menu items, using the header
option:
Custom Menu Filters
If you need custom filters, you can easily add your own menu filters to this package. This can be useful when you are using a third-party package for authorization (instead of Laravel's Gate
functionality).
For example with Laratrust:
And then add to config/adminlte.php
:
Menu configuration at runtime
It is also possible to configure the menu at runtime, e.g. in the boot of any service provider. Use this if your menu is not static, for example when it depends on your database or the locale. It is also possible to combine both approaches. The menus will simply be concatenated and the order of service providers determines the order in the menu.
To configure the menu at runtime, register a handler or callback for the MenuBuilding
event, for example in the boot()
method of a service provider:
The configuration options are the same as in the static configuration files.
A more practical example that actually uses translations and the database:
This event-based approach is used to make sure that your code that builds the menu runs only when the admin panel is actually displayed and not on every request.
Active menu items
By default, a menu item is considered active if any of the following holds:
- The current path matches the
url
parameter - The current path is a sub-path of the
url
parameter - If it has a submenu containing an active menu item
To override this behavior, you can specify an active
parameter with an array of active URLs, asterisks and regular expressions are supported. Example:
5.2 Plugins
By default the DataTables plugin is supported. If set to true
, the necessary javascript CDN script tags will automatically be injected into the adminlte::page.blade
file.
6. Translations
At the moment, English, German, French, Dutch, Portuguese and Spanish translations are available out of the box.
Just specifiy the language in config/app.php
.
If you need to modify the texts or add other languages, you can publish the language files:
Now, you can edit translations or add languages in resources/lang/vendor/adminlte
.
7. Customize views
If you need full control over the provided views, you can publish them:
Now, you can edit the views in resources/views/vendor/adminlte
.
8. Issues, Questions and Pull Requests
You can report issues and ask questions in the issues section. Please start your issue with ISSUE:
and your question with QUESTION:
If you have a question, check the closed issues first. Over time, I've been able to answer quite a few.
To submit a Pull Request, please fork this repository, create a new branch and commit your new/updated code in there. Then open a Pull Request from your new branch. Refer to this guide for more info.