第二十课 Django Admin后台管理

矫情吗；* 2022-12-29 01:50 190阅读 0赞

##  第二十课 Admin后台管理 ##

### 1. admin创建用户 ###

创建管理员账号:

python manage.py createsuperuser
    
    # 按提示输入用户名、邮箱、密码

### 2. 注册模型 ###

如果只是在admin中简单的展示及管理模型，需要在`admin.py`模块中使用admin.site.register将模型注册：

from django.contrib import admin
    
    from myproject.myapp.models import Author
    
    
    
    admin.site.register(Author)

但是，有时候我们需要对admin进行各种深度定制，以满足我们的需求。这就要使用Django为我们提供的ModelAdmin类了，例子：

from django.contrib import admin
    
    from myproject.myapp.models import Author
    
    
    
    # 创建一个ModelAdmin的子类
    
    class AuthorAdmin(admin.ModelAdmin):
    
        pass
    
    
    
    # 注册的时候，将原模型和ModelAdmin耦合起来
    
    admin.site.register(Author, AuthorAdmin)

### 3. 用装饰器注册注册模型 ###

除了常用的`admin.site.register(Author,AuthorAdmin)`方式进行注册，还可以用装饰器的方式连接模型和ModelAdmin。例如：

from django.contrib import admin
    
    from .models import Author
    
    
    
    @admin.register(Author)
    
    class AuthorAdmin(admin.ModelAdmin):
    
        pass

这个装饰器可以接收一些模型类作为参数，以及一个可选的关键字参数site，例如：

from django.contrib import admin
    
    from .models import Author, Reader, Editor
    
    from myproject.admin_site import custom_admin_site
    
    
    
    @admin.register(Author, Reader, Editor, site=custom_admin_site)
    
    class PersonAdmin(admin.ModelAdmin):
    
        pass

### 4. ModelAdmin的属性 ###

ModelAdmin非常灵活，它有许多内置属性，帮助我们自定义admin的界面和功能

**（1）ModelAdmin.actions**

一个列表，包含自定义的actions

**（2）ModelAdmin.actions\_on\_top**

是否在列表上方显示actions的下拉框，默认为True

**（3）ModelAdmin.actions\_on\_bottom**

是否在列表下方显示actions的下拉框，默认为False。效果见下面的图片

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-4e8xBdnl-1608304247316)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091152267-1732573258.png)\]

**（4）ModelAdmin.actions\_selection\_counter**

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

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-QcM1eQ98-1608304247318)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091201243-284760212.png)\]

**（5）ModelAdmin.date\_hierarchy**

根据你指定的日期相关的字段，为页面创建一个时间导航栏，可通过日期过滤对象。例如：

date_hierarchy = 'pub_date'

它的效果如图：

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-JdmjRu7N-1608304247319)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091206305-1467394714.png)\]

也可以指定为关联的日期字段：

date_hierarchy = 'author__pub_date'

**（6）ModelAdmin.empty\_value\_display**

指定空白显示的内容。如果有些字段没有值，默认情况下会显示破折号“-”。这个选项可以让你自定义显示什么，例如：

from django.contrib import admin
    
    
    
    class AuthorAdmin(admin.ModelAdmin):
    
        empty_value_display = '-empty-'

还可以为整个admin站点设置默认空白显示值，通过设置`AdminSite.empty_value_display="xxxxxxx"`。甚至为某个函数设置空白值，如下：

from django.contrib import admin
    
    
    
    class AuthorAdmin(admin.ModelAdmin):
    
        fields = ('name', 'title', 'view_birth_date')
    
    
    
        def view_birth_date(self, obj):
    
            return obj.birth_date
    
        # 注意下面这句
    
        view_birth_date.empty_value_display = '???'

**（7）ModelAdmin.exclude**

不显示指定的某些字段

如下例有这么个模型：

from django.db import models
    
    
    
    class Author(models.Model):
    
        name = models.CharField(max_length=100)
    
        title = models.CharField(max_length=3)
    
        birth_date = models.DateField(blank=True, null=True)

如果你不希望在页面内显示`birth_date`字段，那么这么设置：

from django.contrib import admin
    
    
    
    class AuthorAdmin(admin.ModelAdmin):
    
        fields = ('name', 'title')

和这么设置是一样的：

