欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Admin站点

程序员文章站 2022-03-25 19:10:36
使用admin站点 a.在settings.py中设置语言和时区 LANGUAGE_CODE = 'zh-hans' # 使用中国语言 TIME_ZONE = 'Asia/Shanghai' # 使用中国上海时间 b.创建超级管理员 python manage.py createsuperuser ... ......

使用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)在浏览器中刷新效果如下图:

 

调整编辑页展示

a. 显示字段

属性如下:

fields=[]

2)打开booktest/admin.py文件,修改bookinfoadmin类如下:

 

class bookinfoadmin(admin.modeladmin):
    ...
    fields = ['btitle', 'bpub_date']

3)刷新浏览器效果如下图:

 

b. 分组展示

属性如下:

fieldset=(
    ('组1标题',{'fields':('字段1','字段2')}),
    ('组2标题',{'fields':('字段3','字段4')}),
)

1)打开booktest/admin.py文件,修改bookinfoadmin类如下:

class bookinfoadmin(admin.modeladmin):
    ...
    # fields = ['btitle', 'bpub_date']
    fieldsets = (
        ('基本', {'fields': ['btitle', 'bpub_date']}),
        ('高级', {
            'fields': ['bread', 'bcomment'],
            'classes': ('collapse',)  # 是否折叠显示
        })
    )

2)刷新浏览器效果如下图:

 

注意:fields与fieldsets两者选一使用。

 

c. 关联对象

在一对多的关系中,可以在一端的编辑页面中编辑多端的对象,嵌入多端对象的方式包括表格、块两种。

  • 类型inlinemodeladmin:表示在模型的编辑页面嵌入关联模型的编辑。
  • 子类tabularinline:以表格的形式嵌入。
  • 子类stackedinline:以块的形式嵌入。

 

1)打开booktest/admin.py文件,创建heroinfostackinline类。

class heroinfostackinline(admin.stackedinline):
    model = heroinfo  # 要编辑的对象
    extra = 1  # 附加编辑的数量

 

2)打开booktest/admin.py文件,修改bookinfoadmin类如下:

class bookinfoadmin(admin.modeladmin):
    ...
    inlines = [heroinfostackinline]

 

3)刷新浏览器效果如下图:

 

调整站点信息

admin站点的名称信息也是可以自定义的。

  • admin.site.site_header 设置网站页头
  • admin.site.site_title 设置页面标题
  • admin.site.index_title 设置首页标语

在booktest/admin.py文件中添加一下信息

 

admin.site.site_header = '书城'
admin.site.site_title = '英雄图书'
admin.site.index_title = '欢迎书城'

 

 

上传图片

使用admin站点保存图片,需要安装python的图片操作包

pip install pillow==4.1.0

a. 配置

默认情况下,django会将上传的图片保存在本地服务器上,需要配置保存的路径。

我们可以将上传的文件保存在静态文件目录中,如我们之前设置的static_files目录中在settings.py 文件中添加如下上传保存目录信息

media_root=os.path.join(base_dir,"static_files/media")

b. 为模型类添加imagefield字段

我们为之前的bookinfo模型类添加一个imagefiled

class bookinfo(models.model):
    ...
    image = models.imagefield(upload_to='booktest', verbose_name='图片', null=true)

 

  • upload_to 选项指明该字段的图片保存在media_root目录中的哪个子目录

 

进行数据库迁移操作

python manage.py makemigrations
python manage.py migrate

 

c. 使用admin站点上传图片

进入admin站点的图书管理页面,选择一个图书,能发现多出来一个上传图片的字段

 

选择一张图片并保存后,图片会被保存在static_files/media/booktest/目录下。

在数据库中,我们能看到image字段被设置为图片的路径