• Stars
    star
    284
  • Rank 142,176 (Top 3 %)
  • Language
    Python
  • License
    Other
  • Created almost 13 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Django-admin-tools-stats is a Django admin module that allow you to create easily charts on your dashboard based on specific models and criterias

NOTE: This project was rewritten to be more flexible and to work with common Django admin and released as django-admin-charts. The django-admin-charts project is backward-compatible with django-admin-tools-stats, so you can migrate to that. All development and maintanence continues on django-admin-charts repository.

Django-admin-tools-stats

Description:Django-admin module to create charts and stats in your dashboard
Documentation:http://django-admin-tools-stats.readthedocs.org/en/latest/
https://travis-ci.org/areski/django-admin-tools-stats.svg?branch=master Latest Version Downloads Supported Python versions License

Django-admin-tools-stats is a Django admin module that allow you to create easily charts on your dashboard based on specific models and criterias.

It will query your models and provide reporting and statistics graphs, simple to read and display on your Dashboard.

https://github.com/areski/django-admin-tools-stats/raw/master/docs/source/_static/admin_dashboard.png

Installation

Install, upgrade and uninstall django-admin-tools-stats with these commands:

$ pip install django-admin-tools-stats

Dependencies

django-admin-tools-stats is a django based application, the major requirements are :

  • python-dateutil
  • django-jsonfield
  • django-qsstats-magic
  • django-cache-utils
  • django-admin-tools
  • django-nvd3
  • django-bower

Configure

  • Configure admin_tools

  • Configure django-bower

    • Add django-bower to INSTALLED_APPS in settings.py:

      INSTALLED_APPS = (
          ...
          'djangobower'
      )
      
    • Add the following properties to you settings.py file:

      # Specifie path to components root (you need to use absolute path)
      BOWER_COMPONENTS_ROOT = os.path.join(PROJECT_ROOT, 'components')
      
      
      BOWER_INSTALLED_APPS = (
          'jquery#3.4.1',
          'jquery-ui#1.12.1',
          'd3#3.3.13',
          'nvd3#1.7.1',
      )
      
    • Add django-bower finder to your static file finders:

      STATICFILES_FINDERS = (
          ...
          'djangobower.finders.BowerFinder',
      )
      
    • Run the following commands. These will download nvd3.js and its dependencies using bower and throw them in to you static folder for access by your application:

      $ python manage.py bower_install
      $ python manage.py collectstatic
      
  • Add admin_tools_stats & django_nvd3 into INSTALLED_APPS in settings.py:

    INSTALLED_APPS = (
        ...
        'admin_tools_stats',
        'django_nvd3',
    )
    
  • Add following code to dashboard.py:

    from admin_tools_stats.modules import DashboardCharts, get_active_graph
    
    # append an app list module
    self.children.append(modules.AppList(
        _('Dashboard Stats Settings'),
        models=('admin_tools_stats.*', ),
    ))
    
    # Copy following code into your custom dashboard
    # append following code after recent actions module or
    # a link list module for "quick links"
    graph_list = get_active_graph()
    for i in graph_list:
        kwargs = {}
        kwargs['require_chart_jscss'] = True
        kwargs['graph_key'] = i.graph_key
    
        for key in context['request'].POST:
            if key.startswith('select_box_'):
                kwargs[key] = context['request'].POST[key]
    
        self.children.append(DashboardCharts(**kwargs))
    
  • To create the tables needed by Django-admin-tools-stats, run the following command:

    $ python manage.py syncdb
    
  • You may also need to add some includes to your template admin base, see an example on the demo project:

    demoproject/demoproject/templates/admin/base_site.html

  • Open admin panel, configure Dashboard Stats Criteria & Dashboard Stats respectively

Contributing

If you've found a bug, add a feature or improve django-admin-tools-stats and think it is useful then please consider contributing. Patches, pull requests or just suggestions are always welcome!

Source code: http://github.com/areski/django-admin-tools-stats

Bug tracker: https://github.com/areski/django-admin-tools-stats/issues

Documentation

Documentation is available on 'Read the Docs': http://readthedocs.org/docs/django-admin-tools-stats/

License

Copyright (c) 2011-2017 Star2Billing S.L. <[email protected]>

django-admin-tools-stats is licensed under MIT, see MIT-LICENSE.txt.

More Repositories

1

python-nvd3

Python Wrapper for NVD3 - It's time for beautiful charts
Python
658
star
2

django-nvd3

Django wrapper for nvd3 - It's time for beautiful charts
Python
415
star
3

django-audiofield

Django-Audiofield is a simple app that allows Audio files upload, management and conversion to different audio format (mp3, wav & ogg), which also makes it easy to play audio files into your Django application.
JavaScript
168
star
4

django-frontend-notification

Django application to display on the frontend the list of notifications and run some basic actions such as "view all notifications", "delete notifications", it also provides helpers to display notifications
Python
30
star
5

a2billing-flask-api

Restful A2Billing APIs in Flask
Python
20
star
6

ansible-golang-stack

Ansible Playbook for setting up a Golang app with Supervisor & PostgreSQL,
16
star
7

cdr-pusher

CDR-Pusher is a Go Application that push CDRs to PostgreSQL or Riak
Go
16
star
8

freeswitch_realtime

Push FreeSWITCH Realtime info to InfluxDB & PostgreSQL
Elixir
14
star
9

freeswitch-telegraf-plugin

Telegraf plugin for FreeSWITCH
Python
12
star
10

django-sms-gateway

Send (and receive) SMS through a web gateway. Requires an account with a gateway company. Fork from https://bitbucket.org/schinckel/django-sms-gateway/
Python
10
star
11

wikipbx

WikiPBX is an open source PBX web interface for FreeSWITCH. WikiPBX is written in python and uses the Django web application framework. Clone from https://launchpad.net/wikipbx
JavaScript
8
star
12

a2b-cust

A2Billing Customer interface
JavaScript
6
star
13

django-lets-go

Django mix of goodies, common snippets, templatetags and more
Python
6
star
14

sms-khomp-api

HTTP API Gateway for KHOMP SMS
Python
4
star
15

fs_channels_influxdb

Collect and push channels information from FreeSWITCH Sqlite to InfluxDB
Elixir
3
star
16

go-pinguino

Go daemon/service that performs a list of actions based on the result of Http Get or Ping
Go
3
star
17

newfies-dialer-docs

Documentation for Newfies-Dailer Project
JavaScript
3
star
18

excdr-pusher

CDR-Pusher collect CDRs from SQLite & push them to PostgreSQL
Elixir
3
star
19

django-dilla

django model content generator [clone of http://gitweb.codeendeavor.com/?p=dilla.git;a=summary]
Python
2
star
20

cookiecutter-lua

Cookiecutter template for a Lua package
Lua
2
star
21

erlplay

Play around with Erlang
Erlang
2
star
22

wow-goodies

Misc of things mixed with stuff and with more things
PHP
1
star
23

gotelium

Distributed cloud Telecom data storage
Go
1
star
24

ex-chitchat

Chitchat Phoenix application
Elixir
1
star
25

lua-lfs-cache

Easily power a caching system based on Filesystem with Lua
Lua
1
star
26

graphql-crud-auth

ReactJS/Apollo/GraphQL Application to demonstrate how to create CRUD with filters and authentication
JavaScript
1
star
27

asterisk-stats

Asterisk-Stats - Old code added for archive (Don't use this project check replacement CDR-Stats.org)
PHP
1
star
28

echo-server-elixir

playground to test deployment
Elixir
1
star