from django.contrib import admin
    
    
    
    class AuthorAdmin(admin.ModelAdmin):
    
        exclude = ('birth_date',)

**（8）ModelAdmin.fields**

按顺序显示指定的字段

可以通过组合元组的方式，让某些字段在同一行内显示。例如下面的做法“url”和“title”将在一行内，而“content”则在下一行：

class FlatPageAdmin(admin.ModelAdmin):
    
        fields = (('url', 'title'), 'content')

如果没有对field或fieldsets选项进行定义，那么Django将按照模型定义中的顺序，每一行显示一个字段的方式，逐个显示所有的非AutoField和editable=True的字段

**（9）ModelAdmin.fieldsets**

根据字段对页面进行分组显示或布局，fieldsets是一个二元元组的列表。每个二元元组代表一个`<fieldset>`

二元元组的格式为`(name,field_options)`，name是一个表示该filedset标题的字符串，`field_options`是一个包含在该filedset内的字段列表。例如：

from django.contrib import admin
    
    
    
    class FlatPageAdmin(admin.ModelAdmin):
    
        fieldsets = (
    
            (None, { 
    
                'fields': ('url', 'title', 'content', 'sites')
    
            }),
    
            ('Advanced options', { 
    
                'classes': ('collapse',),
    
                'fields': ('registration_required', 'template_name'),
    
            }),
    
        )

它的页面看起来像下面的样子：

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-j8BhVJPf-1608304247321)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091218653-1760961744.png)\]

在`filed_options`字典内，可以使用下面这些关键字：

**fields**：一个必填的元组，包含要在fieldset中显示的字段。例如：

{ 
    
    'fields': ('first_name', 'last_name', 'address', 'city', 'state'),
    
    }

同样，它也可以像前面那样通过组合元组，实现多个字段在一行内的效果：

{ 
    
    'fields': (('first_name', 'last_name'), 'address', 'city', 'state'),
    
    }

fileds可以包含`readonly_fields`的值，作为只读字段。

**classes**：一个包含额外的CSS类的元组，例如：

{ 
    
    'classes': ('wide', 'extrapretty'),
    
    }

两个比较有用的样式是`collaspe`和`wide`，前者将fieldsets折叠起来，后者让它具备更宽的水平空间。

**description**：一个可选的额外的说明文本，放置在每个fieldset的顶部。但是，这里并没有对description的HTML语法进行转义，因此可能有时候会造成一些莫名其妙的显示，要忽略HTML的影响，请使用`django.utils.html.escape()`手动转义。

**（10）ModelAdmin.filter\_horizontal**

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

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fwOPoIfe-1608304247322)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091245944-1034707632.png)\]

**（11）ModelAdmin.filter\_vertical**

与上面的类似，不过是改成垂直布置了

**（12）ModelAdmin.form**

默认情况下，admin系统会为你的模型动态的创建ModelForm，它用于创建你的`添加/修改`页面的表单。我们可以编写自定义的ModelForm，在`添加/修改`页面覆盖默认的表单行为。

**注意：如果你的ModelForm和ModelAdmin同时定义了exclude选项，那么ModelAdmin中的具有优先权**，例如，下面的"age"字段将被排除，但是“name”字段将被显示：

from django import forms
    
    from django.contrib import admin
    
    from myapp.models import Person
    
    
    
    class PersonForm(forms.ModelForm):
    
        class Meta:
    
            model = Person
    
            exclude = ['name']
    
    
    
    class PersonAdmin(admin.ModelAdmin):
    
        exclude = ['age']
    
        form = PersonForm

**（13）ModelAdmin.formfield\_overrides**

代替传统的`<textarea>`，用于输入大段文字，例如：

from django.db import models
    
    from django.contrib import admin
    
    
    
    # 从对应的目录导入我们先前写好的widget和model
    
    from myapp.widgets import RichTextEditorWidget
    
    from myapp.models import MyModel
    
    
    
    class MyModelAdmin(admin.ModelAdmin):
    
        formfield_overrides = { 
    
            models.TextField: { 'widget': RichTextEditorWidget},
    
        }

注意：在上面的外层字典中的键是一个实际的字段类，而不是字符串，对应的值又是一个字典；这些参数将被传递给form字段的`__init__()`方法

