shawnsandy/dash

Dashboard for admin

Dash (beta)

![Software License][ico-license] ![Coverage Status][ico-scrutinizer] ![Total Downloads][ico-downloads], _(*1)

Dash is a Laravel package that makes Admin / UI development easier. Warning it will not do all of your crud work, code is required. Enjoy! (Preview Release). Read the full docs here., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require shawnsandy/dash, <sub>(*4)</sub>

__Add to the config/app.php providers array__ 

``` php

ShawnSandy\Dash\DashServicesProvider::class,

// dependencies
Collective\Html\HtmlServiceProvider::class,

Add to config/app.php aliases array, <sub>(*5)</sub>

"Dash" => ShawnSandy\Dash\DashFacade::class,
"DashForms" => ShawnSandy\Dash\Builder\GenerateFormFieldsFacade::class,

// dependencies

'Form' => Collective\Html\FormFacade::class,
'Html' => Collective\Html\HtmlFacade::class,

Dash Routes, <sub>(*6)</sub>

You can add dash route to your routes\wep.php which give you access to dashboard, content, media, pages, system, users, settings via /admin., <sub>(*7)</sub>

Route::group(['prefix' => 'admin'], function(){
   Dash::routes();
});

Usage

Dash Components, <sub>(*8)</sub>

Icons based on font awesome, <sub>(*9)</sub>

``` blade, <sub>(*10)</sub>

{{ Html::dashIcons() }} {{ Html::dashIcons("users") }} //icon name, <sub>(*11)</sub>

*Data Table*

``` blade
{{ Html::dataTable($users, // users data
    ["id", "name", "email", "created_at"], // columns (title)
    ['page_length' => 15, 'order' => "desc", "edit_url" => '/admin/users/'], // options
    ['class' => 'data-table'] // element attributes
    )
}}

*Forms, <sub>(*12)</sub>

``` blade, <sub>(*13)</sub>

{{ Form::createForm('App\User', "admin/users") }}, <sub>(*14)</sub>

__Slot based components (Laravel 5.4^)__
-------------------------------------------------------

* **Info Panel**

``` blade

@component("dash::components.panels.info", ["title" => "Users", "icon" => "circle-o"])


{{ count($users) }} Registered Users


@endcomponent

• Widget

``` php, <sub>(*15)</sub>

@component("dash::components.panels.widget", ["title" => "Add New User(s)"]), <sub>(*16)</sub>

    {{ config(["dash.forms.users.field_types.password" => "text"]) }}

    {{ Form::createForm('App\User', "admin/users") }}

@endcomponent, <sub>(*17)</sub>

[Read the full docs here](/docs).

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

## Testing

``` bash
$ composer test

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*18)</sub>

Security

If you discover any security related issues, please email shawnsandy04@gmail.com instead of using the issue tracker., <sub>(*19)</sub>

Credits

• Shawn Sandy
• [All Contributors][link-contributors]

License

The MIT License (MIT). Please see License File for more information., <sub>(*20)</sub>