Admin站点

2024-03-11 15:17:31

使用admin站点

a.在settings.py中设置语言和时区

LANGUAGE_CODE = 'zh-hans' # 使用中国语言
TIME_ZONE = 'Asia/Shanghai' # 使用中国上海时间

b.创建超级管理员

python manage.py createsuperuser

App应用配置

在每个应用目录中都包含了apps.py文件，用于保存该应用的相关信息。

在创建应用时，Django会向apps.py文件中写入一个该应用的配置类，如

from django.apps import AppConfig

class BooktestConfig(AppConfig):
    name = 'booktest'
    verbose_name = '图书管理'

AppConfig.name 属性表示这个配置类是加载到哪个应用的，每个配置类必须包含此属性，默认自动生成。

AppConfig.verbose_name 属性用于设置该应用的直观可读的名字，此名字在Django提供的Admin管理站点中会显示，

注册模型类

登录后台管理后，默认没有我们创建的应用中定义的模型类，需要在自己应用中的admin.py文件中注册，才可以在后台管理中看到，并进行增删改查操作。

打开booktest/admin.py文件，编写如下代码：

from django.contrib import admin
from booktest.models import BookInfo,HeroInfo

admin.site.register(BookInfo)
admin.site.register(HeroInfo)

到浏览器中刷新页面，可以看到模型类BookInfo和HeroInfo的管理了。

点击类名称"BookInfo"（图书）可以进入列表页，默认只有一列。

在列表页中点击"增加"可以进入增加页，Django会根据模型类的不同，生成不同的表单控件，按提示填写表单内容后点击"保存"，完成数据创建，创建成功后返回列表页。

在列表页中点击某行的第一列可以进入修改页。

按照提示进行内容的修改，修改成功后进入列表页。在修改页点击“删除”可以删除一项。

删除：在列表页勾选想要删除的复选框，可以删除多项。

点击执行后进入确认页面，删除后回来列表页面。

定义与使用Admin管理类

Django提供的Admin站点的展示效果可以通过自定义ModelAdmin类来进行控制。

定义管理类需要继承自admin.ModelAdmin类，如下

from django.contrib import admin

class BookInfoAdmin(admin.ModelAdmin):
    pass

1. 注册参数

admin.site.register(BookInfo,BookInfoAdmin)

2. 装饰器

@admin.register(BookInfo)
class BookInfoAdmin(admin.ModelAdmin):
    pass

调整列表页展示

a. 页大小

每页中显示多少条数据，默认为每页显示100条数据，属性如下：

class BookInfoAdmin(admin.ModelAdmin):
    list_per_page = 2

2. 操作选项的位置

顶部显示的属性，设置为True在顶部显示，设置为False不在顶部显示，默认为True。

actions_on_top=True

底部显示的属性，设置为True在底部显示，设置为False不在底部显示，默认为False。

actions_on_bottom=False

class BookInfoAdmin(admin.ModelAdmin):
    ...
    actions_on_top = True
    actions_on_bottom = True

c. 列表中的列

class BookInfoAdmin(admin.ModelAdmin):
    ...
    list_display = ['id','btitle']

点击列头可以进行升序或降序排列。

d. 将方法作为列

列可以是模型字段，还可以是模型方法，要求方法有返回值。

通过设置short_description属性，可以设置在admin站点中显示的列名。

1）打开booktest/models.py文件，修改BookInfo类如下:

class BookInfo(models.Model):
    ...
    def pub_date(self):
        return self.bpub_date.strftime('%Y年%m月%d日')

    pub_date.short_description = '发布日期'  # 设置方法字段在admin中显示的标题

2）打开booktest/admin.py文件，修改BookInfoAdmin类如下：

class BookInfoAdmin(admin.ModelAdmin):
    ...
    list_display = ['id','btitle','pub_date']

3）在浏览器中刷新效果如下图：

注:方法列是不能排序的，如果需要排序需要为方法指定排序依据。

admin_order_field=模型类字段

1）打开booktest/models.py文件，修改BookInfo类如下：

class BookInfo(models.Model):
    ...
    def pub_date(self):
        return self.bpub_date.strftime('%Y年%m月%d日')

    pub_date.short_description = '发布日期'
    pub_date.admin_order_field = 'bpub_date'

2）在浏览器中刷新效果如下图：

e. 关联对象

无法直接访问关联对象的属性或方法，可以在模型类中封装方法，访问关联对象的成员。

1）打开booktest/models.py文件，修改HeroInfo类如下：

class HeroInfo(models.Model):
    ...
    def read(self):
        return self.hbook.bread

    read.short_description = '图书阅读量'

2）打开booktest/admin.py文件，修改HeroInfoAdmin类如下：

class HeroInfoAdmin(admin.ModelAdmin):
    ...
    list_display = ['id', 'hname', 'hbook', 'read']

3）在浏览器中刷新效果如下图：

f. 右侧栏过滤器

属性如下，只能接收字段，会将对应字段的值列出来，用于快速过滤。一般用于有重复值的字段。

list_filter=[]

1）打开booktest/admin.py文件，修改HeroInfoAdmin类如下：

class HeroInfoAdmin(admin.ModelAdmin):
    ...
    list_filter = ['hbook', 'hgender']

2）在浏览器中刷新效果如下图：

g. 搜索框

属性如下，用于对指定字段的值进行搜索，支持模糊查询。列表类型，表示在这些字段上进行搜索。

search_fields=[]

1）打开booktest/admin.py文件，修改HeroInfoAdmin类如下：

class HeroInfoAdmin(admin.ModelAdmin):
    ...
    search_fields = ['hname']

2）在浏览器中刷新效果如下图：

码农公寓

相关文章