**（14）ModelAdmin.inlines**

参考InlineModelAdmin对象，就像`ModelAdmin.get_formsets_with_inlines()`一样

**（15）ModelAdmin.list\_display**

指定显示在修改页面上的字段。这是一个很常用也是最重要的技巧之一。例如：

list_display = ('first_name', 'last_name')

如果你不设置这个属性，admin站点将只显示一列，内容是每个对象的`__str__()`方法返回的内容。

在list\_display中，你可以设置四种值：

*  \*\*模型的字段名 \*\*

class PersonAdmin(admin.ModelAdmin):
    
        list_display = ('first_name', 'last_name')

*  \*\*一个函数，它接收一个模型实例作为参数 \*\*

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,)

*  **一个表示ModelAdmin的某个属性的字符串**

类似上面的函数调用，通过反射获取函数名，换了种写法而已，例如：

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()
    
        upper_case_name.short_description = 'Name'

*  **一个表示模型的某个属性的字符串**

类似第二种，但是此处的self是模型实例，引用的是模型的属性。参考下面的例子：

from django.db import models
    
    from django.contrib import admin
    
    
    
    class Person(models.Model):
    
        name = models.CharField(max_length=50)
    
        birthday = models.DateField()
    
    
    
        def decade_born_in(self):
    
            return self.birthday.strftime('%Y')[:3] + "0's"
    
        decade_born_in.short_description = 'Birth decade'
    
    
    
    class PersonAdmin(admin.ModelAdmin):
    
        list_display = ('name', 'decade_born_in')

**下面是一个完整的例子：**

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)
 
 last_name = models.CharField(max_length=50)
 
 color_code = models.CharField(max_length=6)
 
 
 
 def colored_name(self):
 
 return '%s %s'%(
 
 self.color_code,
 
 self.first_name,
 
 self.last_name,
 
 )
 
 
 
 class PersonAdmin(admin.ModelAdmin):
 
 list_display = ('first_name', 'last_name', 'colored_name')

实际的效果如下图所示：

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-MHad8vll-1608304247323)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091259160-1450506483.png)\]

很明显，你是想要有个CSS效果，但Django把它当普通的字符串了。怎么办呢？用`format_html()`或者`format_html_join()`或者`mark_safe()`方法！

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)
 
 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,
 
 )
 
 
 
 class PersonAdmin(admin.ModelAdmin):
 
 list_display = ('first_name', 'last_name', 'colored_name')

下面看起来就会是你想要的结果了：

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-mGc0HfH6-1608304247324)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091304739-1198236764.png)\]

*  如果某个字段的值为None或空字符串或空的可迭代对象，那么默认显示为短横杠“-”，你可以使用`AdminSite.empty_value_display`在全局改写这一行为：

from django.contrib import admin
    
    
    
    admin.site.empty_value_display = '(None)'

或者使用`ModelAdmin.empty_value_display`只改变某个类的行为：

class PersonAdmin(admin.ModelAdmin):
    
        empty_value_display = 'unknown'

或者更细粒度的只改变某个字段的这一行为：

class PersonAdmin(admin.ModelAdmin):
    
        list_display = ('name', 'birth_date_view')
    
    
    
        def birth_date_view(self, obj):
    
             return obj.birth_date
    
    
    
        birth_date_view.empty_value_display = 'unknown'

*  默认情况下，一个返回布尔值的方法在list\_display中显示为True或者False的：

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-bSXv76j4-1608304247325)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091313357-1469253605.png)\]

但如果你给这个方法添加一个boolean的属性并赋值为True，它将显示为on/off的图标，如下图：

from django.db import models
    
    from django.contrib import admin
    
    
    
    class Person(models.Model):
    
        first_name = models.CharField(max_length=50)
    
        birthday = models.DateField()
    
    
    
        def born_in_fifties(self):
    
            return self.birthday.strftime('%Y')[:3] == '195'
    
        # 关键在这里
    
        born_in_fifties.boolean = True
    
    
    
    class PersonAdmin(admin.ModelAdmin):
    
        # 官方文档这里有错，将'name'改为'first_name' 
    
        list_display = ('first_name', 'born_in_fifties')

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Na5Mub3P-1608304247326)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091320738-731208550.png)\]

