Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/atnic/laravel-admin-lte

Easy AdminLTE integration with Laravel and laravel mix friendly.
https://github.com/atnic/laravel-admin-lte

admin-lte adminlte composer laravel laravel-5-package

Last synced: 16 days ago
JSON representation

Easy AdminLTE integration with Laravel and laravel mix friendly.

Awesome Lists containing this project

README

        

# Laravel AdminLTE

[![Latest Stable Version](https://poser.pugx.org/atnic/laravel-admin-lte/v/stable)](https://packagist.org/packages/atnic/laravel-admin-lte)
[![Total Downloads](https://poser.pugx.org/atnic/laravel-admin-lte/downloads)](https://packagist.org/packages/atnic/laravel-admin-lte)
[![Latest Unstable Version](https://poser.pugx.org/atnic/laravel-admin-lte/v/unstable)](https://packagist.org/packages/atnic/laravel-admin-lte)
[![License](https://poser.pugx.org/atnic/laravel-admin-lte/license)](https://packagist.org/packages/atnic/laravel-admin-lte)
[![Monthly Downloads](https://poser.pugx.org/atnic/laravel-admin-lte/d/monthly)](https://packagist.org/packages/atnic/laravel-admin-lte)
[![Daily Downloads](https://poser.pugx.org/atnic/laravel-admin-lte/d/daily)](https://packagist.org/packages/atnic/laravel-admin-lte)

Laravel Package for integrating [AdminLTE](https://adminlte.io/) template and this package is Laravel Mix friendly. Currently this package can be integrated easily only on fresh installation.

For translation in Bahasa Indonesia 🇮🇩, [please follow this link](translations/README.id.md)

# Installation
```bash
composer require atnic/laravel-admin-lte
```
If you are using Laravel 5.5 above skip this step, but if aren't then add this line on ```config/app.php```, on ```providers```
```php
'providers' => [
...
Atnic\AdminLTE\Providers\AppServiceProvider::class,
...
]
```
And then run,
```bash
php artisan make:admin-lte
```
Let's see what we've install. First, make sure that you already ran ```php artisan migrate``` command, then do
```bash
php artisan serve
```
Viola! You've running a Laravel site using AdminLTE.

For more information on command
```bash
php artisan make:admin-lte --help
```

# Usage
This package provides view for auth and app. Take a look at ```resources/views/layouts/app.blade.php```.

In this file you can extends global section like user name, avatar, breadcrumbs, and menu.

To extends menu add this in ```app.blade.php```
```blade
@section('sidebar-menu')


@endsection
```

To extends breadcrumbs add this
```blade
@section('breadcrumbs')


@endsection
```

This package give you free of choice to use any Laravel Package for Menu and Breadcrumb. We recommend [spatie/laravel-menu](https://github.com/spatie/laravel-menu) or [lavary/laravel-menu](https://github.com/lavary/laravel-menu), and [davejamesmiller/laravel-breadcrumbs](https://github.com/davejamesmiller/laravel-breadcrumbs).

Any new created page should extends this view.
```blade
@extends('layouts.app')

// Your blade here
```

# Configuration and Views Customization
## Config
To publish this package config to your app config run
```bash
php artisan vendor:publish --provider="Atnic\AdminLTE\Providers\AppServiceProvider" --tag="config"
```
## Views
To publish this package views so you can customize on your own run
```bash
php artisan vendor:publish --provider="Atnic\AdminLTE\Providers\AppServiceProvider" --tag="views"
```

# Next Step
First of all, you should understand how to use [Laravel Mix](https://laravel.com/docs/5.4/mix).

Make sure `package.json` has `"laravel-mix": "^2.0"`.

AdminLTE need some package on npm. First you need to run
```bash
npm install
```

Install AdminLTE needed package from npm
```bash
npm install --save-dev admin-lte@^2.4 bootstrap-sass fastclick font-awesome icheck ionicons jquery jquery-slimscroll
```

Run Laravel Mix command
```bash
npm run development
```
or use ```production``` minimize output
```bash
npm run production
```

Then have a good look on these files
- ```webpack.mix.js```
- ```resources/assets/js/admin-lte.js```
- ```resources/assets/js/auth.js```
- ```resources/assets/sass/admin-lte.scss```
- ```resources/assets/sass/auth.scss```

Happy experimenting!