django后台管理－ModelAdmin对象

Django最强大的部分之一是自动生成的管理后台界面。它从你的模型中读取元数据，以提供一个快速的、以模型为中心的界面，信任的用户可以在这里管理你网站上的内容。建议管理后台仅作为组织的一个内部管理工具使用。它不是为了建立你的整个前端。

管理站点有许多hook用于定制，但要注意试图专门使用这些hook。如果你需要提供一个更加以流程为中心的界面，它抽象出数据库表和字段的实现细节，那么可能需要编写自己的视图。

在本文中，我们将讨论如何激活、使用和定制Django的管理后台界面。【摘自官方文档】

通过使用startproject创建的默认项目模版中，管理后台已启用。

下面的一些要求作为参考：

    添加 'django.contrib.admin'到INSTALLED_APPS 设置中.

    admin有四个依赖 — django.contrib.auth、django.contrib.contenttypes、django.contrib.messages和django.contrib.sessions。 如果这些应用没有在
        INSTALLED_APPS列表中, 那你要添加它们。

    添加django.contrib.auth.context_processors.auth和django.contrib.messages.context_processors.messages到TEMPLATES中定义的DjangoTemplates后端的
        'context_processors'选项中，并添加django.contrib.auth.middleware.AuthenticationMiddleware和django.contrib.messages.middleware.MessageMiddleware
        到MIDDLEWARE中。 默认情况下它们都已经添加，除非你手动调整过设置，否则不需要自己添加。

    确定你的应用中的哪些模型在管理后台界面中应该可以编辑。

    给上面的每个模型创建一个ModelAdmin类，封装模型自定义的管理后台功能和选项。

    实例化AdminSite并且告诉它你的每一个模型和ModelAdmin类。

    将AdminSite实例hook到URLconf。

做完这些步骤之后，通过访问你hook进的URL（默认是/admin/），将能够使用你的Django管理后台站点。 如果你需要创建一个登录用户，可以使用createsuperuser命令。

ModelAdmin对象

ModelAdmin类是模型在管理后台界面中的表示形式。通常，它们保存在你的应用中的名为admin.py的文件里。让我们来看一个关于ModelAdmin类非常简单的例子:

from django.contrib import admin

from myproject.myapp.models import Author

class AuthorAdmin(admin.ModelAdmin):               #自己定义后台管理界面

    pass

admin.site.register(Author, AuthorAdmin)           #把对应的网页注册到ModleAdmin对象中

在上面的例子中，ModelAdmin并没有定义任何自定义的值。 因此, 系统将使用默认的管理后台界面。 如果对于默认的管理后台界面足够满意，那你根本不需要自己定义ModelAdmin对象
 — 你可以直接注册模型类而无需提供ModelAdmin的描述。 那么上面的例子可以简化成：

from django.contrib import admin

from myproject.myapp.models import Author

admin.site.register(Author)                         #如果想要使用默认的，那么直接注册到即可！

`register`装饰器 `register`(models, site=django.admin.sites.site*)

可以使用一个装饰器来注册ModelAdmin类。

如果你使用的不是默认的AdminSite，那么这个装饰器可以接收一些ModelAdmin作为参数，以及一个可选的关键字参数 site。

注意的python2中不能使用装饰器，只能使用admin.site.register()。

admin文件

当你将 'django.contrib.admin'加入到INSTALLED_APPS 设置中, Django就会自动搜索每个应用的admin模块并将其导入。

class apps.AdminConfig: 这是 admin的默认AppConfig 类. 它在 Django 启动时调用autodiscover() .

class apps.SimpleAdminConfig: 这个类和 AdminConfig的作用一样,除了它不调用autodiscover().

autodiscover()

这个函数尝试导入每个安装的应用中的admin 模块。这些模块用于注册模型到Admin 中。

通常，当Django启动时，您将不需要直接调用此函数,AdminConfig会自动调用该函数。

如果您正在使用自定义 AdminSite，则通常会将所有ModelAdmin子类导入到代码中，并将其注册到自定义AdminSite。在这种情况下，为了禁用auto-discovery,在你的INSTALLED_APPS 设置中，应该用 'django.contrib.admin'代替'django.contrib.admin.apps.SimpleAdminConfig'

ModleAdmin选项

ModelAdmin 非常灵活。它有几个选项来处理自定义界面。所有的选项都在 ModelAdmin 子类中定义：

from django.contrib import admin

class AuthorAdmin(admin.ModelAdmin):

    date_hierarchy = 'pub_date'

ModelAdmin.actions：在修改列表页面可用的操作列表。

