Download the PHP package codicastudio/dashboard without Composer

Nova Dashboard

The missing dashboard for Laravel Nova!

Installation

You can install the package via composer:

Recommended: Publish Configuration File for adjusting model and table names

php artisan vendor:publish --provider="DigitalCreative\NovaDashboard\ToolServiceProvider" --tag="config"

Publish Migrations

php artisan vendor:publish --provider="DigitalCreative\NovaDashboard\ToolServiceProvider" --tag="migration"

Run Migrations

php artisan migrate

Usage

Register the NovaDashboard tool within your NovaServiceProvider.php

To visualize the demo above you also will need to install these extra packages:

• digital-creative/value-widget
• digital-creative/nova-range-input-filter
• digital-creative/nova-pill-filter

Dashboard

Dashboard groups view, from this file you can customize some basic settings and define your views.

views()

Required an array of views.

options()

Views

There are 3 components that can be set within views (Widgets, Actions, Filters)

Example of a typical view class

When creating a instance of a view there are several methods you can call to:

authorizedToSee

As every other resource (dashboard, view, widget, filter, action) there is an authorizedToSee method which determines if the current logged in user can see / execute the respective resource.

editable

Enabling this in conjunction with Dynamic Widget mode will allow the widgets on the view to be editable,

you can also pass a callback to determine if the current logged in user has access to this functionality, for example:

private

By default, every view is Public this means that every logged user can see all the widgets in it (unless if fails on the authorizeToSee Check), however setting the view to private, every user will have their own set of widgets.

Combine this option with editable method to allow each user of your dashboard to freely be able to create widgets on their own without one seen stuff from each other.

Widgets

Widgets are the core functionality of this package and there are several ways for defining them:

Static mode

By passing 4 or 5 arguments to a widget it will be constructed in Static Mode, this means this widget cannot be modified dragged or resized from within the dashboard itself, use this mode if you don't want to allow the user to modify the default settings.

The arguments are:

Dynamic mode

Simply pass no arguments to it, a new button will appear on the dashboard which will allow you to create as many widgets as you want.

Note: While possible to mix Static and Dynamic Widgets the static ones gets shifted around due to the lack of a setting to lock an item on the grid, this will likely be fixed once the original author of the underlying grid library accepts the suggestion of developing such feature: https://github.com/bensladden/vue-responsive-dash/issues/196

List of current available widgets:

• ChartJS Widget: https://github.com/dcasia/chartjs-widget
• Value Widget: https://github.com/dcasia/value-widget
• Add your widget here.

Filters

These are standard nova filter classes with 1 simple difference, the method ->apply() does not get called by default. Why?

Usually your widget resolveValue() function will receive an instance of \DigitalCreative\NovaDashboard\Filters this class contains a method for retrieving the value of any given filter, for example:

However, if you want to reuse the logic that you have previously set on your filters or share existing filters with the dashboard you can call the method applyToQueryBuilder to get the same behavior:

applyToQueryBuilder will run every filter through the default filter logic of nova.

Actions

Every action needs to extend the class: DigitalCreative\NovaDashboard\Action which has only 1 required method ->execute()

The only difference between this action, and the default nova action are the method that will be called once executed, in fact if you define a ->handle() method this action can be used on every other nova resource as well.

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