{ "info": { "author": "Petr Dlouhy", "author_email": "petr.dlouhy@email.cz", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "===================\nDjango admin charts\n===================\n\n:Description: Easily configurable charts statistics for ``django-admin`` and ``django-admin-tools``.\n:Documentation: http://django-admin-charts.readthedocs.org/en/latest/\n\n.. image:: https://travis-ci.org/PetrDlouhy/django-admin-charts.svg?branch=master\n :target: https://travis-ci.org/PetrDlouhy/django-admin-charts\n\n.. image:: https://img.shields.io/pypi/v/django-admin-charts.svg\n :target: https://pypi.python.org/pypi/django-admin-charts/\n :alt: Latest Version\n\n.. image:: https://img.shields.io/pypi/dm/django-admin-charts.svg\n :target: https://pypi.python.org/pypi/django-admin-charts/\n :alt: Downloads\n\n.. image:: https://img.shields.io/pypi/pyversions/django-admin-charts.svg\n :target: https://pypi.python.org/pypi/django-admin-charts/\n :alt: Supported Python versions\n\n.. image:: https://img.shields.io/pypi/l/django-admin-charts.svg\n :target: https://pypi.python.org/pypi/django-admin-charts/\n :alt: License\n\n.. inclusion-marker-do-not-remove\n\nCreate beautiful configurable charts from your models and display them on the ``django-admin`` index page or on ``django-admin-tools`` dashboard.\nThe charts are based on models and criterias defined through admin interface and some chart parameters are configurable in live view.\n\nThis is application is fork of `django-admin-tools-stats `_ which has been reworked to display all charts through Ajax and made work with plain ``django-admin``. The ``django-admin-tools`` are supported but not needed.\n\n.. image:: https://github.com/PetrDlouhy/django-admin-charts/raw/develop/docs/source/_static/admin_dashboard.png\n\n\n============\nInstallation\n============\n\nInstall, upgrade and uninstall django-admin-charts with these commands::\n\n $ pip install django-admin-charts\n\n\n\nBasic setup for ``django-admin``\n--------------------------------\n\nAdd ``admin_tools_stats`` (the Django admin charts application) & ``django_nvd3`` into INSTALLED_APPS in settings.py::\n\n INSTALLED_APPS = (\n 'admin_tools_stats', # this must be BEFORE 'admin_tools' and 'django.contrib.admin'\n 'django_nvd3',\n ...\n 'django.contrib.admin',\n )\n\nInstall the ``nvd3`` and ``d3`` javascript libraries. For installation with ``django-bower`` see section `Installation of javascript libraries with django-bower`_.\n\nRegister chart views in your ``urls.py``::\n\n from django.urls import path\n urlpatterns = [\n path('admin_tools_stats/', include('admin_tools_stats.urls')),\n ]\n\nRun migrations::\n\n $ python manage.py migrate\n\nOpen admin panel, configure ``Dashboard Stats Criteria`` & ``Dashboard Stats`` respectively\n\n======================\nSpecial configurations\n======================\n\nUpdate from ``django-admin-tools-stats``\n----------------------------------------\n\nUninstall ``django-admin-tools-stats``.\n\nFollow ``django-admin-charts`` installation according to previous section. Especially pay attention to these steps:\n- Move ``admin_tools_stats`` in ``INSTALLED_APPS`` before ``admin_tools`` and ``django.contrib.admin``.\n- Configure ``urls.py``.\n\nChange ``DashboardCharts`` to ``DashboardChart`` in dashboard definition (this is recomended even if dummy class is left for compatibility reasons).\n\nCheck any overridden template from ``admin_tools_stats`` or ``DashboardChart(s)`` class that might interfere with the changes.\n\n\nInstallation of javascript libraries with ``django-bower``\n----------------------------------------------------------\n\nAdd ``django-bower`` to INSTALLED_APPS in settings.py::\n\n INSTALLED_APPS = (\n ...\n 'djangobower'\n )\n\nAdd the following properties to you settings.py file::\n\n # Specifie path to components root (you need to use absolute path)\n BOWER_COMPONENTS_ROOT = os.path.join(PROJECT_ROOT, 'components')\n\n\n BOWER_INSTALLED_APPS = (\n 'd3#3.3.13',\n 'nvd3#1.7.1',\n )\n\nAdd django-bower finder to your static file finders::\n\n STATICFILES_FINDERS = (\n ...\n 'djangobower.finders.BowerFinder',\n )\n\nRun 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::\n\n $ python manage.py bower_install\n $ python manage.py collectstatic\n\n\n\nUsage with ``django-admin-tools``\n----------------------------------\n\nConfigure ``admin_tools``\n\nAdd following code to dashboard.py::\n\n from admin_tools_stats.modules import DashboardChart, get_active_graph\n\n # append an app list module\n self.children.append(modules.AppList(\n _('Dashboard Stats Settings'),\n models=('admin_tools_stats.*', ),\n ))\n\n # Copy following code into your custom dashboard\n # append following code after recent actions module or\n # a link list module for \"quick links\"\n graph_list = get_active_graph()\n for i in graph_list:\n kwargs = {}\n kwargs['require_chart_jscss'] = True\n kwargs['graph_key'] = i.graph_key\n\n for key in context['request'].POST:\n if key.startswith('select_box_'):\n kwargs[key] = context['request'].POST[key]\n\n self.children.append(DashboardChart(**kwargs))\n\n\nYou may also need to add some includes to your template admin base, see an example on the demo project::\n\n demoproject/demoproject/templates/admin/base_site.html\n\n\n===========\nDevelopment\n===========\n\nDependencies\n------------\n\ndjango-admin-charts is a django based application, the major requirements are:\n\n - django-jsonfield\n - django-qsstats-magic\n - django-nvd3\n - django-bower\n\n\nContributing\n------------\n\nIf you've found a bug, add a feature or improve django-admin-charts and\nthink it is useful then please consider contributing.\nPatches, pull requests or just suggestions are always welcome!\n\nSource code: http://github.com/PetrDlouhy/django-admin-charts\n\nBug tracker: https://github.com/PetrDlouhy/django-admin-charts/issues\n\n\nDocumentation\n-------------\n\nDocumentation is available on 'Read the Docs':\nhttp://readthedocs.org/docs/django-admin-charts/\n\n\nLicense\n-------\n\ndjango-admin-charts is licensed under MIT, see ``MIT-LICENSE.txt``.\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/PetrDlouhy/django-admin-charts", "keywords": "", "license": "MIT License", "maintainer": "", "maintainer_email": "", "name": "django-admin-charts", "package_url": "https://pypi.org/project/django-admin-charts/", "platform": "", "project_url": "https://pypi.org/project/django-admin-charts/", "project_urls": { "Homepage": "https://github.com/PetrDlouhy/django-admin-charts" }, "release_url": "https://pypi.org/project/django-admin-charts/0.10.1/", "requires_dist": null, "requires_python": "", "summary": "django-admin-charts - Easily configurable charts statistics for `django-admin` and `django-admin-tools`", "version": "0.10.1" }, "last_serial": 5937897, "releases": { "0.10.0": [ { "comment_text": "", "digests": { "md5": "23be39ba983b12c17df4f71b9b4fe73a", "sha256": "78c396ded549d29c3b8d6efec6402088d5931f8f16705eadb0790218b50cb962" }, "downloads": -1, "filename": "django-admin-charts-0.10.0.tar.gz", "has_sig": false, "md5_digest": "23be39ba983b12c17df4f71b9b4fe73a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 627266, "upload_time": "2019-10-04T16:08:33", "url": "https://files.pythonhosted.org/packages/3f/89/86be056d425b3d269bd2af6c73729709e64d702d04de28103d288105cb31/django-admin-charts-0.10.0.tar.gz" } ], "0.10.1": [ { "comment_text": "", "digests": { "md5": "340ebfadcc3edb784114bd89837700f5", "sha256": "5fcdc6ab44d067cb34b0db66fa148b36fea66e6ef46624662aa345e22556aba9" }, "downloads": -1, "filename": "django-admin-charts-0.10.1.tar.gz", "has_sig": false, "md5_digest": "340ebfadcc3edb784114bd89837700f5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 639114, "upload_time": "2019-10-07T09:43:17", "url": "https://files.pythonhosted.org/packages/fc/e1/d37b9cba4018e6e2eda8afe22fb3f67410de91bea23ecf25948f52ada93f/django-admin-charts-0.10.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "340ebfadcc3edb784114bd89837700f5", "sha256": "5fcdc6ab44d067cb34b0db66fa148b36fea66e6ef46624662aa345e22556aba9" }, "downloads": -1, "filename": "django-admin-charts-0.10.1.tar.gz", "has_sig": false, "md5_digest": "340ebfadcc3edb784114bd89837700f5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 639114, "upload_time": "2019-10-07T09:43:17", "url": "https://files.pythonhosted.org/packages/fc/e1/d37b9cba4018e6e2eda8afe22fb3f67410de91bea23ecf25948f52ada93f/django-admin-charts-0.10.1.tar.gz" } ] }