ModelAdmin.actions_on_top：

ModelAdmin.actions_on_bottom：控制actions的下拉框出现在页面的位置。默认情况下，管理员更改列表显示页面顶部的操作

ModelAdmin.actions_selection_counter：是否在actions下拉框右侧显示选中的对象的数量，默认为True，可改为False。

class ArticleAdmin(admin.ModelAdmin):

    actions_on_bottom = True

    actions_on_top = True

    actions_selection_counter = True

admin.site.register(models.Article, ArticleAdmin)

若三个选项定义如上，则界面展示如下：

django后台管理－ModelAdmin对象

ModelAdmin.date_hierarchy：把 date_hierarchy 设置为在你的model 中的DateField或DateTimeField的字段名，然后更改列表页面将包含这个字段基于日期的下拉导航。

date_hierarchy = "pub_date"

#可以使用“__”双下划线，查找外键对应的键值。

界面展示如下：

django后台管理－ModelAdmin对象

ModelAdmin.empty_value_display： django中空值显示默认为“----”的形式，这个参数指定空值怎么显示的。

ModelAdmin.exclude：如果设置了这个属性，它表示应该从表单中去掉的字段列表。
上面表Article的模型如下：

class Article(models.Model):

    title = models.CharField(max_length=50)

    body = models.CharField(max_length=300)

    key_word = models.CharField(max_length=20)

    editor = models.CharField(max_length=30, null=True)

    pub_date = models.DateField()

    def __unicode__(self):

        return self.title
#默认的情况下，这5个字段都会显示，使用exclude指定不显示的字段、

设置如下：

    exclude = ["body", "editor"]

则前端只会修改只会展示其余的三个页面：

django后台管理－ModelAdmin对象

下面说明两个选项:fields和list_display：

    fields = (("title", "body"), "editor")

    list_display = ["title", "body", "editor", "key_word"]

页面如下：

django后台管理－ModelAdmin对象

filedset选项：设置控制管理“添加”和“更改”页面的布局。
fieldsets是一个以二元元组为元素的列表，每一个二元元组代表一个在管理表单的fieldsets。
二元元组的格式是 (name, field_options), 其中 name 是一个字符串相当于 fieldset的标题， field_options 是一个关于 fieldset的字典信息,一个字段列表包含在里面。

fieldsets = (("author", {

        "fields": ["title", "editor"],

        "classes": {'wide', 'extrapretty'},

    }),

    ("content", {

        "fields": [("body", "key_word"), "pub_date"],

        "classes": {"'collapse',"},

    })

)

界面如下：【注意和之前的界面比较】

django后台管理－ModelAdmin对象

field_option字典有以下的关键字：
fields: 字段名元组将显示在该filedset，必选。元组与列表好像都可以。
classes：包含要应用于字段集的额外CSS类的列表或元组。
通过默认的管理站点样式表定义的两个有用的classes 是 collapse 和 wide. Fieldsets 使用 collapse 样式将会在初始化时展开并且替换掉一个 “click to expand” 链接. Fieldsets 使用 wide 样式将会有额外的水平空格.

description：添加一些额外的描述信息，【可以测试，显示在每个filedsets的顶部，即“body”位置上面】
以上的参数，只是默认的表单类型，可以modeform来创建自定义表单。

ModelAdmin.filter_horizontal：水平扩展多对多字段。默认情况下，ManyTOManyField在admin的页面中会显示为一个select框。在需要选择大量对象时，这会有点困难。将ManyTOManyField添加到这个属性列表里后，页面就会对字段进行扩展，并提供过滤功能。

ModelAdmin.filter_vertical：与filter_horizontal相同，但使用过滤器界面的垂直显示。注意这两个选项用于多对多的字段上。

ModelAdmin.form：
ModelAdmin.formfield_overrides：

【暂空】

ModelAdmin.list_display：使用list_display 去控制哪些字段会显示在Admin 的修改列表页面中。【上面的实例中用过一次】如果你没有设置list_display()，Admin 站点将只显示一列表示每个对象的__str__() （Python 2 中是__unicode__）。list_display有四种赋值方式如下：

第一种：模型字段，就像上面使用的那样，直接把需要展示的字段写入list_display的列表中即可。

第二种：一个接受对象实例作为参数的可调用对象。

有以下数据库：

class Person(models.Model):

    first_name = models.CharField(max_length=10)

    last_name = models.CharField(max_length=20)

然后直接在model.admin中注册：

admin.site.register(models.Person)

这样的，我们在前端界面看到如下的展示：

