Django Material Administration
Quick start
pip install django-material-admin
- Add material.admin and material.admin.default to your INSTALLED_APPS setting instead of django.contrib.admin:
- required
INSTALLED_APPS = (
'material',
'material.admin',
'django.contrib.auth',
...
)
- Include the material templates URLconf in your project urls.py like this:
- required
from django.contrib import admin
from django.urls import path
urlpatterns = [
path('admin/', admin.site.urls),
]
- Register your models in admin.py.
from django.contrib.admin import ModelAdmin, register
from persons.models import Person
@register(Person)
class PersonAdmin(ModelAdmin):
list_display = ('name', 'first_name', 'last_name')
- Add icon to the application in app.py and specify the app usage in __init__.py
__init.py__
default_app_config = 'persons.apps.PersonsConfig'
apps.py
from django.apps import AppConfig
class PersonsConfig(AppConfig):
name = 'persons'
icon_name = 'person'
- Add icon to the MaterialModelAdmin in admin.py
Material icon's name sources:
https://materializecss.com/icons.html
https://material.io/resources/icons/?style=baseline
- optional
from django.contrib.admin import ModelAdmin, register
from persons.models import Person
@register(Person)
class MaterialPersonAdmin(ModelAdmin):
icon_name = 'person'
- Add Admin site configurations to settings.py file:
- optional
MATERIAL_ADMIN_SITE = {
'HEADER': _('Your site header'), # Admin site header
'TITLE': _('Your site title'), # Admin site title
'FAVICON': 'path/to/favicon', # Admin site favicon (path to static should be specified)
'MAIN_BG_COLOR': 'color', # Admin site main color, css color should be specified
'MAIN_HOVER_COLOR': 'color', # Admin site main hover color, css color should be specified
'PROFILE_PICTURE': 'path/to/image', # Admin site profile picture (path to static should be specified)
'PROFILE_BG': 'path/to/image', # Admin site profile background (path to static should be specified)
'LOGIN_LOGO': 'path/to/image', # Admin site logo on login page (path to static should be specified)
'LOGOUT_BG': 'path/to/image', # Admin site background on login/logout pages (path to static should be specified)
'SHOW_THEMES': True, # Show default admin themes button
'TRAY_REVERSE': True, # Hide object-tools and additional-submit-line by default
'NAVBAR_REVERSE': True, # Hide side navbar by default
'SHOW_COUNTS': True, # Show instances counts for each model
'APP_ICONS': { # Set icons for applications(lowercase), including 3rd party apps, {'application_name': 'material_icon_name', ...}
'sites': 'send',
},
'MODEL_ICONS': { # Set icons for models(lowercase), including 3rd party models, {'model_name': 'material_icon_name', ...}
'site': 'contact_mail',
}
}
video lessons:
- PySchool
Video instructions
- Install Django
- Install Django-material-admin
- Register models for material administration interface
![[QUESTION] Configuring images and color through MATERIAL_ADMIN_SITE](https://avatars.githubusercontent.com/u/15203968?v=4)
373 Dec 26, 2022
266 Nov 21, 2022
140 Oct 30, 2021
248 Sep 2, 2022
326 Nov 9, 2022
524 Dec 26, 2022
215 Dec 31, 2022
6 Nov 23, 2022
3.4k Dec 29, 2022
4.7k Dec 31, 2022
1.9k Jan 1, 2023
3.4k Dec 31, 2022
1.6k Dec 28, 2022
1.3k Dec 31, 2022
1.2k Dec 29, 2022
2.2k Dec 29, 2022
1.2k Jan 8, 2023
1.2k Jan 5, 2023
2.6k Jan 7, 2023