Templatetag to render an application menu in the Django admin.
Project description
django-admin-appmenu provides a templatetag that renders an application menu in the Django admin.
Installation
Use pip to install the download and install the package from PyPi:
pip install django-admin-appmenu
Or checkout the source code from Github:
git clone https://github.com/collab-project/django-admin-appmenu.git cd django-admin-appmenu pip install -e .
Add admin_appmenu to INSTALLED_APPS in your Django project settings:
INSTALLED_APPS = (
...
'admin_appmenu',
)
Usage
Override the admin/base.html template and make the tag available in the template:
{% load navigation %}
Now add the admin_navigation tag to the template:
{% admin_navigation %}
After reloading the admin you will see the new menu.
To customize the output of the tag create and customize a copy of the admin_appmenu/navigation.html template.
Custom admin site
By default the standard Django admin site (django.contrib.admin.site) is used to build the menu tree. If your project uses a customized admin site set the ADMIN_APPMENU_CLASS setting to the path of the custom admin site instance.
For example in settings.py:
ADMIN_APPMENU_CLASS = 'myapp.admin.admin_site'
This also allows you to sort and format the applications list used to render the menu.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-admin-appmenu-1.0.0b1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d84525d81c3481c8b405b12869e46e2be677d001f2ef0cbf4d3c61e573c0a578 |
|
MD5 | 67a83608876a0add51fb201207858958 |
|
BLAKE2b-256 | 1cb770d6101f49441b76bc47c03c88588d7fe248beb6e390db2d1f476b6d7b47 |