*  通常情况下，在`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(
 
 '{}',
 
 self.color_code,
 
 self.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`进行排序了。

要降序的话，使用连字符“-”前缀：

colored_first_name.admin_order_field = '-first_name'

还可以跨表跨关系引用：

class Blog(models.Model):
    
        title = models.CharField(max_length=255)
    
        author = models.ForeignKey(Person, on_delete=models.CASCADE)
    
    
    
    class BlogAdmin(admin.ModelAdmin):
    
        list_display = ('title', 'author', 'author_first_name')
    
    
    
        def author_first_name(self, obj):
    
            return obj.author.first_name
    
        # 指定了另一张表的first_name作为排序的依据
    
        author_first_name.admin_order_field = 'author__first_name'

*  `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',)

* `list_display`中的每个字段名在HTML中都将自动生成CSS类属性，在`th`标签中以`column-<field_name>`的格式，你可以通过它，对前端进行自定义或调整，例如设置宽度等等

**（16）ModelAdmin.list\_display\_links**

指定用于链接修改页面的字段。通常情况，`list_display`列表中的第一个元素被作为指向目标修改页面的超级链接点。但是，使用`list_display_links`可以帮你修改这一默认配置

*  如果设置为None，则根本没有链接了，你无法跳到目标的修改页面
 *  或者设置为一个字段的元组或列表，每一个元素都是一个指向修改页面的链接。但是要使用`list_display_links`，必须先有`list_display`

下面这个例子中`first_name`和`last_name`都可以点击并跳转到修改页面。

class PersonAdmin(admin.ModelAdmin):
    
        list_display = ('first_name', 'last_name', 'birthday')
    
        list_display_links = ('first_name', 'last_name')

而如果这样，你将没有任何链接：

class AuditEntryAdmin(admin.ModelAdmin):
    
        list_display = ('timestamp', 'message')
    
        list_display_links = None

**（17）ModelAdmin.list\_editable**

指定在修改列表页面中哪些字段可以被编辑。指定的字段将显示为编辑框，可修改后直接批量保存，如下图：

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-VNz1VBTT-1608304247326)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091333391-1113975110.png)\]

**（18）ModelAdmin.list\_filter**

设置`list_filter`属性后，可以激活`修改列表页面`的右侧边栏，用于对列表元素进行过滤，如下图：

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-eMjctotU-1608304247327)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091340829-862747392.png)\]

`list_filter`必须是一个元组或列表，其元素是如下类型之一：

*  某个字段名，但该字段必须是BooleanField、CharField、DateField、DateTimeField、IntegerField、ForeignKey或者ManyToManyField中的一种。例如：

class PersonAdmin(admin.ModelAdmin):
    
        list_filter = ('is_staff', 'company')

在这里，你可以利用双下划线进行跨表关联，如下例：

class PersonAdmin(admin.UserAdmin):
    
        list_filter = ('company__name',)

*  一个继承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):
    
        # 提供一个可读的标题
    
        title = _('出生年代')
    
    
    
        # 用于URL查询的参数.
    
        parameter_name = 'decade'
    
    
    
        def lookups(self, request, model_admin):
    
            """ 返回一个二维元组。每个元组的第一个元素是用于URL查询的真实值， 这个值会被self.value()方法获取，并作为queryset方法的选择条件。 第二个元素则是可读的显示在admin页面右边侧栏的过滤选项。 """
    
            return (
    
                ('80s', _('80年代')),
    
                ('90s', _('90年代')),
    
            )
    
    
    
        def queryset(self, request, queryset):
    
            """ 根据self.value()方法获取的条件值的不同执行具体的查询操作。 并返回相应的结果。 """
    
            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_display = ('first_name', 'last_name', "colored_first_name",'birthday')
    
    
    
        list_filter = (DecadeBornListFilter,)

其效果如下图：

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-l3dzJtr2-1608304247328)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091349396-177806276.png)\]

注意：为了方便，我们通常会将HttpRequest对象传递给lookups和queryset方法，如下所示：

class AuthDecadeBornListFilter(DecadeBornListFilter):
    
    
    
        def lookups(self, request, model_admin):
    
            if request.user.is_superuser:
    
                return super(AuthDecadeBornListFilter, self).lookups(request, model_admin)
    
    
    
        def queryset(self, request, queryset):
    
            if request.user.is_superuser:
    
                return super(AuthDecadeBornListFilter, self).queryset(request, queryset)

同样的，我们默认将ModelAdmin对象传递给lookups方法。下面的例子根据查询结果，调整过滤选项，如果某个年代没有符合的对象，则这个选项不会在右边的过滤栏中显示：

class AdvancedDecadeBornListFilter(DecadeBornListFilter):
    
    
    
        def lookups(self, request, model_admin):
    
            """ 只有存在确切的对象，并且它出生在对应年代时，才会出现这个过滤选项。 """
    
            qs = model_admin.get_queryset(request)
    
            if qs.filter(birthday__gte=date(1980, 1, 1),
    
                          birthday__lte=date(1989, 12, 31)).exists():
    
                yield ('80s', _('in the eighties'))
    
            if qs.filter(birthday__gte=date(1990, 1, 1),
    
                          birthday__lte=date(1999, 12, 31)).exists():
    
                yield ('90s', _('in the nineties'))

*  也可以是一个元组。它的第一个元素是个字段名，第二个元素则是继承了`django.contrib.admin.FieldListFilter`的类。例如：

class PersonAdmin(admin.ModelAdmin):
    
        list_filter = (
    
            ('is_staff', admin.BooleanFieldListFilter),
    
        )

你可以使用`RelatedOnlyFieldListFilter`限制关联的对象。假设author是关联User模型的ForeignKey，下面的用法将只选择那些出过书的user而不是所有的user：

class BookAdmin(admin.ModelAdmin):
    
        list_filter = (
    
            ('author', admin.RelatedOnlyFieldListFilter),
    
        )

另外，其template属性可以指定渲染的模板，如下则指定了一个自定义的模板。（Django默认的模板为admin/filter.html）

class FilterWithCustomTemplate(admin.SimpleListFilter):
    
        template = "custom_template.html"

**（19）ModelAdmin.list\_max\_show\_all**

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

**（20）ModelAdmin.list\_per\_page**

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

**（21）ModelAdmin.list\_select\_related**

如果设置了`list_select_related`属性，Django将会使用`select_related()`方法查询数据，这可能会帮助你减少一些数据库访问

属性的值可以是布尔值、元组或列表，默认为False。当值为True时，将始终调用`select_related()`方法；如果值为False，Django将查看`list_display`属性，只对ForeignKey字段调用`select_related()`方法。例如：

class ArticleAdmin(admin.ModelAdmin):
    
        list_select_related = ('author', 'category')

**（22）ModelAdmin.ordering**

设置排序的方式

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

**（23）ModelAdmin.paginator**

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

**（24）ModelAdmin.prepopulated\_fields**

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

class ArticleAdmin(admin.ModelAdmin):
    
        prepopulated_fields = { "slug": ("title",)}

**（25）ModelAdmin.preserve\_filters**

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

**（26）ModelAdmin.radio\_fields**

默认情况下，Django使用select标签显示ForeignKey或choices集合。如果将这种字段设置为`radio_fields`，则会以`radio_box`标签的形式展示。下面的例子假设group是Person模型的ForeignKey字段

class PersonAdmin(admin.ModelAdmin):
    
        # 垂直布局。（肯定也有水平布局HORIZONTAL的啦）
    
        radio_fields = { "group": admin.VERTICAL}

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-CSRFs7V8-1608304247328)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091403227-174783789.png)\]

**（27）ModelAdmin.raw\_id\_fields**

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

class PersonAdmin(admin.ModelAdmin):
    
        raw_id_fields = ("group",)

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-nULmp4Zb-1608304247329)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091407928-780759103.png)\]

**（28）ModelAdmin.readonly\_fields**

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

from django.contrib import admin
 
 from django.utils.html import format_html_join
 
 from django.utils.safestring import mark_safe
 
 
 
 class PersonAdmin(admin.ModelAdmin):
 
 readonly_fields = ('address_report',)
 
 
 
 def address_report(self, instance):
 
 # assuming get_full_address() returns a list of strings
 
 # for each line of the address and you want to separate each
 
 # line by a linebreak
 
 return format_html_join(
 
 mark_safe(' '),
 
 '{}',
 
 ((line,) for line in instance.get_full_address()),
 
 ) or mark_safe("I can't determine this address.")
 
 
 
 # short_description functions like a model field's verbose_name
 
 address_report.short_description = "Address"

**（29）ModelAdmin.save\_as**

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

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-bk2ECbXS-1608304247329)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091414760-902022906.png)\]

**（30）ModelAdmin.save\_as\_continue**

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

**（31）ModelAdmin.save\_on\_top**

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

**（32）ModelAdmin.search\_fields**

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

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-lkzE5Ne2-1608304247329)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091420591-1475213139.png)\]

被搜索的字段可以是CharField或者TextField文本类型，也可以通过双下划线进行ForeignKey或者ManyToManyField的查询，格式为`search_fields = ['foreign_key__related_fieldname']`.

例如：如果作者是博客的ForeignKey字段，下面的方式将通过作者的email地址来查询对应的博客，也就是email地址是查询值的作者所写的所有博客。

search_fields = ['user__email']

当你在搜索框里输入一些文本的时候，Django会将文本分割成一个一个的关键字，并返回所有包含这些关键字的对象，必须注意的是，每个关键词至少得是`search_fields`其中之一。例如，如果`search_fields`是`['first_name', 'last_name']`，当用户输入`John lennon`时（注意中间的空格），Django将执行等同于下面的SQL语法WHERE子句：

WHERE (first_name ILIKE '%john%' OR last_name ILIKE '%john%') AND (first_name ILIKE '%lennon%' OR last_name ILIKE '%lennon%')

如果要执行更加严格的匹配或搜索，可以使用一些元字符，例如“^”。类似正则，它代表从开头匹配。例如，如果`search_fields`是`['^first_name','^last_name']`,当用户输入“John lennon”时（注意中间的空格），Django将执行等同于下面的SQL语法WHERE子句：

WHERE (first_name ILIKE 'john%' OR last_name ILIKE 'john%') AND (first_name ILIKE 'lennon%' OR last_name ILIKE 'lennon%')

也可以使用“=”，来进行区分大小写的并绝对相等的严格匹配。例如，如果`search_fields`是`['=first_name','=last_name']`,当用户输入“John lennon”时（注意中间的空格），Django将执行等同于下面的SQL语法WHERE子句：

WHERE (first_name ILIKE 'john' OR last_name ILIKE 'john') AND (first_name ILIKE 'lennon' OR last_name ILIKE 'lennon')

**（33）ModelAdmin.show\_full\_result\_count**

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

**（34）ModelAdmin.view\_on\_site**

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

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ucxLIPZ7-1608304247330)(/home/pyvip/py\_case/python 笔记/图片/1762677-20201006091428506-1595310635.png)\]

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

如果你的模型有一个`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

