其他分享
首页 > 其他分享> > django后台管理－ModelAdmin对象

django后台管理－ModelAdmin对象

作者：互联网

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

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

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

/admin/），将能够使用你的Django管理后台站点。 如果你需要创建一个登录用户，可以使用createsuperuser命令。

ModelAdmin对象

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

 django.contrib  myproject.myapp.models  django.contrib  myproject.myapp.models

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

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

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

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

admin文件

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

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

ModleAdmin选项

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

from django.contrib import adminclass AuthorAdmin(admin.ModelAdmin):
    date_hierarchy = 'pub_date'

ModelAdmin.actions_on_top：

class ArticleAdmin(admin.ModelAdmin):
    actions_on_bottom = True
    actions_on_top = True
    actions_selection_counter = True


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

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

date_hierarchy =

界面展示如下：

= models.CharField(max_length=50= models.CharField(max_length=300= models.CharField(max_length=20= models.CharField(max_length=30, null==  self.title
#默认的情况下，这5个字段都会显示，、
    exclude = ["body", "editor"]

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

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

    fields = (("title", "body"), "editor")
    list_display = ["title", "body", "editor", "key_word"]

页面如下：

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',"},
    })
)

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

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添加到这个属性列表里后，页面就会对字段进行扩展，并提供过滤功能。

【暂空】

第一种：模型字段，就像上面使用的那样，直接把需要展示的字段写入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)

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

在数据库中定义了两个字段，我们希望的是把这两个字段合起来，展示为一个完整的名字。这时候就可以使用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)

前端展示如下：

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

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

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)

前端界面：

有关list_display的几个说明，如下：

一个实例：

#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 (            '{} {}',
            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)

前端展示如下：

 

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

from django.utils.html import format_htmlclass 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(            '{} {}',
            self.color_code,
            self.first_name,
            self.last_name,
        )

前端改名如下：

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

=== [, , = []

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

前端展示：

list_filter = ["pub_date"]

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

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"]

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页面。

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

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

from django.contrib import adminclass PersonAdmin(admin.ModelAdmin):
    view_on_site = False

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

from django.contrib import adminfrom django.urls import reverseclass PersonAdmin(admin.ModelAdmin):    def view_on_site(self, obj):
        url = reverse('person-detail', kwargs={'slug': obj.slug})        return 'https://example.com' + url

 

标签：name,admin,list,django,models,后台,ModelAdmin
来源： https://blog.51cto.com/lovejxs/2726606