django后台管理－ModelAdmin对象

在数据库中定义了两个字段，我们希望的是把这两个字段合起来，展示为一个完整的名字。这时候就可以使用list_display.

class PersonAdmin(admin.ModelAdmin):

    list_display = ("upper_case_name",)

    def upper_case_name(self, obj):

        return "%s %s" % (obj.first_name, obj.last_name)

    upper_case_name.short_description = "Name"

admin.site.register(models.Person, PersonAdmin)

前端展示如下：

django后台管理－ModelAdmin对象

这样的展示，可能会更符合我们的直观需求

第三种：需求与第二种一样，不同的是写法如下：【一个接受对象实例的可调用对象】

def upper_case_name(obj):

    return ("%s %s" % (obj.first_name, obj.last_name)).upper()

upper_case_name.short_description = "NAME"

class PersonAdmin(admin.ModelAdmin):

    list_display = ["upper_case_name", ]

admin.site.register(models.Person, PersonAdmin)

第四种：支持自定义的字段类型，就是先对字段的值进行一些处理，然后把处理的结果，展示在web界面上。

#定义的模型如下

class Article(models.Model):

    title = models.CharField(max_length=50)

    body = models.CharField(max_length=300)

    key_word = models.CharField(max_length=20)

    editor = models.CharField(max_length=30, null=True)

    pub_date = models.DateField()

    def decade_date_in(self):

        return self.pub_date.strftime('%Y')[:3] + "0's"

    decade_date_in.short_description = "出版日期"

    def __unicode__(self):

        return self.title

#admin引用如下

class ArticleAdmin(admin.ModelAdmin):

    actions_on_top = True

    actions_selection_counter = True

    list_display = ["title", "key_word", "decade_date_in"]

admin.site.register(models.Article, ArticleAdmin)

前端界面：

django后台管理－ModelAdmin对象有关list_display的几个说明，如下：

如果字段是一个ForeignKey()，Django 将展示相关对象的__str__() （Python 2 上是__unicode__）。
不支持ManyToManyField 字段，因为这将意味着对表中的每一行执行单独的SQL 语句。如果尽管如此你仍然想要这样做，请给你的模型一个自定义的方法，并将该方法名称添加到 list_display。
如果一个字段返回的是布尔值，默认是显示True或False，如果给这个字段添加一个添加一个boolean的属性并赋值为True，那么django将会显示on/off图标。
如果给出的字符串是模型、ModelAdmin 的一个方法或可调用对象，Django 将默认转义HTML输出。要转义用户输入并允许自己的未转义标签，请使用format_html()。

一个实例：

#Person模型

class Person(models.Model):

    first_name = models.CharField(max_length=50)

    last_name = models.CharField(max_length=50)

    color_code = models.CharField(max_length=6)

    def colored_name(self):

        return (

            '<span style="color: #{};">{} {}</span>',

            self.color_code,

            self.first_name,

            self.last_name,

        )

#注册界面

class PersonAdmin(admin.ModelAdmin):

    list_display = ["first_name", "last_name", "colored_name"]

admin.site.register(models.Person, PersonAdmin)

前端展示如下：

django后台管理－ModelAdmin对象

使用format_html格式后，结果如下：

from django.utils.html import format_html

class Person(models.Model):

    first_name = models.CharField(max_length=50)

    last_name = models.CharField(max_length=50)

    color_code = models.CharField(max_length=6)

    def colored_name(self):

        return format_html(

            '<span style="color: #{};">{} {}</span>',

            self.color_code,

            self.first_name,

            self.last_name,

        )

前端改名如下：

django后台管理－ModelAdmin对象

通常情况下，在list_display列表里的元素如果不是数据库内的某个具体字段，是不能根据它进行排序的。但是如果给这个字段添加一个admin_order_field属性，并赋值一个具体的数据库内的字段，则可以按这个字段对原字段进行排序，如下所示：【实例摘自官方文档】

from django.db import models

from django.contrib import admin

from django.utils.html import format_html

class Person(models.Model):

    first_name = models.CharField(max_length=50)

    color_code = models.CharField(max_length=6)

    def colored_first_name(self):

        return format_html(

            '<span style="color: #{};">{}</span>',

            self.color_code,

            self.first_name,

        )

    colored_first_name.admin_order_field = 'first_name'

　　# colored_first_name.admin_order_field = '-first_name'    #在前面加上"-"，则表示降序排列


class PersonAdmin(admin.ModelAdmin):

    list_display = ('first_name', 'colored_first_name')

