Admin后台数据管理

一个站点或者网站，除了给用户浏览及操作外，还需要对后台数据进行管理，比如添加商品，修改商品等等。

Django提供了一个可插拔的后台管理系统------Admin
应用，该系统可以从模型中读取元数据，并提供以模型为中心的界面。Admin后台管理系统不仅让管理员可以便捷地管理、发布、维护网站
的内容，也为开发人员节约了大量开发时间。本章节将对Admin管理系统进行介绍。

学习目标:

掌握进入后台管理系统的方法

掌握模型model的注册方法

熟悉ModelAdmin的选项

了解Admin认证和授权

1.认识Admin后台管理页面

1.1 进入Admin

1）Django项目的根urls.py文件中默认定义了一个"/admin/"路由，该路由指向Admin

2）启动Django项目，在浏览器中输入"http://127.0.0.1:8000/admin/"，页面会跳转到后台管理系统的登录页面

能不能查询数据库，看看用户名密码是多少？

3）pycharm中 连接sqlite数据库

​ 4）数据库迁移

通过数据库迁移，在sqlite数据库中自动生成Admin模块所对应的表，比如auth_user表等

• 生成迁移文件，即生成sql语句

  python manage.py makemigrations

• 执行迁移文件，即执行sql语句

  python manage.py migrate

​

​ 5）登录后台管理系统需要输入管理员用户名与密码，此时可在命令终端通过"python manage.py createsuperuser"命令创建管理员用户

提示：

以上示例中的电子邮件可为空，密码长度至少为8个字符（非强制），输入的密码不会在屏幕显示。创建完成后的管理员用户信息会被存储在auth_user表中

​ 6）登录成功后进入站点管理界面

​ 7）管理界面本地化

首次登录之后是英文界面，后台管理是给管理员使用的，英文界面阅读起来就比较困难了，这里可
以将后台管理本地 化。本地化是将显示的语言、时间等使用本地的习惯，这里的本地化就是进行中国化，中国大陆地区使用简体中文，时区使用亚洲/上海时区，注意这里不使用北京时区表示。

两种方式可以将Admin系统的语言本地化

• 在seetings.py文件中将配置项LANGUAGE_CODE的值设置为"zh-Hans"，TIME_ZONE的值设置为"Asia/Shanghai"

• 在seetings.py文件中配置项MIDDLEWARE(中间件)中添加本地化中间件"django.middleware.locale.LocaleMiddleware"

如果你只是想要用本地语言来运行Django,并且该语言的语言文件存在,只需要简单地设置 LANGUAGE_CODE 即可。如果要让每一个使用者各自指定语言偏好,就需要使用 LocaleMiddleware 。 LocaleMiddleware 使得Django基于请求的数据进行语言选择,从而为每一位用户定制内容。 它为每一个用户定制内容。使用 LocaleMiddleware 需要在 MIDDLEWARE_CLASSES 设置中增加'django.middleware.locale.LocaleMiddleware' 。

任务： 进入admin站点管理系统

1.2 使用Admin模块 对数据库中的数据操作

创建goods子应用 python manage.py startapp goods注册子应用完善路由配置

1.2.1 创建模型类

在goods子应用的models.py文件中添加模型类

from django.db import models# Create your models here.class Goods(models.Model): name = models.CharField(max_length=50, verbose_name='商品名')  # 显示的名称 别名 price = models.DecimalField(max_digits=10, decimal_places=2, verbose_name='价格')

迁移

先不忙迁移，下方会调整后再操作

1.2.2 注册模型类

若想使Admin系统中呈现自定义的模型数据，需在应用的admin.py文件中将模型注册到后台系统。

使用装饰器@admin.register()注册模型

# 语法 @admin.register(模型名)from django.contrib import adminfrom .models import Goods# 装饰器的方式@admin.register(Goods)class xxx  # 一般需要操作展示数据或者定制时会使用此方式注册，否者采用后者方式注册

使用admin.site.register()注册模型

# 语法 admin.site.register(模型名)admin.site.register(Goods)

修改应用的显示名称

在goods应用的 init .py 文件中添加如下设置

default_app_config = 'goods.apps.GoodsConfig'

在goods/apps.py文件中使用verbose_name设置应用的名称

from django.apps import AppConfigclass GoodsConfig(AppConfig):name = 'goods'verbose_name = '商品信息'

1.2.3 修改模型显示的名称

# gppds/models.pyfrom django.db import models# Create your models here.class Goods(models.Model):    ...class Meta:verbose_name = '商品' # 模型名称(单数)verbose_name_plural = verbose_name # 模型名称(复数)

任务2： 创建商品模型，且在后台管理界面显示

1.2.4 模型数据的增删改查

对Goods模型添加字段等属性

