Django的admin后台

ModelAdmin对象

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)

使用装饰器的形式：

from django.contrib import admin
from myapp.models import User

@admin.register(User, )
class UserAdmin(admin.ModelAdmin):
    pass

ModelAdmin中的属性

ModelAdmin是非常灵活的。它具有几个用于定制界面的选项。所有选项都在ModelAdmin 子类上定义：

actions

作用：用于批量操作, django默认只有批量删除操作，如果想要新增使用actions代码如下：

from django.contrib import admin
from myapp.models import User


class UserAdmin(admin.ModelAdmin):
    actions = ['make_published']
    
    def make_published(self, request, queryset):
        queryset.update(status='p')
    make_published.short_description = "Mark selected stories as published"
admin.site.register(User, UserAdmin)

actions_on_bottom

作用：控制操作栏在页面上的显示位置。默认情况下，管理员更改列表在页面的顶部显示操作。

# 顶部显示
class UserAdmin(admin.ModelAdmin):
    actions_on_top = True
    actions_on_bottom = False

# 底部显示
class UserAdmin(admin.ModelAdmin):
    actions_on_top = False
    actions_on_bottom = True

actions_selection_counter

作用： 控制是否在操作下拉菜单旁边显示选择计数器。默认情况下显示它

class UserAdmin(admin.ModelAdmin):
    actions_selection_counter = False  # 不显示

date_hierarchy

作用： 设置date_hierarchy为 模型中的DateFiel 或 DateTimeField 名称 。效果如图

date_hierarchy = 'pub_date'

# 也可以通过'__'跨表取
date_hierarchy = 'author__pub_date'

empty_value_display

作用： 此属性将在现实页面覆盖记录字段为空（None，空字符串等）的默认显示值。默认值为-（破折号）

empty_value_display = '?????????'

指定覆盖某个字段

from django.contrib import admin

class AuthorAdmin(admin.ModelAdmin):
    fields = ('name', 'title', 'view_birth_date')

    def view_birth_date(self, obj):  # 自定义的字段，obj为当前model对象
        return obj.birth_date

    view_birth_date.empty_value_display = '???'  # 指定覆盖该字段空值

exclude

作用： 如果提供此属性，则应为要从表单中排除的字段名称列表。

class AuthorAdmin(admin.ModelAdmin):
    exclude = ['age']  # 不能和fields同用

fields

作用：详细页面需要显示的字段列表

class AuthorAdmin(admin.ModelAdmin):
    exclude = ['name'] 

分组显示，分组中的字段在一行显示

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

fieldsets

作用： 设置fieldsets以控制管理员“添加”和“更改”页面的布局 。

fieldsets是由一个二元的元组组成，每个元组中都有两个参数，((name, field_options), )。其中，name是代表字段集标题的字符串，如果不设置名字则填None, field_options是有关字段集的信息词典，包括要在其中显示的字段的列表。

示例如下：

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

该field_options词典可以具有以下键：

fields：要在此字段集中显示的字段名称的元组。此键值是必需的。

classes： 包含要应用于该字段集的额外CSS类的列表或元组。

举例说明：

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

默认管理网站样式表定义的两个有用的类是 collapse和wide。

• collapse样式的字段集将首先在管理员中折叠，需要设置一个字段集的标题，并替换为一个小的“单击以展开”链接(Show/Hide)。

• wide样式的字段集将获得额外的水平空间，即字段名和值之间空间会增大。

description： 一串可选的额外文本，将显示在每个字段集顶部。

filter_horizontal

作用：只针对于多对多显示样式的修改

默认状态：

应用filter_horizontal之后：

class UserAdmin(admin.ModelAdmin):
    filter_horizontal = ('roles', )  # roles是多对多字段

filter_vertical

作用：只针对于多对多显示样式的修改

应用filter_vertical之后：

class UserAdmin(admin.ModelAdmin):
    filter_vertical = ('roles', )  # roles是多对多字段

form

作用：自定义创建form

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
# 注意：如果ModelAdmin和ModelForm均定义exclude，优先ModelAdmin，即name仍会显示

formfield_overrides