本来colored_first_name是不能排序的，给它的admin_order_field赋值first_name后，就依托first_name进行排序了。admin_order_field还支持按照模型跨表查询。

list_display里的元素还可以是某个属性。但是请注意的是，如果使用python的@property方式来构造一个属性，则不能给它添加short_description描述，只有使用property()函数的方法构造属性的时候，才可以添加short_description描述，如下：

class Person(models.Model):

    first_name = models.CharField(max_length=50)

    last_name = models.CharField(max_length=50)

    def my_property(self):

        return self.first_name + ' ' + self.last_name

    my_property.short_description = "Full name of the person"

    full_name = property(my_property)

class PersonAdmin(admin.ModelAdmin):

    list_display = ('full_name',)

ModelAdmin.list_display_links：默认情况下list_display中第一个显示的字段将连接到对应的修改界面，这个参数可以修改这个默认的设置。

将其设置为None，根本不会获得任何链接。
将其设置为要将其列转换为链接的字段列表或元组。这里设置的字段必须出现在list_display中，两个列表的字段个数可以不相等。

ModelAdmin.list_editable：这个字段可以直接编辑，如下：

class ArticleAdmin(admin.ModelAdmin):

    actions_on_top = True

    actions_selection_counter = True

    list_display = ["title", "key_word", "decade_date_in"]

    list_editable = ["key_word"]

#需要注意，list_editable中的元素必须出现在list_display中，但是不能是设置了list_display_links的元素。

前端展示：

django后台管理－ModelAdmin对象

ModelAdmin.list_filter：list_filter 设置激活激活Admin 修改列表页面右侧栏中的过滤器。list_filter必须是一个元组或列表，其元素是如下类型之一：

字段名称，其指定的字段应该是ManyToManyField、IntegerField、ForeignKey、DateField、CharField、BooleanField 或DateTimeField，例如︰

list_filter = ["pub_date"]

会在页面的右边显示以日期过条件的过滤器：

django后台管理－ModelAdmin对象

一个继承django.contrib.admin.SimpleListFilter的类。你要给这个类提供title和parameter_name的值，并重写lookups和queryset方法。【实例来自官方文档】

from datetime import date

from django.contrib import admin

from django.utils.translation import ugettext_lazy as _

class DecadeBornListFilter(admin.SimpleListFilter):

    # Human-readable title which will be displayed in the

    # right admin sidebar just above the filter options.

    title = _('decade born')

    # Parameter for the filter that will be used in the URL query.

    parameter_name = 'decade'

    def lookups(self, request, model_admin):

        """

        Returns a list of tuples. The first element in each

        tuple is the coded value for the option that will

        appear in the URL query. The second element is the

        human-readable name for the option that will appear

        in the right sidebar.

        """
　　     """  返回一个二维元组。每个元组的第一个元素是用于URL查询的真实值，  这个值会被self.value()方法获取，并作为queryset方法的选择条件。  
        第二个元素则是可读的显示在admin页面右边侧栏的过滤选项。  """

        return (

            ('80s', _('in the eighties')),

            ('90s', _('in the nineties')),

        )

    def queryset(self, request, queryset):

        """

        Returns the filtered queryset based on the value

        provided in the query string and retrievable via

        `self.value()`.

        """

　　     """

        根据self.value()方法获取的条件值的不同执行具体的查询操作。

        并返回相应的结果。

        """

        # Compare the requested value (either '80s' or '90s')

        # to decide how to filter the queryset.

        if self.value() == '80s':

            return queryset.filter(birthday__gte=date(1980, 1, 1),

                                    birthday__lte=date(1989, 12, 31))

        if self.value() == '90s':

            return queryset.filter(birthday__gte=date(1990, 1, 1),

                                    birthday__lte=date(1999, 12, 31))

class PersonAdmin(admin.ModelAdmin):

    list_filter = (DecadeBornListFilter,)

也可以是一个元组。它的第一个元素是个字段名，第二个元素则是继承了django.contrib.admin.FieldListFilter的类.【用的时候补充】

ModelAdmin.list_max_show_all：设置一个数值，当列表元素总数小于这个值的时候，将显示一个“show all”链接，点击后就能看到一个展示了所有元素的页面。该值默认为200.

ModelAdmin.list_per_page ：设置每页显示多少个元素。Django自动帮你分页。默认为100。

ModelAdmin.list_select_related：暂空

ModelAdmin.ordering：设置排序的方式。

属性的值必须为一个元组或列表，格式和模型的ordering参数一样。如果不设置这个属性，Django将按默认方式进行排序。如果你想进行动态排序，请自己实现get_ordering()方法。