from django.db import models# Create your models here.class Goods(models.Model):    create_time = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")    update_time = models.DateTimeField(auto_now=True, verbose_name="更新时间")    name = models.CharField(max_length=50, verbose_name='商品名')    price = models.DecimalField(max_digits=10, decimal_places=2,verbose_name='价格')    stock = models.IntegerField(default=0, verbose_name='库存')    sales = models.IntegerField(default=0, verbose_name='销量')    class Meta: db_table = 'tb_goods'   # 数据表名 verbose_name = '商品'     # 模型名称(单数) verbose_name_plural = verbose_name  # 模型名称(复数)    def __str__(self): return '%s:%s' % (self.id, self.name)

在django shell中执行 数据库迁移 命令

python manage.py makemigrations #生成迁移文件

python manage.py migrate # 执行迁移文件

1.2.5 在admin 页面对goods模型 实现增、删、改、查 等操作

查询商品

增加商品

修改或删除商品

删除商品

2.定制Admin后台管理页面

在使用默认的admin管理页面时，当不满足需求时，就需要定制Admin的后台管理页面

ModelAdmin类主要用于控制模型信息在Admin后台页面中的展示，
ModelAdmin类包含了诸多选项，包括列表页选项、编辑页选项，管理员可以通过这些选项灵活地控制要呈现的数据

2-1 定制列表页选项

​ 常用的列表页选项有：

2.1 list_display选项

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

在应用的admin.py文件中定义

方式1：

# 方式一  利用装饰器注册方式@admin.register(Goods)class GoodsAdmin(admin.ModelAdmin): list_display = ('id','name', 'price', 'stock', 'sales','create_time', 'update_time')

方式2：

class GoodsAdmin(admin.ModelAdmin): list_display = ('id','name', 'price', 'stock', 'sales', 'create_time', 'update_time')admin.site.register(Goods,GoodsAdmin)

2.2 显示自定义字段

自定义字段指与模型相关，但并不包含在模型中的字段，这种字段是定义在应用的admin.py
文件中的一些函数，这些函数会将模型实例作为参数

#admin.pydef 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 = ('name', 'price', 'stock', 'sales', 'create_time', 'update_time',sales_volume)

2.3 list_display_links选项

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

@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_display_links，则依据list_display_links指定的字段设置链接

2.4 list_filter选项

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

@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 = ['sales', 'name']  # 过滤器

2.5 list_per_page选项

使用list_per_page选项可以设置每页显示的数据量

@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 = ['sales', 'name']  # 过滤器    list_per_page = 5  # 每页展示5条记录

2.6 list_editable选项

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 = ['sales', 'name']  # 过滤器    # list_per_page = 5  # 每页展示5条记录    list_editable = ('price',)  # 设置商品价格price为可编辑字段

提示：list_display_links与list_editable不能同时设置同一字段

2.7 search_fields选项

search_fields选项用于配置搜索字段

search_fields = ('name','id') # 表示以name,id 作为搜索字段

2.8 actions_on_top选项

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

2.9 actions_on_bottom 选项

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

任务：定制后台管理的列表页面

2-2 定制编辑页选项

单击列表页面中的id等字段后，页面会跳转到相应记录的编辑页。通过编辑页选项可以控制在编
辑页显示的字段、设置字段分组、将字段设置为只读等，这些选项在应用的admin.py文件的模型管理类中使用

a1 fields选项

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

# goods/admin.py@admin.register(Goods)class GoodsAdmin(admin.ModelAdmin):    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)    fields = ('name', 'price', 'stock')

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

# goods/admin.py@admin.register(Goods)class GoodsAdmin(admin.ModelAdmin):    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)    fields = (('name', 'price'), ('stock', 'sales'))

a2 fieldsets选项

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

# goods/admin.py@admin.register(Goods)class GoodsAdmin(admin.ModelAdmin):    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)    fieldsets = ( ('商品基本信息', {'fields': ['name', 'stock', 'sales']}), ('商品价格信息', {'fields': ['price']})    )

a3 编辑页其他选项

# goods/admin.py@admin.register(Goods)class GoodsAdmin(admin.ModelAdmin):    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)    readonly_fields = ['sales']

# goods/admin.py@admin.register(Goods)class GoodsAdmin(admin.ModelAdmin):    list_display = ('id', 'name', 'price', 'stock', 'sales', 'create_time', 'update_time', sales_volume)    save_on_top = True  # 没必要设置，默认下方有

任务：定制后台管理的编辑页面

3.认证和授权

Admin提供管理用户与组、用户与组权限的功能，使用超级用户登录后台管理系统后可以对用户或组进行增加，或变更用户与组的权限

1. 用户管理

2. 组管理

组的作用是批量对用户的权限进行管理和分配，将一个用户加入到一个组中，该用户就拥有了该
组所拥有的所有权限，如此可避免逐个管理具有相同权限的用户，减少工作量，提高管理效率

​ 3.权限管理

