Skip to content

iterq1/django-controlcenter

 
 

Repository files navigation

Welcome to django-controlcenter!

Get all your project models on one single page with charts and whistles.

django-controlcenter

Rationale

Django-admin is a great tool to control your project activity: new orders, comments, replies, users, feedback -- everything is here. The only struggle is to switch between all that pages constantly just to check them out for new entries.

With django-controlcenter you can have all your models on one single page and build beautiful charts with Chartist.js. Actually they don't even have to be a django model, get your data from wherever you want: RDBMS, NOSQL, text file or even from an external web-page, it doesn't matter.

Quickstart

Install django-controlcenter:

pip install -U django-controlcenter

Create a dashboard file with up to 10 dashboards and unlimited number of widgets:

from controlcenter import Dashboard, widgets
from project.app.models import Model

class ModelItemList(widgets.ItemList):
    model = Model
    list_display = ('pk', 'field')

class MyDashboard(Dashboard):
    widgets = (
        ModelItemList,
    )

Update settings file:

INSTALLED_APPS = [
    ...
    'controlcenter',
    ...
]

CONTROLCENTER_DASHBOARDS = (
    'project.dashboards.MyDashboard',
)

Plug in urls:

from django.conf.urls import url
from django.contrib import admin
from controlcenter.views import controlcenter

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^admin/dashboard/', controlcenter.urls),
    ...
]

Open /admin/dashboard/0/ in browser.

Documentation

Check out docs for more complete examples.

Compatability

Build Status

Codecov

Tested on py 2.7, 3.4, 3.5 with django 1.8, 1.9.

Credits

This project uses Chartist.js, Masonry.js and Sortable.js.

About

Set of widgets to build dashboards for Django projects.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 55.6%
  • CSS 35.1%
  • HTML 7.0%
  • JavaScript 2.3%