django admin站点基础教程

django中内置了admim方法，用来管理django后台

创建一个子应用，django在其子应用下创建一个admin.py文件，用来管理该子应用的站点(在django后台的admin下)

python manage.py startapp xxx

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-MLdMwnNs-1679014361469)(C:\Users\曾添\AppData\Roaming\Typora\typora-user-images\image-20230316102117004.png)]

ModelAdmin 类是管理界面中模型的表示。通常，这些都存储在你的应用程序中一个名为 admin.py 的文件中

from django.contrib import admin  #需要继承django中的admin对象
from myapp.models import Author  #导入需要注册到django后台的数据库模型


#第一种方法
class AuthorAdmin(admin.ModelAdmin):  #
    pass
admin.site.register(Author, AuthorAdmin)  #将类与数据库模型绑定并注册
#第二种方法：利用装饰器将类与模型绑定
@admin.register(Author)#装饰器可以绑定多个数据模型，但需要设置 site=custom_admin_site，在装饰器里面 一般不建议（如果要使用，请去官网查看）
class AuthorAdmin(admin.ModelAdmin):  
    pass

ModelAdmin 类中的参数

fields: 在"添加"或"更改"数据时触发，用来显示可用字段的子集，可以修改他们的顺序

fieldsets 是一个个由两个元素组成的元组的列表，其中每个元组代表管理表单页面上的一个 <fieldset>。（一个 <fieldset> 是表单的一个 “部分”。)

这一个元组的格式是 (name, field_options)，其中 name 是代表字段集标题的字符串，field_options 是关于字段集的信息字典，包括要在其中显示的字段列表。

from django.contrib import admin

class FlatPageAdmin(admin.ModelAdmin):
    fieldsets = ((
        None,{
            "fields":('title', 'body')
        }),(
        "测试",{
            "fields":('excerpt', 'category', 'tags','author')
        }
    ))

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Xf2wfWlr-1679014361470)(C:\Users\曾添\AppData\Roaming\Typora\typora-user-images\image-20230316110859928.png)]

exclude：如果给定了这个属性，那么这个属性应该是一个要从表单中排除的字段名列表

如果你的 ModelForm 和 ModelAdmin 都定义了 exclude 选项，那么 ModelAdmin 优先：

list_display

list_display=[‘列表页显示哪些字段的列（一定要与字段名对应，不然报错）’]

lsit_display_links (控制list_display中的字段，哪些可以连接到修改页的)

ModelAdmin.list_filter

#设置list_filter来激活管理更改列表页面右侧侧栏的过滤器
#list_filter是一个元素的列表或元组，其中每个元素应是下列类型之一
#一个字段名，其中指定的字段应该是 BooleanField`、CharField`、DateField、DateTimeField、IntegerField、ForeignKey 或 ManyToManyField
#list_filter 中的字段名也可以使用 __ 查找来跨越关系，
list_filter = ("title","author__username","created")

ModelAdmin.search_fields

#设置 search_fields，在管理更改列表页面上启用搜索框。这应该被设置为字段名的列表，每当有人在该文本框中提交搜索查询时，就会被搜索到。
#在搜索框中进行搜索时，Django 会将搜索查询拆分成多个词，并返回所有包含这些词的对象，不区分大小写（即 icontains 查找：不区分大小写的包含匹配），其中每个词必须在 search_fields 中至少有一个。例如，如果search_fields 设置为 ['first_name', 'last_name']，用户搜索 john lennon'，Django 会做相当于这个 SQL WHERE 子句。
#

ModelAdmin.list_per_page

用户搜索 john lennon’，Django 会做相当于这个 SQL WHERE 子句。

##### ModelAdmin.list_per_page

每页中显示多少条数据，默认为每页显示100条数据