Material Design For Django Administration
Project description
|pypi| |python| |django|
.. .. |build|
.. |pypi| image:: https://d25lcipzij17d.cloudfront.net/badge.svg?id=py&type=6&v=1.8.6&x2=0 :target: https://pypi.org/project/django-material-admin/ .. |python| image:: https://img.shields.io/badge/python-3.4+-blue.svg :target: https://www.python.org/ .. |django| image:: https://img.shields.io/badge/django-2.2+|3.2-mediumseagreen.svg :target: https://www.djangoproject.com/ .. .. |build| image:: http://ec2-35-157-197-184.eu-central-1.compute.amazonaws.com:8080/buildStatus/icon?job=Job1 .. :target: http://ec2-35-157-197-184.eu-central-1.compute.amazonaws.com
============================== Django Material Administration
.. login: admin
.. pass: 123qaz123!A
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
.. code-block:: python
INSTALLED_APPS = (
'material',
'material.admin',
'django.contrib.auth',
...
)
- Include the material templates URLconf in your project urls.py like this:
-
required .. code-block:: python
from django.contrib import admin from django.urls import path
urlpatterns = [ path('admin/', admin.site.urls), ]
- Register your models in admin.py.
.. code-block:: python
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
https://materializecss.com/icons.html
- optional
init.py
.. code-block:: python
default_app_config = 'persons.apps.PersonsConfig'
apps.py
.. code-block:: python
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
.. code-block:: python
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 ##########################################################
.. code-block:: python
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
.. image:: https://raw.githubusercontent.com/MaistrenkoAnton/django-material-admin/master/app/demo/screens/pyself.png :target: https://pyschool.tech/lessons/django-material-admin-installation
================== Video instructions
| |
- Install Django
.. image:: https://raw.githubusercontent.com/MaistrenkoAnton/django-material-admin/master/app/demo/screens/material1.png :target: https://youtu.be/LiTcyD9A1A0 | |
- Install Django-material-admin
.. image:: https://raw.githubusercontent.com/MaistrenkoAnton/django-material-admin/master/app/demo/screens/material2.png :target: https://youtu.be/trY492bgNQU | |
- Register models for material administration interface
.. image:: https://raw.githubusercontent.com/MaistrenkoAnton/django-material-admin/master/app/demo/screens/material3.png :target: https://youtu.be/_ifWi-a1z6M
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-material-admin-plus-1.8.9.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2bc5ecac2d1cab5ae6d2d5b5b39a9aaaa75bdac6e3f98a46cdf3164c07dcd2a6 |
|
MD5 | b7d2a55a6256ba173dfa49f4928cc495 |
|
BLAKE2b-256 | f353bb2a77afd6119cbecbba3733846525f99ec7df82e2bbc13ec1208d6e92a0 |
Hashes for django_material_admin_plus-1.8.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fd633e6c7f867ff7363765bba29cbe7c886e1e631f5e3befc567e7d0e26ee550 |
|
MD5 | 2b71485723c89744cd0ece2c2153dc88 |
|
BLAKE2b-256 | ed0e2ae9cfa6890760c2511377d774382269a8cb8c8738c864afb3b6bec4bc45 |