**（35）ModelAdmin.sortable\_by**

默认情况下，“更改列表”页面允许按 `list_display`中指定的所有模型字段进行排序。

如果要对某些列禁用排序功能，可以将`sortable_by`设置为要排序的`list_display`子集的集合（例如list、tuple或set）。空集合将禁用所有列的排序。

如果需要动态指定此列表，请改为实现`get_sortable_by()`方法

### 5. 常用的ModelAdmin属性 ###

列表页属性

*  list\_display：显示字段，可以点击列头进行排序
 *  list\_filter：过滤字段，过滤框会出现在右侧
 *  search\_fields：搜索字段，搜索框会出现在上侧
 *  list\_per\_page：分页，分页框会出现在下侧

添加、修改页属性，两个属性，二者选一

*  fields：属性的先后顺序
 *  fieldsets：属性分组

from django.contrib import admin
    
    from .models import *
    
    
    
    # Register your models here.
    
    
    
    class BlogAdimin(admin.ModelAdmin):
    
        # 列表页
    
        list_display = ['title', 'author', 'content', 'cre_time'] # 在页面展示模型字段
    
        list_display_links = ['title', 'author'] # 点击可以跳转的字段
    
        search_fields = ['title', 'author', 'cre_time'] # 设置搜索框，定义可以搜索的字段
    
        list_filter = ['title', 'author', 'content', 'cre_time'] # 过滤器
    
        list_per_page = 10 # 设置分页
    
    
    
        # 详情页
    
        fields = ['title', 'author', 'content']
    
    
    
    admin.site.register(Blog, BlogAdimin)