作用： 这个属性比较难以理解，通过一个列子来解释可能会更好一点。设想一下我们自己写了个RichTextEditorWidget（富文本控件），然后想用它来代替传统的``（文本域控件）用于输入大段文字。我们可以这么做：

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__()方法。

警告：如果你想使用一个带有关系字段的自定义widget。请确保你没有在raw_id_fields或radio_fields之中include那些字段的名字。

list_display

作用： 控制在管理员的更改列表页面上显示哪些字段 。

class UserAdmin(admin.ModelAdmin):
    list_display = ('name', 'age', 'roles', ) 

还可显示自定义的字段信息

class UserAdmin(admin.ModelAdmin):
    list_display = ('upper_case_name', ) 
    
    def upper_case_name(self, obj):
        return ("%s %s" % (obj.first_name, obj.last_name)).upper()
    
    # short_description functions like a model field's verbose_name
    upper_case_name.short_description = 'Name'   # 为新字段的显示名字

list_display_links

作用：可点击进入详情页面的字段，None为没有链接。但是直接访问url依然可以进入详情页。

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

list_editable

作用： 该列表将允许在展示列表页面上进行编辑。

class UserAdmin(admin.ModelAdmin):
   list_display = ('name', 'age', 'roles', ) 
   list_editable = ('age', )  # list_editable中的字段必须在list_display中

list_filter

作用： 管理员更改列表页面右侧栏中的过滤器

class PersonAdmin(admin.ModelAdmin):
    list_filter = ('name', 'age')

list_filter也可以使用__查找来跨越关系

class PersonAdmin(admin.ModelAdmin):
    list_filter = ('name', 'age', 'company__name')

paginator

作用： 用于分页的分页器类。默认情况下， 使用 django.core.paginator.Paginator

class UserAdmin(admin.ModelAdmin):
    paginator = 自定义的分页类
# 自定义分页器，还需要实现一个get_paginator()

list_max_show_all

作用： 设置一个值，仅当总结果计数小于或等于此设置时，管理员才会在更改列表上显示“ show all ”链接。默认情况下，此设置为200

class PersonAdmin(admin.ModelAdmin):
    list_max_show_all = 10

list_per_page

作用：每页显示多少条数据。默认100

class PersonAdmin(admin.ModelAdmin):
    list_per_page = 10

list_select_related

作用： 设置list_select_related为告诉Django在管理更改列表页面上检索对象列表时使用 select_related()

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

ordering

作用： 在Django管理视图中对对象列表进行排序

class UserAdmin(admin.ModelAdmin):
    ordering = ('-id', )  # 加‘-’号，按照降序排列

preserve_filters

作用： 详细页面，删除、修改，更新后跳转回列表后，是否保留原搜索条件 。

class UserAdmin(admin.ModelAdmin):
    preserve_filters = False

radio_fields

作用： Django默认将下拉选择框界面用于ForeignKey或者choices字段。如果radio_fields中存在字段，则Django将改为使用单选按钮界面 。

class UserAdmin(admin.ModelAdmin):
    radio_fields = {'gender': admin.HORIZONTAL}
# 您可以选择使用HORIZONTAL还是VERTICAL从 django.contrib.admin模块中选择。
# HORIZONTAL横向排列
# VERTICAL竖向排列

autocomplete_fields

作用：针对多对多和一对多关系， 会将外键数据全部加载出来，渲染到select表中，如果数据量比较大，就会很慢，使用autocomplete_fields只会展示几条数据，在最上侧会出现一个搜索框，可以使用搜索框查询未显示的数据。既然有搜索，那么就需要定义搜索属性search_fields，示例如下

class UserAdmin(admin.ModelAdmin):
    autocomplete_fields = ('company', )  # 外键
    
class CompanyAdmin(admin.ModelAdmin):
    search_fields = ('title', )  # 对应的表数据能够通过某一个字段或者多个字段进行搜索

raw_id_fields

作用：默认情况下，Django 的admin对"外键"字段使用select选择框界面，有时不希望在下拉列表中选择要显示的所有相关实例产生开销。则可以使用raw_id_fields只显示当前的外键id，代码与示例如下：

# 一对多
class UserAdmin(admin.ModelAdmin):
    raw_id_fields = ('company', )  # 外键

