Django定制Admin页面（展示页面和编辑页面）

以上篇文章中注册的Goods应用为例

默认的Admin系统中，Goods应用的详情页

上图中，并未显示商品的具体信息（名称等），统一名称为 Goods Object，为方便项目操作和管理，可在文件 model.py 中添加如下代码，用来显示商品名称和 id 信息：

def __str__(self):
    return '%s:%s' % (self.id, self.name)

效果如下（可通过点击进入商品详情页面）：

如需定制此页面的展示信息，可以在文件 admin.py 中使用以下关键字达到预期效果：

1. list_display选项：用于控制页面展示的字段，该选项的值为元组或列表类型，其中的元素可以是模型字段或自定义字段

2. list_display_links选项：用于设置需在页面中以链接形式展示的字段,可跳转到详情页面

# 计算销售额的函数
def sales_volume(g):
    total = g.price * g.sales
    return f'{g.name}销售额为:{total}'
sales_volume.short_description = '商品销售额' # 设置字段描述

# 装饰器方法注册应用
@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)
    list_display_links = ('id', 'name',)  # 设置字段链接

 显示效果（蓝色字段点击可进入商品详情页）：

3. list_filter选项：用于开启列表页过滤器，该选项可以接收模型中的字段作为过滤条件

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time')
    # list_filter = ['name',]  # 过滤器

 

效果如下（即为通过特定条件筛选目标）：

4. list_per_page选项：用于设置每页显示的数据量

5. list_editable选项用于设置可编辑的字段，字段若被指定为编辑字段，页面上可直接编辑该字段。

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)
    list_display_links = ('id', 'name',)  # 设置字段链接
    list_filter = ['id', 'name']  # 过滤器
    list_per_page = 5     # 每页展示5条记录
    list_editable = ('price', 'stock')  # 设置商品价格和库存为可编辑字段

显示效果如下：

5. search_fields选项：用于配置搜索字段

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time')
    list_display_links = ('id', 'name',)  # 设置字段链接
    list_filter = ['id', 'name']  # 过滤器
    list_per_page = 5     # 每页展示5条记录
    list_editable = ('price', 'stock')  # 设置商品价格和库存为可编辑字段
    search_fields = ('name',)   # 表示以 name 作为搜索字段

 

显示效果：

7. actions_on_top选项：用于设置是否在顶部显示动作下拉框，默认为True，表示在顶部显示。

8. actions_on_bottom选项：用于设置管理员动作是否在底部显示，默认为False，表示不在底部显 示，当设置为True表示在底部显示。

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    # 列表界面的自定义
    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)
    # actions_on_top选项用于设置是否在顶部显示动作下拉框
    # actions_on_bottom选项用于设置管理员动作是否在底部显示
    actions_on_top = False
    actions_on_bottom = True

显示效果：

定制商品详情页面（即编辑页面），依然是在admin.py文件中，有如下选项：

1. fields选项：用于控制编辑页要显示的字段，它的值是元组类

   fields选项支持以二维元组形式设置字段分栏显示，在fileds中一个元组表示一栏数据

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin): 
    fields = ('name', 'price', 'stock') 

显示效果：

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    fields = (('name', 'price'), ('stock', 'sales'))      # 分栏显示

效果如下： 

2. fieldsets选项：用于对可编辑字段进行分组，该选项不可与fields选项同时使用

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    fieldsets = (
        ('商品基本信息', {'fields': ['name', 'stock', 'sales']}),
        ('商品价格信息', {'fields': ['price']})
    )

效果如下：

3. readonly_fields选项：用于设置只读字段

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    fieldsets = (
        ('商品基本信息', {'fields': ['name', 'stock', 'sales']}),
        ('商品价格信息', {'fields': ['price']})
    )
    readonly_fields = ('name',)

效果如下：

 

4. save_on_top选项：用于社会是否在编辑页上方显示保存、删除等按钮，默认为False 

@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
    fieldsets = (
        ('商品基本信息', {'fields': ['name', 'stock', 'sales']}),
        ('商品价格信息', {'fields': ['price']})
    )
    readonly_fields = ('name',)
    save_on_top = True

效果如下：