laravel-template/lt-adminlte

AdminLTE Laravel Integration


Keywords
laravel-template, lt-adminlte
License
MIT

Documentation

LT-AdminLTE

Latest Version on Packagist Build Status Quality Score Total Downloads

Welcome to the lt-adminlte!

This package provide an easy way to implement AdminLTE template on your Laravel Application.

Main Layout

More templates integrations will be added later in laravel-template.

Installation

You can install the package via composer:

composer require laravel-template/lt-adminlte

Config file can be published using the command bellow

php artisan vendor:publish --tag lt-adminlte:config

In order to customize views, publish the first using,

php artisan vendor:publish --tag lt-adminlte:views

The same for lang files,

php artisan vendor:publish --tag lt-adminlte:views

Usage

Basic

This package use Blade Component to simplify the implementation of the feature in your application.

Just add the tag below depending on your desired layouts main:

<x-lte-main title="Your App Name" pageTitle="the active page title">Page Content</x-lte-main>

and more attribute may be added like:

  • logo: your logo link

  • indexUrl: your home page link triggered when clicking on your logo

  • navbarLinks: displays list of menus on the top left of the navbar the links must be in this format

[
    [
        'name' => 'Home',
        'link' => '/home'
    ],
    ...
]
  • breadcrumb: breadcrumb also has the same format
[
    [
        'name' => 'Home',
        'link' => '/home'
    ],
    ...
]

Sidebar Navigation

To update the sidebar menu, make you sure you already published the views, then go to resources/views/vendor/lt-adminlte/components/layouts/sidebar.blade.php

then add navigation links under <!-- Add navigation links here--> comment

<x-lte-sidebar-link title="Title" :route="['routeName']"/>

<x-lte-sidebar-link title="Parent" :route="['parentRoute']">
    <x-lte-sidebar-link title="Child" :route="['parentRoute.childRoute']" />
</x-lte-sidebar-link>

Other attributes are disponible:

  • badges: displayed on the left of menu to that contain a value and a type like
[
    [
        'type' => 'success', //types are: success, info, primary, warning, secondary, danger
        'value' => '10'
    ],
    ...
]
  • icon: use FontAwesome v5.13 library, displayed in the left of the menu if the menu is not parent, default value is far fa-circle

  • rightIcon: same a the normal icon the difference is this one is displayed on the right of the menu before the badges and if the menu is not parent

  • url: for external links to use it make sure that the route attribute is not provided

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

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

Credits

License

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

Laravel Package Boilerplate

This package was generated using the Laravel Package Boilerplate.