ModelAdmin.paginator：

指定用于分页的分页器。默认情况下，分页器用的是Django自带的django.core.paginator.Paginator。如果自定义分页器的构造函数接口和django.core.paginator.Paginator的不一样，那你还需要自己实现ModelAdmin.get_paginator()方法。

ModelAdmin.prepopulated_fields：

设置预填充字段。不接收DateTimeField、ForeignKey和ManyToManyField类型的字段。

class ArticleAdmin(admin.ModelAdmin):

    prepopulated_fields = {"slug": ("title",)}

ModelAdmin.preserve_filters：

默认情况下，当你对目标进行创建、编辑或删除操作后，页面会依然保持原来的过滤状态。将preserve_filters设为False后，则会返回未过滤状态。

ModelAdmin.raw_id_fields：

这个属性会改变默认的ForeignKey和ManyToManyField的展示方式，它会变成一个输入框，用于输入关联对象的主键id。对于ManyToManyField，id以逗号分隔。并且再输入框右侧提供一个放大镜的图标，你可以点击进入选择界面。例如：

class UserAdmin(admin.ModelAdmin):

    raw_id_fields = ["article"]

django后台管理－ModelAdmin对象

ModelAdmin.readonly_fields

该属性包含的字段在页面内将展示为不可编辑状态。它还可以展示模型或者ModelAdmin本身的方法的返回值，类似ModelAdmin.list_display的行为

ModelAdmin.save_as

默认情况下，它的值为False。如果设置为True，那么右下角的“Save and add another”按钮将被替换成“Save as new”，意思也变成保存为一个新的对象。

ModelAdmin.save_as_continue

默认值为True, 在保存新对象后跳转到该对象的修改页面。但是如果这时save_as_continue=False，则会跳转到元素列表页面。

ModelAdmin.save_on_top

默认为False。设为True时，页面的顶部会提供同样的一系列保存按钮。

ModelAdmin.search_fields

设置这个属性，可以为admin的修改列表页面添加一个搜索框。

ModelAdmin.show_full_result_count

用于设置是否显示一个过滤后的对象总数的提示信息，例如“99 results (103 total)”。如果它被设置为False，那么显示的将是“ 99 results (Show all)”。默认情况下，它的值为True，这将会对整个表进行一个count操作，在表很大的时候，可能会耗费一定的时间和资源。

ModelAdmin.view_on_site

这个属性可以控制是否在admin页面显示“View site”的链接。这个链接主要用于跳转到你指定的URL页面。

django后台管理－ModelAdmin对象

属性的值可以是布尔值或某个调用。如果是True（默认值），对象的get_absolute_url()方法将被调用并生成rul。

如果你的模型有一个get_absolute_url()方法，但你不想显示“View site”链接，你只需要将view_on_site属性设置为False。

from django.contrib import admin

class PersonAdmin(admin.ModelAdmin):

    view_on_site = False

如果属性的值是一个调用，它将接收一个模型实例作为参数：

from django.contrib import admin

from django.urls import reverse

class PersonAdmin(admin.ModelAdmin):

    def view_on_site(self, obj):

        url = reverse('person-detail', kwargs={'slug': obj.slug})

        return 'https://example.com' + url

秒客网

django后台管理－ModelAdmin对象

ModelAdmin对象

`register`装饰器 `register`(models, site=django.admin.sites.site*)

admin文件

ModleAdmin选项

ModelAdmin.paginator：

ModelAdmin.prepopulated_fields：

ModelAdmin.preserve_filters：

ModelAdmin.raw_id_fields：

ModelAdmin.readonly_fields

ModelAdmin.save_as

ModelAdmin.save_as_continue

ModelAdmin.save_on_top

ModelAdmin.search_fields

ModelAdmin.show_full_result_count

ModelAdmin.view_on_site

相关文章

django后台管理－ModelAdmin对象

ModelAdmin对象

register装饰器 register(*models, site=django.admin.sites.site)

admin文件

ModleAdmin选项

ModelAdmin.paginator：

ModelAdmin.prepopulated_fields：

ModelAdmin.preserve_filters：

ModelAdmin.raw_id_fields：

ModelAdmin.readonly_fields

ModelAdmin.save_as

ModelAdmin.save_as_continue

ModelAdmin.save_on_top

ModelAdmin.search_fields

ModelAdmin.show_full_result_count

ModelAdmin.view_on_site

相关文章

`register`装饰器 `register`(models, site=django.admin.sites.site*)