Admin基础

admin后台本质上是Django给我们提供的一个app。

环境配置

admin依赖以下四个模块，请确保它们存在于INSTALLED_APPS中：

django.contrib.auth

django.contrib.contenttypes

django.contrib.messages

django.contrib.sessions

并且要将django.contrib.admin加入到INSTALLED_APPS列表。

创建超级用户

python manage.py createsuperuser

要修改管理员的路由，安全起见，不能用默认的admin/路径。

修改超级用户密码

python manage.py shell

from django.contrib.auth.models import User

user = User.objects.get(username=’<用户名>’)

user.set_password(‘<新密码>’)

user.save()

或

python manage.py changepassword <用户名>

#修改指定的用户的密码（提供用户名）或修改当前系统用户密码（不提供用户名）

访问Admin界面

http://localhost:8000/admin/

注册数据表

在admin.py中：

admin.site.register(<表>)     #一次只能注册一个类

ModelAdmin类

对于每个模型，可创建一个对应的ModelAdmin类，这个类的属性就是模型的所有自定义设置。

class <类名>Admin(admin.ModelAdmin):

    #设置ModelAdmin属性...

admin.site.register(<表>, <表>Admin)        #将数据表和它的ModelAdmin类绑定注册

@admin.register(<表>):                      #第二种方法，装饰器注册

class <表>Admin(admin.ModelAdmin):

    #设置ModelAdmin属性...

ModelAdmin的属性

list_display

在实例的修改界面横排显示指定的字段。

list_display = (‘<字段1>’, ‘<字段2>’, ...)

list_filter

在实例的列表界面显示一个FILTER右边栏，用指定的字段进行分类。

可分类的字段：BooleanField、CharField、DateField、DateTimeField、IntegerField、ForeignKey、ManyToManyField

list_filter = [‘<字段1>’, ‘<字段2>’, ...]

search_fields

在实例的列表界面添加搜索框，在指定字段的范围内搜索。

search_fields = [‘<字段1>’, ‘<字段2>’, ...]       #字段为CharField和TextField

actions

一个包含自定义行为的列表。

actions_on_top

默认为True，在页面的列表上方显示actions下拉框。

actions_on_bottom

默认为False，当为True时，在页面的列表下方显示actions下拉框。

actions_selection_counter

默认为True，在action下拉框右侧显示选中的对象数量。

date_hierarchy

指定一个日期型字段，为页面创建一个通过日期过滤对象的时间导航栏。

date_hierarchy = ‘date’

empty_value_display

设置类中的空值字段的默认显示内容（如None，空字符串等），默认是’-’。

empty_value_display = ‘-empty-’

可以设置全局的字段空值的默认显示内容：

admin.site.empty_value_display = ‘-empty-’     #这是一行新代码，并不在类中缩进！

exclude

对指定的字段排除显示。

exclude = ('<字段1>', ‘<字段2>’, ...)

fields

指定显示的字段，其顺序也是字段在Admin后台显示的顺序。

fields = ('<字段1>', ‘<字段2>’, ...)

可以组合元组，让几个字段在同一行显示，如：

fields = ( ('<字段1>', ‘<字段2>’), ‘<字段3>’, ...)

fieldsets

根据字段对页面进行分组显示，传入二元元组，其中每个元组代表一个分组。

fieldsets = (

    (‘<分组标题A>’, {                          # <分组标题>可用None表示无标题

        ‘fields’: (‘<字段1>’, ‘<字段2>’, ...)

        } ),

    (‘<分组标题B>’, {

        ‘fields’: (‘<字段3>’,)

    } ),

    ...

)

显示样式：

分组标题A

字段1

字段2

...

分组标题B

字段3

...

fields同样可以组合元组，让几个字段在同一行显示：

fields = ( ('<字段1>', ‘<字段2>’), ‘<字段3>’, ...)

跟’fields’同级别的属性：

‘classes’: (‘wide’, ‘collaspe’)

一个包含额外CSS类的元组，wide让分组具备更宽的水平空间，collaspe将整个分组折叠。

‘description’

一个可选的额外说明文本，放在每个分组的顶部，如果内部有HTML语法将不被转义。

filter_horizontal

将指定的多对多字段分成水平两部分显示（默认是一个选择框）。

filter_vertical

将指定的多对多字段分成垂直两部分显示（默认是一个选择框）。

form

编写自定义的ModelForm，用于添加/修改页面的表单。

list_editable

指定在修改页面中可以直接编辑的字段，指定的字段将显示为编辑框。

只能设置list_display中的字段。

list_max_show_all

指定一个数值，当列表元素总数大于该值时，显示为“show all”链接，默认为200。

list_per_page

设置每页显示的元素个数，默认为100。

list_select_related

使用select_related()方法查询数据，可以减少数据库访问，默认为False（只对ForeighKey字段调用），当为True时始终调用。

可以传入元组或列表，指定用select_related()查询的字段。

list_select_related = (‘<字段1>’, ‘<字段2>’, ...)

ordering

设置排序方式，传入元组或列表。

radio_fields

用选项展示ForeighKey字段。

save_as

默认为False，显示为“保存并添加另一个”按钮，当为True时变成“保存为新对象”按钮。

save_as_continue

默认为True，在保存新对象后跳转到修改页面，当为False时，跳转到元素列表页面。

save_on_top

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

show_full_result_count

默认为True，显示过滤后的对象的总数，如“99 results (143 total)”，对整个表进行count()操作，如果数据表很大，会耗费一定的资源；当为False时显示为“99 results (show all)“。

#将子表的数据放在主表数据中编辑，此时主表字段下面提供n组相关联的子表字段

class <子表名>InLine(admin.StackedInLine):   #可继承admin.TabularInLine进行扁平化显示

    model = <子表名>

    extra = <编辑的子表数>

class <主表名>Admin(admin.ModelAdmin):

    inlines = [<子表名>InLine]

自定义Admin首页

修改Admin页面顶端的显示文字：

在admin.py中：

django.contrib.admin.AdminSite.site_header = ‘xxx’

修改Admin首页模板：

写入”项目根目录/templates/admin/base_site.html“的模板，见templates笔记第1页。

自定义Admin的Action操作

Action操作用于修改大量的目标，可以编写action函数来自定义该操作。

①在ModelAdmin类中添加属性：

actions = [‘<函数名>’]               #将action函数预先添加到ModelAdmin中

②编写action函数

action函数必须携带三个参数：当前的ModelAdmin、request、被选择的QuerySet对象。

在ModelAdmin类中继续①的代码：

def <函数名>(self, request, queryset):      #用self访问ModelAdmin类本身

    for obj in queryset:

        #对Queryset进行修改...

    self.message_user(request, ‘xxxx’)     #为操作添加提示信息，xxxx显示为页面顶部绿色行

<函数名>.short_description = ‘xxx’      #对函数添加描述，显示为Action下拉列表中的名称，

下拉列表中默认显示为函数名

action函数的全站引用与禁用

admin.site.add_action(<函数名>)          #将action函数作用于整个admin站点

admin.site.disable_action(<函数名>)        #将action函数全站禁用

#全站禁用的action函数也可以添加到某个ModelAdmin类的action属性中，进行显式的引用

class <类名>Admin(admin.ModelAdmin):

    actions = None                      #禁用该模型中的所有action函数