# 多对多
class UserAdmin(admin.ModelAdmin):
    raw_id_fields = ('roles', )  # 多对多

readonly_fields

作用：只读字段

class UserAdmin(admin.ModelAdmin):
    readonly_fields = ('name', 'age') 

在详情页面添加自定义的只读字段

class UserAdmin(admin.ModelAdmin):

    readonly_fields = ('address_report',)

    def address_report(self, instance):
        
        return 'xxx'

    # short_description functions like a model field's verbose_name
    address_report.short_description = "Address"

save_as

作用： 在管理员更改表单上启用“另存为”功能

通常，对象具有三个保存选项：“保存”，“保存并继续编辑”和“保存并添加另一个”。如果save_as为True，则“保存并添加另一个”将由“另存为新”按钮代替，该按钮创建新对象（具有新ID）而不是更新现有对象。

默认情况下，save_as设置为False。

class UserAdmin(admin.ModelAdmin):
    save_as = True

save_as_continue

作用：当save_as=True，保存新对象后的默认重定向是该对象的更改视图即详情页面。如果设置了 save_as_continue=False，重定向将转到更改列表视图。默认情况下，save_as_continue设置为True。

save_on_top

作用：通常，保存按钮仅出现在表单底部。如果设置save_on_top为True，则按钮将同时显示在顶部和底部。

默认情况下，save_on_top设置为False。

search_fields

作用： 设置search_fields为在管理员更改列表页面上启用搜索框。应该将其设置为一个字段名称列表，只要有人在该文本框中提交搜索查询，就将对其进行搜索。

class UserAdmin(admin.ModelAdmin):
    search_fields = ['name', 'age']  # 搜索框可通过name或者age搜索

可以使用外键或者多对多关系

search_fields = ['user__email']

还提供了一些用于指定字段查找的（较旧的）快捷方式。您可以在字段中search_fields添加以下字符作为前缀，这等同于添加__到该字段中：如'=name'相当于'name__iexact'

字首	抬头
^	startswith 以什么开头
=	iexact 不区分大小写的完全匹配
无	icontains 不区分大小写的包含

show_full_result_count

作用： 设置show_full_result_count以控制是否应在过滤的管理页面上显示对象的全部数量。如果将此选项设置为True， 则搜索框旁会显示类似的文本99 results (103 total)；设置为False显示99 results (Show all)

sortable_by

作用：默认情况下，更改列表页允许按list_display中指定的所有模型字段进行排序（直接点击下图字段名可进行排序）。如果要禁用某些列的排序，请使用sortable_by设置，将不希望排序的字段不填写在sortable_by元组或者列表中。

class UserAdmin(admin.ModelAdmin):
    list_display = ('name', 'age', 'gender')
    sortable_by = ( 'age', 'gender')  # 此设置，上图name字段无法通过点击进行排序

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

ModelAdmin的方法

save_model(request，obj，form，change)

重写此方法可进行保存前或保存后的操作。调用super().save_model()以保存对象。

例如，request.user在保存之前附加到对象：

from django.contrib import admin

class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        obj.user = request.user  # 在保存之前执行的操作
        super().save_model(request, obj, form, change)  # 执行保存
        # 此处写保存后需要执行的操作

delete_model(request，obj)

重写此方法可进行删除前或删除后的操作。调用super().delete_model()以使用删除对象 Model.delete()，使用方式同save_model。

delete_queryset(request，queryset)

重写此方法可自定义" delete selected objects "操作的删除过程。

save_formset(request, form, formset, change)

save() 方法返回已经保存到数据库的实例。如果一个给定实例的数据没有在绑定数据中改变，那么实例不会被保存到数据库，也不会包含在返回值里（上述例子中的 instances ）。

当表单中缺少字段时（比如因为它们被排除），这些字段不会被 save() 方法设置。在选择使用字段里（ Selecting the fields to use ），你可以找到有关此限制的更多信息，这也适用于的普通的 ModelForms 。

传递 commit=False，返回未保存的模型实例：

# don't save to the database
>>> instances = formset.save(commit=False)
>>> for instance in instances:
...     # do something with instance
...     instance.save()

