# Django jazzmin (Jazzy Admin)
## Project Status
This project is being actively maintained, though with a reduced feature set, we are looking for contributors to help
maintain and improve the project, please get in touch if you would like to help.
Help needed with:
- Triaging issues
- Frontend fixes and UI improvements
- Testing
- Documentation
Pull requests are welcome, though ive been pre-occupied with other projects lately, so have not been able to review
them as quickly as I would like, but im trying to get through them all now, hopefully with some outside help.
[![Docs](https://readthedocs.org/projects/django-jazzmin/badge/?version=latest)](https://django-jazzmin.readthedocs.io)
![PyPI download month](https://img.shields.io/pypi/dm/django-jazzmin.svg)
[![PyPI version](https://badge.fury.io/py/django-jazzmin.svg)](https://pypi.python.org/pypi/django-jazzmin/)
![Python versions](https://img.shields.io/badge/python-%3E=3.8-brightgreen)
![Django Versions](https://img.shields.io/badge/django-%3E=4.2-brightgreen)
[![Coverage Status](https://coveralls.io/repos/github/farridav/django-jazzmin/badge.svg?branch=master)](https://coveralls.io/github/farridav/django-jazzmin?branch=master)
Drop-in theme for django admin, that utilises AdminLTE 3 & Bootstrap 4 to make yo' admin look jazzy
## Installation
```bash
pip install django-jazzmin
```
## Documentation
See [Documentation](https://django-jazzmin.readthedocs.io) or [Test App](https://github.com/farridav/django-jazzmin/tree/master/tests/test_app/library/settings.py)
## Features
- Drop-in admin skin, all configuration optional
- Customisable side menu
- Customisable top menu
- Customisable user menu
- 4 different Change form templates (horizontal tabs, vertical tabs, carousel, collapsible)
- Bootstrap 4 modal (instead of the old popup window, optional)
- Search bar for any given model admin
- Customisable UI (via Live UI changes, or custom CSS/JS)
- Responsive
- Select2 drop-downs
- Bootstrap 4 & AdminLTE UI components
- Using the latest [adminlte](https://adminlte.io/) + [bootstrap](https://getbootstrap.com/)
## Screenshots
## Dashboard
![dashboard](https://django-jazzmin.readthedocs.io/img/dashboard.png)
## List view
![table list](https://django-jazzmin.readthedocs.io/img/list_view.png)
## Change form templates
### Collapsed side menu
![form page](https://django-jazzmin.readthedocs.io/img/detail_view.png)
### Expanded side menu
![Single](https://django-jazzmin.readthedocs.io/img/changeform_single.png)
### Horizontal tabs
![Horizontal tabs](https://django-jazzmin.readthedocs.io/img/changeform_horizontal_tabs.png)
### Vertical tabs
![Vertical tabs](https://django-jazzmin.readthedocs.io/img/changeform_vertical_tabs.png)
### Collapsible
![Collapsible](https://django-jazzmin.readthedocs.io/img/changeform_collapsible.png)
### Carousel
![Carousel](https://django-jazzmin.readthedocs.io/img/changeform_carousel.png)
### Related modal
![Related modal](https://django-jazzmin.readthedocs.io/img/related_modal_bootstrap.png)
## History page
![form page](https://django-jazzmin.readthedocs.io/img/history_page.png)
## Login view
![login](https://django-jazzmin.readthedocs.io/img/login.png)
## UI Customiser
![ui_customiser](https://django-jazzmin.readthedocs.io/img/ui_customiser.png)
## Mobile layout
![mobile](https://django-jazzmin.readthedocs.io/img/dashboard_mobile.png)
## Tablet layout
![tablet](https://django-jazzmin.readthedocs.io/img/dashboard_tablet.png)
## Admin Docs (if installed)
![admin_docs](https://django-jazzmin.readthedocs.io/img/admin_docs.png)
## Thanks
This was initially a Fork of <https://github.com/wuyue92tree/django-adminlte-ui> that we refactored so much we thought it
deserved its own package, big thanks to @wuyue92tree for all of his initial hard work, we are still patching into that
project were possible, but this project has taken a different direction.
The javascript modal implementation uses some code from [django-admin-interface](https://github.com/fabiocaccamo/django-admin-interface/blob/master/admin_interface/static/admin/js/popup_response.js), so thanks to @fabiocaccamo for original work
- Based on AdminLTE 3: <https://adminlte.io/>
- Using Bootstrap 4: <https://getbootstrap.com/>
- Using Font Awesome 5: <https://fontawesome.com/>
Raw data
{
"_id": null,
"home_page": "https://github.com/farridav/django-jazzmin",
"name": "django-jazzmin",
"maintainer": "Shipit",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "packages@shipit.ltd",
"keywords": "django, dashboard, theme, admin, jazzmin",
"author": "Shipit",
"author_email": "packages@shipit.ltd",
"download_url": "https://files.pythonhosted.org/packages/84/96/21b6255e90d92a3eb4e93bea9376635d54258e0353ebb913a55e40ae9254/django_jazzmin-3.0.1.tar.gz",
"platform": null,
"description": "\n# Django jazzmin (Jazzy Admin)\n\n## Project Status\n\nThis project is being actively maintained, though with a reduced feature set, we are looking for contributors to help\nmaintain and improve the project, please get in touch if you would like to help.\n\nHelp needed with:\n\n- Triaging issues\n- Frontend fixes and UI improvements\n- Testing\n- Documentation\n\nPull requests are welcome, though ive been pre-occupied with other projects lately, so have not been able to review\nthem as quickly as I would like, but im trying to get through them all now, hopefully with some outside help.\n\n[![Docs](https://readthedocs.org/projects/django-jazzmin/badge/?version=latest)](https://django-jazzmin.readthedocs.io)\n![PyPI download month](https://img.shields.io/pypi/dm/django-jazzmin.svg)\n[![PyPI version](https://badge.fury.io/py/django-jazzmin.svg)](https://pypi.python.org/pypi/django-jazzmin/)\n![Python versions](https://img.shields.io/badge/python-%3E=3.8-brightgreen)\n![Django Versions](https://img.shields.io/badge/django-%3E=4.2-brightgreen)\n[![Coverage Status](https://coveralls.io/repos/github/farridav/django-jazzmin/badge.svg?branch=master)](https://coveralls.io/github/farridav/django-jazzmin?branch=master)\n\nDrop-in theme for django admin, that utilises AdminLTE 3 & Bootstrap 4 to make yo' admin look jazzy\n\n## Installation\n\n```bash\npip install django-jazzmin\n```\n\n## Documentation\n\nSee [Documentation](https://django-jazzmin.readthedocs.io) or [Test App](https://github.com/farridav/django-jazzmin/tree/master/tests/test_app/library/settings.py)\n\n## Features\n\n- Drop-in admin skin, all configuration optional\n- Customisable side menu\n- Customisable top menu\n- Customisable user menu\n- 4 different Change form templates (horizontal tabs, vertical tabs, carousel, collapsible)\n- Bootstrap 4 modal (instead of the old popup window, optional)\n- Search bar for any given model admin\n- Customisable UI (via Live UI changes, or custom CSS/JS)\n- Responsive\n- Select2 drop-downs\n- Bootstrap 4 & AdminLTE UI components\n- Using the latest [adminlte](https://adminlte.io/) + [bootstrap](https://getbootstrap.com/)\n\n## Screenshots\n\n## Dashboard\n\n![dashboard](https://django-jazzmin.readthedocs.io/img/dashboard.png)\n\n## List view\n\n![table list](https://django-jazzmin.readthedocs.io/img/list_view.png)\n\n## Change form templates\n\n### Collapsed side menu\n\n![form page](https://django-jazzmin.readthedocs.io/img/detail_view.png)\n\n### Expanded side menu\n\n![Single](https://django-jazzmin.readthedocs.io/img/changeform_single.png)\n\n### Horizontal tabs\n\n![Horizontal tabs](https://django-jazzmin.readthedocs.io/img/changeform_horizontal_tabs.png)\n\n### Vertical tabs\n\n![Vertical tabs](https://django-jazzmin.readthedocs.io/img/changeform_vertical_tabs.png)\n\n### Collapsible\n\n![Collapsible](https://django-jazzmin.readthedocs.io/img/changeform_collapsible.png)\n\n### Carousel\n\n![Carousel](https://django-jazzmin.readthedocs.io/img/changeform_carousel.png)\n\n### Related modal\n\n![Related modal](https://django-jazzmin.readthedocs.io/img/related_modal_bootstrap.png)\n\n## History page\n\n![form page](https://django-jazzmin.readthedocs.io/img/history_page.png)\n\n## Login view\n\n![login](https://django-jazzmin.readthedocs.io/img/login.png)\n\n## UI Customiser\n\n![ui_customiser](https://django-jazzmin.readthedocs.io/img/ui_customiser.png)\n\n## Mobile layout\n\n![mobile](https://django-jazzmin.readthedocs.io/img/dashboard_mobile.png)\n\n## Tablet layout\n\n![tablet](https://django-jazzmin.readthedocs.io/img/dashboard_tablet.png)\n\n## Admin Docs (if installed)\n\n![admin_docs](https://django-jazzmin.readthedocs.io/img/admin_docs.png)\n\n## Thanks\n\nThis was initially a Fork of <https://github.com/wuyue92tree/django-adminlte-ui> that we refactored so much we thought it\ndeserved its own package, big thanks to @wuyue92tree for all of his initial hard work, we are still patching into that\nproject were possible, but this project has taken a different direction.\n\nThe javascript modal implementation uses some code from [django-admin-interface](https://github.com/fabiocaccamo/django-admin-interface/blob/master/admin_interface/static/admin/js/popup_response.js), so thanks to @fabiocaccamo for original work\n\n- Based on AdminLTE 3: <https://adminlte.io/>\n- Using Bootstrap 4: <https://getbootstrap.com/>\n- Using Font Awesome 5: <https://fontawesome.com/>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Drop-in theme for django admin, that utilises AdminLTE 3 & Bootstrap 4 to make yo' admin look jazzy",
"version": "3.0.1",
"project_urls": {
"All Releases": "https://github.com/farridav/django-jazzmin/releases",
"Bug Tracker": "https://github.com/farridav/django-jazzmin/issues",
"Documentation": "https://django-jazzmin.readthedocs.io",
"Homepage": "https://github.com/farridav/django-jazzmin",
"Latest Release": "https://github.com/farridav/django-jazzmin/releases/latest",
"Repository": "https://github.com/farridav/django-jazzmin",
"Source": "https://github.com/farridav/django-jazzmin"
},
"split_keywords": [
"django",
" dashboard",
" theme",
" admin",
" jazzmin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ad5b2f8c4b168e6c41bf1e4b14d787deb23d80f618f0693db913bbe208a4a907",
"md5": "00aa9ea85b66ee3ff41edb731177473b",
"sha256": "12a0a4c1d4fd09c2eef22acf6a1f03112b515ba695c59faa8ea80efc81c1f21b"
},
"downloads": -1,
"filename": "django_jazzmin-3.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "00aa9ea85b66ee3ff41edb731177473b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 2125957,
"upload_time": "2024-10-08T17:40:57",
"upload_time_iso_8601": "2024-10-08T17:40:57.359596Z",
"url": "https://files.pythonhosted.org/packages/ad/5b/2f8c4b168e6c41bf1e4b14d787deb23d80f618f0693db913bbe208a4a907/django_jazzmin-3.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "849621b6255e90d92a3eb4e93bea9376635d54258e0353ebb913a55e40ae9254",
"md5": "fc8bde7d203e77f63196741998fbfa92",
"sha256": "67ae148bade41267a09ca8e4352ddefa6121795ebbac238bb9a6564ff841eb1b"
},
"downloads": -1,
"filename": "django_jazzmin-3.0.1.tar.gz",
"has_sig": false,
"md5_digest": "fc8bde7d203e77f63196741998fbfa92",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 2053550,
"upload_time": "2024-10-08T17:40:59",
"upload_time_iso_8601": "2024-10-08T17:40:59.771393Z",
"url": "https://files.pythonhosted.org/packages/84/96/21b6255e90d92a3eb4e93bea9376635d54258e0353ebb913a55e40ae9254/django_jazzmin-3.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-08 17:40:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "farridav",
"github_project": "django-jazzmin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "django-jazzmin"
}