/dashboard

Primary LanguageCSSMIT LicenseMIT

Dashboard for CakePHP

Build beautiful dashboards for your cakes!

This is an unstable repository and should be treated as an alpha.

sample

Requirements

  • CakePHP 3.0.0 or greater.
  • PHP 5.4.16 or greater
  • SQLite or another database driver that CakePHP can talk to (defaults to SQLite).

Install

composer require gourmet/dashboard:*

or by adding this package to your project's composer.json:

"require": {
	"gourmet/dashboard": "*"
}

Now, enable the plugin in your bootstrap.php (including bootstrap and routes):

Plugin::load('Gourmet/Dashboard', ['bootstrap' => true, 'routes' => true]);

You will also need to symlink the assets:

From To
plugins/Gourmet/Dashboard/webroot/assets/dashboard.css webroot/assets/dashboard.css
plugins/Gourmet/Dashboard/webroot/assets/dashboard.js webroot/assets/dashboard.js
plugins/Gourmet/Dashboard/webroot/font webroot/font/dashboard

To preview the sample dashboard, you will need to also copy some sample widgets to your app:

From To
plugins/Gourmet/Dashboard/samples src/DashboardWidget

That's it! You can now access the sample dashboard at: http://localhost/gourmet/dashboard/index

Documentation

Database Configuration

By default, Dashboard will store event data into a SQLite database in your application's tmp directory. If you cannot install pdo_sqlite, you can configure Dashboard to use a different database by defining a gourmet_dashboard connecting in your config/app.php file.

Widgets

Built-in Widgets

There are several built-in widgets, they are:

  • Clock
  • Comments
  • Graph
  • Iframe
  • Image
  • List
  • Meter
  • Number
  • Text

Configuration

There is no configuration at this time. Options will be coming soon.

Developing Your Own Widgets

You can create your own custom widgets for Gourmet/Dashboard. Until this is better documented, please refer to the sample widgets included.

Credits