{"id":13415498,"url":"https://github.com/MaistrenkoAnton/django-material-admin","last_synced_at":"2025-03-14T23:30:42.658Z","repository":{"id":32993421,"uuid":"148436396","full_name":"MaistrenkoAnton/django-material-admin","owner":"MaistrenkoAnton","description":"Material design for django administration","archived":false,"fork":false,"pushed_at":"2024-07-17T18:33:34.000Z","size":3323,"stargazers_count":319,"open_issues_count":54,"forks_count":66,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-09-30T23:12:50.751Z","etag":null,"topics":["admin","crud","django","django-admin","material","materilalize"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MaistrenkoAnton.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-12T07:00:11.000Z","updated_at":"2024-09-19T09:35:20.000Z","dependencies_parsed_at":"2024-01-06T09:54:14.882Z","dependency_job_id":"827e2a3d-ad2b-4644-93e3-a6127976f143","html_url":"https://github.com/MaistrenkoAnton/django-material-admin","commit_stats":{"total_commits":435,"total_committers":14,"mean_commits":"31.071428571428573","dds":"0.14022988505747125","last_synced_commit":"8e113070b3ed47965cbe1bd4164729ea47b6a6f8"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaistrenkoAnton%2Fdjango-material-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaistrenkoAnton%2Fdjango-material-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaistrenkoAnton%2Fdjango-material-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaistrenkoAnton%2Fdjango-material-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MaistrenkoAnton","download_url":"https://codeload.github.com/MaistrenkoAnton/django-material-admin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243663201,"owners_count":20327299,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["admin","crud","django","django-admin","material","materilalize"],"created_at":"2024-07-30T21:00:49.764Z","updated_at":"2025-03-14T23:30:42.216Z","avatar_url":"https://github.com/MaistrenkoAnton.png","language":"HTML","funding_links":[],"categories":["Third-Party Packages"],"sub_categories":["Admin","Admin Themes"],"readme":"|pypi| |python| |django|\n\n.. .. |build|\n\n\n.. |pypi| image:: https://d25lcipzij17d.cloudfront.net/badge.svg?id=py\u0026type=6\u0026v=1.8.6\u0026x2=0\n    :target: https://pypi.org/project/django-material-admin/\n.. |python| image:: https://img.shields.io/badge/python-3.4+-blue.svg\n    :target: https://www.python.org/\n.. |django| image:: https://img.shields.io/badge/django-2.2+|3.2-mediumseagreen.svg\n    :target: https://www.djangoproject.com/ \n.. .. |build| image:: http://ec2-35-157-197-184.eu-central-1.compute.amazonaws.com:8080/buildStatus/icon?job=Job1\n..    :target: http://ec2-35-157-197-184.eu-central-1.compute.amazonaws.com\n\n==============================\nDjango Material Administration\n==============================\n\n\n.. image:: https://raw.githubusercontent.com/MaistrenkoAnton/django-material-admin/master/app/demo/screens/login.png\n\n.. **login**: *admin*\n\n.. **pass**: *123qaz123!A*\n\nQuick start\n-----------\n\n \n**pip install django-material-admin**\n\n1. Add **material.admin** and **material.admin.default** to your INSTALLED_APPS setting instead of **django.contrib.admin**::\n - required\n\n.. code-block:: python\n\n    INSTALLED_APPS = (\n        'material',\n        'material.admin',\n\n        'django.contrib.auth',\n        ...\n    )\n\n\n2. Include the material templates URLconf in your project **urls.py** like this:\n - required\n.. code-block:: python\n\n    from django.contrib import admin\n    from django.urls import path\n\n    urlpatterns = [\n        path('admin/', admin.site.urls),\n    ]\n\n\n3. Register your models in **admin.py**.\n  \n.. code-block:: python\n\n    from django.contrib.admin import ModelAdmin, register\n\n\n    from persons.models import Person\n\n    @register(Person)\n    class PersonAdmin(ModelAdmin):\n        list_display = ('name', 'first_name', 'last_name')\n\n4. Add icon to the application in **app.py** and specify the app usage in **__init__.py**\n\nhttps://materializecss.com/icons.html\n - optional\n \n**__init.py__**\n\n.. code-block:: python\n    \n    default_app_config = 'persons.apps.PersonsConfig'\n    \n**apps.py**\n\n.. code-block:: python\n\n    from django.apps import AppConfig\n\n\n    class PersonsConfig(AppConfig):\n        name = 'persons'\n        icon_name = 'person'\n\n\n5. Add icon to the MaterialModelAdmin in **admin.py**\n\nMaterial icon's name sources:\n\nhttps://materializecss.com/icons.html\n\nhttps://material.io/resources/icons/?style=baseline\n\n - optional\n\n.. code-block:: python\n\n    from django.contrib.admin import ModelAdmin, register\n\n    from persons.models import Person\n\n\n    @register(Person)\n    class MaterialPersonAdmin(ModelAdmin):\n        icon_name = 'person'\n\n\n6. Add Admin site configurations to **settings.py** file:\n\n - optional\n##########################################################\n\n.. code-block:: python\n\n    MATERIAL_ADMIN_SITE = {\n        'HEADER':  _('Your site header'),  # Admin site header\n        'TITLE':  _('Your site title'),  # Admin site title\n        'FAVICON':  'path/to/favicon',  # Admin site favicon (path to static should be specified)\n        'MAIN_BG_COLOR':  'color',  # Admin site main color, css color should be specified\n        'MAIN_HOVER_COLOR':  'color',  # Admin site main hover color, css color should be specified\n        'PROFILE_PICTURE':  'path/to/image',  # Admin site profile picture (path to static should be specified)\n        'PROFILE_BG':  'path/to/image',  # Admin site profile background (path to static should be specified)\n        'LOGIN_LOGO':  'path/to/image',  # Admin site logo on login page (path to static should be specified)\n        'LOGOUT_BG':  'path/to/image',  # Admin site background on login/logout pages (path to static should be specified)\n        'SHOW_THEMES':  True,  #  Show default admin themes button\n        'TRAY_REVERSE': True,  # Hide object-tools and additional-submit-line by default\n        'NAVBAR_REVERSE': True,  # Hide side navbar by default\n        'SHOW_COUNTS': True, # Show instances counts for each model\n        'APP_ICONS': {  # Set icons for applications(lowercase), including 3rd party apps, {'application_name': 'material_icon_name', ...}\n            'sites': 'send',\n        },\n        'MODEL_ICONS': {  # Set icons for models(lowercase), including 3rd party models, {'model_name': 'material_icon_name', ...}\n            'site': 'contact_mail',\n        }\n    }\n##########################################################\n\n\n==============\nvideo lessons:\n==============\n\n- PySchool\n\n.. image:: https://raw.githubusercontent.com/MaistrenkoAnton/django-material-admin/master/app/demo/screens/pyself.png\n   :target: https://pyschool.tech/lessons/django-material-admin-installation\n\n\n==================\nVideo instructions\n==================\n|\n|\n- Install Django\n\n.. image:: https://raw.githubusercontent.com/MaistrenkoAnton/django-material-admin/master/app/demo/screens/material1.png\n   :target: https://youtu.be/LiTcyD9A1A0\n|\n|\n- Install Django-material-admin\n\n.. image:: https://raw.githubusercontent.com/MaistrenkoAnton/django-material-admin/master/app/demo/screens/material2.png\n   :target: https://youtu.be/trY492bgNQU\n|\n|\n- Register models for material administration interface\n\n.. image:: https://raw.githubusercontent.com/MaistrenkoAnton/django-material-admin/master/app/demo/screens/material3.png\n   :target: https://youtu.be/_ifWi-a1z6M\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaistrenkoAnton%2Fdjango-material-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMaistrenkoAnton%2Fdjango-material-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaistrenkoAnton%2Fdjango-material-admin/lists"}