这会你在保存它们到数据库之前，附加数据给实例。如果你的表单集包含 ManyToManyField ，你也将需要调用 formset.save_m2m() 来确保正确保存了多对多关系。

完整示例：

class ArticleAdmin(admin.ModelAdmin):
    def save_formset(self, request, form, formset, change):
        instances = formset.save(commit=False)
        for obj in formset.deleted_objects:
            obj.delete()
        for instance in instances:
            instance.user = request.user
            instance.save()
        formset.save_m2m()

get_ordering(request)

get_ordering方法将request作为参数，并预期返回一个列表或元组，以便进行类似于ordering属性的排序。

class PersonAdmin(admin.ModelAdmin):

    def get_ordering(self, request):
        if request.user.is_superuser:  # 判断是不是超级用户
            return ['name', 'rank']
        else:
            return ['name']

get_search_results(request, queryset, search_term

自定义搜索条件

class PersonAdmin(admin.ModelAdmin):
    list_display = ('name', 'age')
    search_fields = ('name',)

def get_search_results(self, request, queryset, search_term):
    """
    search_term:就是输入的搜索内容
    """
    queryset, use_distinct = super().get_search_results(request, queryset, search_term)
    try:
        search_term_as_int = int(search_term)
    except ValueError:
        pass
    else:
        queryset |= self.model.objects.filter(age=search_term_as_int)
    return queryset, use_distinct

上述自定义的方法比 search_fields = ('name', '=age') 更有效

如果 search_fields 多于一个，django 会使用 OR 语句拼接每个条件，速度不如直接使用确定的 field 进行搜索。

save_related(request, form, formsets, change)

在这里，您可以对与父对象相关的对象执行任何保存前或保存后操作。请注意，此时父对象已保存。

get_autocomplete_fields(request)

该方法返回list或tuple的字段名称，该字段名称将与自动完成小部件一起显示 。源码如下：

def get_autocomplete_fields(self, request):
        """
        Return a list of ForeignKey and/or ManyToMany fields which should use
        an autocomplete widget.
        """
        return self.autocomplete_fields

get_readonly_fields(request, obj=None)

该方法返回将显示为只读的字段名称的list或tuple

get_list_display(request)

该方法返回list或tuple的字段名称，该名称将显示在更改列表视图中

get_list_display_links(request, list_display)

返回将链接到变更视图的变更列表中的一个None或一个list或tuple多个字段名称

get_exclude(request, obj=None)

该方法返回exclude的字段列表

get_fields(request, obj=None)

返回fields。

get_fieldsets(request, obj=None)

该方法返回一个二元列表，fieldsets

get_list_filter(request)

返回list_filter。

get_search_fields(request)

返回search_fields。

get_sortable_by(request)

返回一个集合（如list，tuple或set）字段名，通过该集合进行排序。

get_urls()

返回ModelAdmin的可用urls。

在get_urls上一个方法ModelAdmin中相同的方式，URL配置要用于该返回的ModelAdmin的URL。因此，您可以按照URL调度器中的说明扩展它们：

from django.contrib import admin
from django.template.response import TemplateResponse
from django.urls import path

class MyModelAdmin(admin.ModelAdmin):
    def get_urls(self):
        urls = super().get_urls()
        my_urls = [
            path('my_view/', self.my_view),
        ]
        return my_urls + urls

    def my_view(self, request):
        # ...
        context = dict(
           # Include common variables for rendering the admin template.
           self.admin_site.each_context(request),
           # Anything else you want in the context...
           key=value,
        )
        return TemplateResponse(request, "sometemplate.html", context)

如果要使用管理员布局，请从admin/base_site.html以下扩展：

{% extends "admin/base_site.html" %}
{% block content %}
...
{% endblock %}

在此示例中，my_view将通过访问 /admin/myapp/mymodel/my_view/ 。

但是，self.my_view上面注册的功能存在两个问题：

• 它不会执行任何权限检查，因此公众可以访问。
• 它不会提供任何标题详细信息以防止缓存。这意味着，如果页面从数据库中检索数据，并且缓存中间件处于活动状态，则该页面可能会显示过时的信息。

由于通常这不是您想要的，因此Django提供了一个方便的包装器来检查权限并将视图标记为不可缓存。该包装器是AdminSite.admin_view()（即self.admin_site.admin_view 在ModelAdmin实例内部）；像这样使用它：

class MyModelAdmin(admin.ModelAdmin):
    def get_urls(self):
        urls = super().get_urls()
        my_urls = [
            path('my_view/', self.admin_site.admin_view(self.my_view))
        ]
        return my_urls + urls

注意上面第五行中的包装视图：

path('my_view/', self.admin_site.admin_view(self.my_view))

这种包装将防止self.my_view未经授权的访问，并将应用django.views.decorators.cache.never_cache()装饰器以确保如果缓存中间件处于活动状态，则不会对其进行缓存。

如果页面是可缓存的，但是您仍然希望执行权限检查，则可以将cacheable=True参数传递给 AdminSite.admin_view()：

path('my_view/', self.admin_site.admin_view(self.my_view, cacheable=True))

ModelAdmin视图具有model_admin属性。其他 AdminSite视图具有admin_site属性。

**get_form(request, obj=None, **kwargs)**

返回ModelForm要在管理员添加和更改视图中使用的类，请参见add_view()和change_view()。

例如，如果您想向超级用户提供其他字段，则可以以其他基本形式进行交换，如下所示：

class MyModelAdmin(admin.ModelAdmin):
    def get_form(self, request, obj=None, **kwargs):
        if request.user.is_superuser:
            kwargs['form'] = MySuperuserForm   # 如果是管理员，那么就显示MySuperuserForm
        return super().get_form(request, obj, **kwargs)

**formfield_for_foreignkey(db_field, request, **kwargs)**

允许您覆盖外键字段的默认formfield。例如，根据用户返回此外键字段的对象子集：

class MyModelAdmin(admin.ModelAdmin):
    def formfield_for_foreignkey(self, db_field, request, **kwargs):
        if db_field.name == "car":
            kwargs["queryset"] = Car.objects.filter(owner=request.user)
        return super().formfield_for_foreignkey(db_field, request, **kwargs)

**formfield_for_manytomany(db_field, request, **kwargs)**

与formfield_for_foreignkey方法一样，可以重写formfield_for_manytomany方法以更改多对多字段的默认表单字段。例如，如果车主可以拥有多辆汽车，并且汽车可以属于多个车主（多对多关系）则可以筛选"汽车外键"字段，以便仅显示用户拥有的汽车：

class MyModelAdmin(admin.ModelAdmin):
    def formfield_for_manytomany(self, db_field, request, **kwargs):
        if db_field.name == "cars":
            kwargs["queryset"] = Car.objects.filter(owner=request.user)
        return super().formfield_for_manytomany(db_field, request, **kwargs)

**formfield_for_choice_field(db_field, request, **kwargs)**

与formfield_for_foreignkey和formfield_for_manytomany方法一样，可以重写formfield_for_choice_field方法，以更改已声明选项的字段的默认表单字段。例如，如果超级用户可用的选项应不同于普通员工可用的选项，则可以按照以下步骤操作：

class MyModelAdmin(admin.ModelAdmin):
    def formfield_for_choice_field(self, db_field, request, **kwargs):
        if db_field.name == 'status':
            kwargs['choices'] = (
                ('accepted', 'Accepted'),
                ('denied', 'Denied'),
            )
            if request.user.is_superuser:
                kwargs['choices'] += (('ready', 'Ready for deployment'),)
        return super().formfield_for_choice_field(db_field, request, **kwargs)

**get_changelist(request, **kwargs)**

返回要用于列表的Changelist类。默认情况下，使用 django.contrib.admin.views.main.ChangeList。通过继承此类，您可以更改列表的行为。

**get_changelist_form(request, **kwargs)**

返回一个 ModelForm 类，用于更改列表页上的"表单集"。要使用自定义form，例如：

from django import forms

class MyForm(forms.ModelForm):
    pass

class MyModelAdmin(admin.ModelAdmin):
    def get_changelist_form(self, request, **kwargs):
        return MyForm

**get_changelist_formset(request, **kwargs)**

如果使用list_editable，则返回用于changelist页面上的 ModelFormSet 类。要使用自定义表单集，例如：

from django.forms import BaseModelFormSet

class MyAdminFormSet(BaseModelFormSet):
    pass

class MyModelAdmin(admin.ModelAdmin):
    def get_changelist_formset(self, request, **kwargs):
        kwargs['formset'] = MyAdminFormSet
        return super().get_changelist_formset(request, **kwargs)

has_view_permission(request, obj=None)

如果允许查看 obj，应返回 True，否则应返回 False。如果 obj 为 None，则应返回 True 或 False 以指示是否允许查看此类型的对象（例如，False 将解释为不允许当前用户查看此类型的任何对象）。

如果用户具有"更改"或"查看"权限，则默认实现将返回 True。就是设置是否有访问权限。

has_add_permission(request)

是否具有添加数据的权限。如果允许添加对象，应返回 True，否则应返回 False。

has_change_permission(request, obj=None)

是否具有change权限。 如果允许编辑 obj，应返回 True，否则应返回 False。如果 obj 为"无"，则应返回 True 或 False 以指示通常是否允许编辑此类型的对象

has_delete_permission(request, obj=None)

是否具有delete权限。 如果允许删除 obj，应返回 True，否则应返回 False。如果 obj 为"无"，则应返回 True 或 False 以指示通常是否允许删除此类型的对象。

has_module_permission(request)

如果允许在管理页上显示模块并访问模块，则应返回 True，否则为 False。默认情况下使用 User.has_module_perms（） 。虽然设置为True后不显示该模块，但是通过url依然可以访问。

get_queryset(request)

modelAdmin 上的get_queryset方法返回所有模型实例的查询集，该模型实例可以由管理站点编辑。重写此方法的一个用例是显示登录用户能查看的对象：

class MyModelAdmin(admin.ModelAdmin):
    def get_queryset(self, request):
        qs = super().get_queryset(request)
        if request.user.is_superuser:
            return qs
        return qs.filter(author=request.user)

message_user(request, message, level=messages.INFO, extra_tags='', fail_silently=False)

使用django.contrib.messages backend向django后台用户发送信息。

class ArticleAdmin(admin.ModelAdmin):
    ...

    def make_published(self, request, queryset):
        rows_updated = queryset.update(status='p')
        if rows_updated == 1:
            message_bit = "1 story was"
        else:
            message_bit = "%s stories were" % rows_updated
        self.message_user(request, "%s successfully marked as published." % message_bit)

get_paginator(queryset, per_page, orphans=0, allow_empty_first_page=True)

返回一个分页实例

response_add(request, obj, post_url_continue=None)

决定add_view()的HttpResponse , response_add在提交管理表单后以及创建和保存对象和所有相关实例之后调用。可以重写它，以在创建对象后更改默认行为。

response_change(request, obj)

决定change_view()的HttpResponse，model被修改后运行。

response_delete(request, obj_display)

决定delete_view()的HttpResponse，model被删除后运行。

get_changeform_initial_data(request)

默认情况下，字段从 GET 参数中给出初始值。例如，?name=initial_value将名称字段的初始值设置为initial_value。

def get_changeform_initial_data(self, request):
    return {'name': 'custom_initial_value'}

其他方法

add_view(request, form_url='', extra_context=None)

Django的视图模型实例新增页面

change_view(request, object_id, form_url='', extra_context=None)

Django的视图模型实例编辑页面

changelist_view(request, extra_context=None)

模型实例更改列表/操作页面的Django视图

delete_view(request, object_id, extra_context=None)

模型实例删除确认页面的Django视图

history_view(request, object_id, extra_context=None)

该页面的Django视图，显示了给定模型实例的修改历史记录。

这5个方法是被实际的设定为django的view方法的。可以重构，一般是添加渲染view使用的模板的context data：

class MyModelAdmin(admin.ModelAdmin):

    # A template for a very customized change view:
    change_form_template = 'admin/myapp/extras/openstreetmap_change_form.html'

    def get_osm_info(self):
        # ...
        pass

    def change_view(self, request, object_id, form_url='', extra_context=None):
        extra_context = extra_context or {}
        extra_context['osm_data'] = self.get_osm_info()
        return super().change_view(
            request, object_id, form_url, extra_context=extra_context,
        )