Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cdrx/django-admin-menu
A Django admin theme with a horizontal, tabbed navigation bar
https://github.com/cdrx/django-admin-menu
Last synced: 15 days ago
JSON representation
A Django admin theme with a horizontal, tabbed navigation bar
- Host: GitHub
- URL: https://github.com/cdrx/django-admin-menu
- Owner: cdrx
- License: mit
- Created: 2016-12-02T14:47:32.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-02-01T11:51:50.000Z (almost 3 years ago)
- Last Synced: 2024-09-21T13:38:10.121Z (about 2 months ago)
- Language: Python
- Size: 554 KB
- Stars: 104
- Watchers: 10
- Forks: 38
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Django Admin Menu Theme
An alternative theme for the Django admin that has a horizontal navigation bar with drop down menus for your models. Fully themeable from `settings.py`.
[](https://pepy.tech/project/django-admin-menu)
## Installation
Install the package:
```
pip install django-admin-menu
```
Then add `admin_menu` to your `INSTALLED_APPS` setting, **before `django.contrib.admin`** (or it wont work). For example:
```
INSTALLED_APPS = [
'admin_menu',
'django.contrib.admin',
...
]
```
## Settings
There are a couple of options you can adjust in your `settings.py` to influence the theme.
To adjust the logo, change:
```
ADMIN_LOGO = 'logo.png'
```
The logo is used in the top left of each page and on the login page.
You can adjust the order of the menu items with the `MENU_WEIGHT` setting:
```
MENU_WEIGHT = {
'World': 20,
'Auth': 4,
'Sample': 5
}
```
Items with a higher weight will be pushed to the end of the menu. You don't have to fill in all the menu items, just the ones you would like to adjust the position of.
### ModelAdmin Settings
There are a few settings on your `ModelAdmin` class to adjust the menu:
```
class MyAdmin(admin.ModelAdmin):
menu_title = "Users"
menu_group = "Staff"
```
will change the title for this model to `Users` and place it on a drop down titled `Staff`.
You can use the same `menu_group` on multiple `ModelAdmin` classes and they will be grouped on the same menu.
## Screenshots
## Theming
To adjust the theme, you can add and edit these options in your project's `settings.py` file:
```
ADMIN_STYLE = {
'primary-color': '#164B36',
'secondary-color': '#092117',
'tertiary-color': '#51B48E'
}
```
These variables are usually enough to add a brand flavour to the admin. There are other variables you can add, to change text colour etc. These are listed under Custom Theme.
### Dark Theme
Add to your settings.py:
```
ADMIN_STYLE = {
'primary-color': '#2B3746',
'secondary-color': '#354151',
'tertiary-color': '#F2F9FC'
}
```
### Django Theme
Add to your settings.py:
```
ADMIN_STYLE = {
'primary-color': '#164B36',
'secondary-color': '#092117',
'tertiary-color': '#51B48E'
}
```
### Red Theme
Add to your settings.py:
```
ADMIN_STYLE = {
'primary-color': '#B42D33',
'secondary-color': '#000000',
'tertiary-color': '#333333'
}
```
### Custom Themes
You can customise the theme however you like, using these available variables:
```
ADMIN_STYLE = {
'background': 'white',
'primary-color': '#205280',
'primary-text': '#d6d5d2',
'secondary-color': '#3B75AD',
'secondary-text': 'white',
'tertiary-color': '#F2F9FC',
'tertiary-text': 'black',
'breadcrumb-color': 'whitesmoke',
'breadcrumb-text': 'black',
'focus-color': '#eaeaea',
'focus-text': '#666',
'primary-button': '#26904A',
'primary-button-text':' white',
'secondary-button': '#999',
'secondary-button-text': 'white',
'link-color': '#333',
'link-color-hover': 'lighten($link-color, 20%)',
'logo-width': 'auto',
'logo-height': '35px'
}
```
## History
#### [1.0] - 2016-12-05
First release, works.
#### [1.1] - 2016-12-16
Added theming support.
#### [1.2] - 2020-04-06
* Added support for Django 3.0+.
* Made the `ADMIN_LOGO` setting optional.
* Allowed adjusting admin logo size with `logo-width` and `logo-height` style settings.
#### [1.3] - 2020-06-27
* Reworked the pagination style to look more inline with the table style
* Fixed an issue where the `verbose_name` from the `AppConfig` class wasn't used in the menu
#### [1.4] - 2020-11-16
* Fixed a bug where the Dashboard icon would be highlighted even if another tab was active
* Display the admin title as text if no logo is defined in the settings
#### [1.5] - 2021-02-14
* Fixed compatibility with Django 3+ (thanks to arturgsb)
#### [1.6] - 2022-02-01
* Fixed compatibility with Django 4
* Added support for Django's view permission (thanks @cobia)
* Fixed menu height on mobile (thanks @mojek)
#### [unreleased]
## License
MIT