1) 单击选择用户来修改页面中的用户名称可进入修改用户页面。修改用户页面中包含账号信息、个人信

息、权限、重要日期四组数据信息，其中账号信息中包含用户名和密码

​ 2) 使用当前登录的超级用户可以将当前管理的用户添加到指定组中

3) 选中左侧列表框的权限，单击"

"按钮可将权限移动到右侧列表框中，方可为用户赋予权限

​ 4) 在Admin站点管理页面单击"组"进入选择组来修改页面，在该页面中单击组名称进入修改组页面，修改组页面中可为指定的组设置权限

任务：分别创建两个用户和两个组，分别对组设置权限，且用户添加到组中

五、网页展示

通过Admin后台管理，保存了商品数据到数据库，那下面应该就是以网页的形式把商品呈现给客户，买家

5.1 商品列表首页展示

1. 在views通过Model获取要展示的数据

   from django.shortcuts import renderfrom django.http import HttpResponsefrom django.shortcuts import renderfrom .models import Goods# Create your views here.def index(requst):    """首页"""    # 通过模型获取数据库中的商品列表数据    # Goods类--》表 objects对象 ---》表的记录    goods_list = Goods.objects.all()    print(goods_list)    return HttpResponse("商品首页")

2. 准备商品首页的模板网页

​ settings.py配置模板页路径

index.html模板页面

<!DOCTYPE html><html lang="en"><head>    <meta charset="UTF-8">    <meta name="viewport" content="width=f, initial-scale=1.0">    <meta http-equiv="X-UA-Compatible" content="ie=edge">    <title>在线商城</title>    <style> .title {     width: 100%;     height: 100px;     text-align: center;     padding-top: 20px;     background: cornflowerblue;     font-size: 60px; } .con {     width: 100%;     height: 33px;     background: silver;     border: 2px solid chocolate; } span {     float: left;     width: 30%;     color: darkolivegreen;     font-size: 20px; } button {     float: right;     margin-right: 20px;     margin-top: 5px;     background-color: aquamarine; }    </style></head><body>    <div class="title">商品信息</div>    {% for goods in infos %} <div class='con'>     <span>商品编号: {{ goods.id }}</span> <span>商品名称: {{ goods.name }}    </span> <span>商品价格: {{ goods.price }}</span>     <button>购买</button> </div>    {% endfor %}</body></html>

3. 在views.py中指定要返回的模板页面

   from django.shortcuts import renderfrom django.http import HttpResponsefrom .models import Goods# Create your views here.def index(requst):    """首页"""    # 通过模型获取数据库中的商品列表数据    # Goods类--》表 objects对象 ---》表的记录    goods_list = Goods.objects.all()    print(goods_list) # 向模板页面传递的参数， 以字典的形式封装在context中    context = { 'infos': goods_list    }    # return HttpResponse("商品首页") 渲染    # request: http 请求参数 ，index.html：模板页面 context：传给模板页面的参数    return render(requst, 'index.html', context)    # return HttpResponse("商品首页")

4. 测试效果

5.2 商品详情页展示

​ 1.在goods应用的urls.py配置路由

urlpatterns = [path('index/',views.index),path('detail/',views.detail),]

2.在index.html 点击购买 跳转到详情页[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-EUpw2GYT-1652084698065)(./images/media/image75.png)]{width=“4.421235783027122in”
height=“2.205415573053368in”}

3. 在views编写detail函数，且获取商品详情数据

def detail(request):    """详情页"""    # 通过request 获取请求参数 /goods/detail?id=3&username=xxx&pwd=yyy    goods_id = request.GET.get('id')    # 查询具体某个商品的信息    goods = Goods.objects.get(id=goods_id)    print(goods)    return HttpResponse("详情页")

4. 准备商品首页的模板网页

detail.html模板页面

<!DOCTYPE html><html lang="en"><head>    <meta charset="UTF-8">    <meta name="viewport" content="width=device-width, initial-scale=1.0">    <title>商品详情页面</title>    <style> span {     font-size: 20px;     color: blueviolet; }    </style></head><body><h1>商品详情</h1><div class="detail_con">    <div>商品名称： <span>{{ goods.name }}</span></div>    <div>商品价格： <span>{{ goods.price }}</span></div>    <div>上架时间： <span>{{ goods.create_time }}</span></div></div></body></html>

5. 在views.py的detail函数指定要返回的模板页面

   def detail(request):    """详情页"""    # 通过request 获取请求参数 /goods/detail?id=3&username=xxx&pwd=yyy    goods_id = request.GET.get('id')    # 查询具体某个商品的信息    goods = Goods.objects.get(id=goods_id)    goods.create_time = goods.create_time.date()    # print(goods)    # 传给模板的参数    context = {'goods': goods}    return render(request, 'detail.html', context)

6. 测试效果

以上步骤挺详细的，路过不妨点个赞~~~~~~~~~~~~~