Download the PHP package sandulat/laravel-dashboard-template without Composer
On this page you can find all versions of the php package sandulat/laravel-dashboard-template. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sandulat/laravel-dashboard-template
More information about sandulat/laravel-dashboard-template
Files in sandulat/laravel-dashboard-template
Package laravel-dashboard-template
Short Description Basic Laravel Dashboard Template
License MIT
Homepage https://github.com/sandulat/laravel-dashboard-template
Informations about the package laravel-dashboard-template
Laravel Dashboard Template
💫Basic Dashboard Template as a Package.💫
> Note: Not suitable for single page applications as it's built in `Blade`, however you can use Vue/React/etc. components on all pages.
## Installation
> Note: to re-publish the front-end assets when updating the package use: `php artisan laravel-dashboard-template:publish`
The `install` command will publish the front-end assets and will create a new service provider `App\Providers\DashboardServiceProvider`. This is basically the main config of the template, but first let's see how to display the dashboard in the next section.
## Layout
Create a route and a controller that will return a view. Inside the view place the following code:
`my_view.blade.php:`
> Note: `ldt` stands for `laravel-dashboard-template`.
As you can see `laravel-dashboard-template::page` is just a layout. Besides `ldt-content` the layout provides more additional slots:
- `ldt-head` - Head section for CSS, meta, etc.
- `ldt-scripts` - Scripts section to include JS files.
- `ldt-topbar-left` - Left section of topbar.
- `ldt-topbar-right` - Right section of topbar, next to profile dropdown.
- `ldt-sidebar-footer` - Footer section of sidebar.
To avoid duplication of these slots, it would be better to create your own layout that will extend the package's layout.
`my_layout.blade.php:`
So now in your views you can do:
`my_view.blade.php:`
## Card
Besides layout, the package provides a card component:
The result can be seen in the screenshot at the top of the documentation.
## Alerts
Out of the box the package will display 2 types of alerts above the `content` section of the layout. They will be displayed when you redirect with `success` and `error` flash data:
## Configuration
You can configure the dashboard inside the installed provider: `App\Providers\DashboardServiceProvider`. By default it's empty because everything is already configured so you can start building instantly, however you can add the following methods to start customizing the dashboard:
> Note: Each method from this service provider has dependency injection available.
## Customization
I've tried to split the template into as many components & partials as possible. Just create inside your project the folder: `resources/views/vendor/laravel-dashboard-template` and now you can copy the files from the package and customize them. Here is the list:
- partials/alert.blade.php
- partials/alert_error.blade.php
- partials/alert_success.blade.php
- partials/sidebar.blade.php
- partials/sidebar_link.blade.php
- partials/sidebar_logo.blade.php
- partials/topbar_profile_dropdown.blade.php
---
- components/card.blade.php
- components/dropdown.blade.php
- components/dropdown_item.blade.php
- components/topbar.blade.php
## Using Vue/React/etc. components
The main div that wraps the dashboard has an `app` id. You can load your front-end framework onto this id and start using your components on all pages.
After you'll compile your front-end assets you can include them like this:
> Note: If you don't have [front-end assets versioning](https://laravel.com/docs/5.8/mix#versioning-and-cache-busting) you might want to use the `asset()` method instead of `mix()`.
## Custom Logout Button
You can hide the default logout button by applying `display: none;` onto id `#ldt-logout-button`. The template already provides a logout system with customizable callbacks, so you can make use of it. Just submit the default "hidden" logout form with Javascript:
## Credits
Created by [Stratulat Alexandru](https://twitter.com/sandulat).