Skip to main content

Intelligent management for multiple subclass models in django's admin site.

Project description

pip install django-msms-admin

Intelligent management for multiple subclass models in django's admin site.


pip install django-msms-admin

Installed Classes

  • DjangoMsmsModelAbstractBase

    The base model must inherit from DjangoMsmsModelAbstractBase class. It provides app_label, model_name, type_name fields and auto save the values.

  • DjangoMsmsAdmin

    The base model admin must inherit from DjangoMsmsAdmin class.

  • DjangoSubclassAdmin

    All subclass models' admin must inherit from DjangoSubclassAdmin class.


  • DjangoMsmsAdmin.subclasses

    The config item is used to provide choices in select_subclass_model_view. If NOT provide, the system will auto find all registered subclasses. The structure of subclasses is a three-level-tree. e.g.

    subclasses = [{
        "title": "category1",
        "children": [{
            "title": "category11",
            "children: [
            "title": "category12",
            "children": [
        "title": "category2",
        "children": [{
            "title": "category21",
            "children": [
            "title": "category22,
            "children": [
  • DjangoMsmsModelAbstractBase.cascade_select_description

  • DjangoMsmsModelAbstractBase.cascade_select_image

    Config item cascade_select_description and cascade_select_image are use to display more information while you selected a subclass. cascade_select_image is url string of an image.





from django.db import models
from django.contrib.staticfiles.templatetags.staticfiles import static
from django_msms_admin.models import DjangoMsmsModelAbstractBase

class Book(DjangoMsmsModelAbstractBase, models.Model):
    title = models.CharField(max_length=64)
    author = models.CharField(max_length=64)

    def __str__(self):
        return self.title

class ComputerBook(Book):
    serial = models.CharField(max_length=64)

    cascade_select_description = "These books are all about computers."
    cascade_select_image = static("app/img/computer-book.jpg")

class NovelBook(Book):
    country = models.CharField(max_length=64)


from django.contrib import admin
from django_msms_admin.admin import DjangoMsmsAdmin
from django_msms_admin.admin import DjangoSubclassAdmin

from .models import Book
from .models import ComputerBook
from .models import NovelBook

class BookAdmin(DjangoMsmsAdmin, admin.ModelAdmin):

    list_display = ["title", "author", "type_name"]
    list_filter = ["type_name"], BookAdmin), DjangoSubclassAdmin), DjangoSubclassAdmin)


v0.1.0 2020/03/03

  • First release.

v0.1.1 2020/03/05

  • Add DjangoMsmsModelAbstractBase.get_real_object method.

v0.1.2 2020/03/06

  • Fix keywords in and read requirements.txt for install_requires.

v0.2.0 2020/03/07

  • Use model's msms_category, msm_priority property to do model category and sorting.
  • Rename cascade_select_description to msms_description.
  • Rename cascade_select_preview_image to msms_image.

v0.2.1 2020/09/09

  • No depends on django-static-jquery3.
  • Using media.css & media.js to render css/js links.
  • Add LICENSE file.

v0.2.2 2023/09/18

  • Doc update.

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

django-msms-admin-0.2.2.tar.gz (10.0 kB view hashes)

Uploaded source

Built Distribution

django_msms_admin-0.2.2-py3-none-any.whl (10.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page