Django3.2边学边记—Adimn站点管理

2021-09-24

准备工作

创建管理员的用户名和密码: 

python manage.py createsuperuser

  根据提示创建用户名 密码

在admin.py中注册模型类

from django.contrib import admin
from models import Test

class TestAdmin(admin.ModleAdmin):
    pass

admin.site.register(Test,TestAdmin)

浏览器端登录页面:类似以下后缀

http://127.0.0.1:8000/admin/

  


管理页面显示

创建模型管理类来管理某个模型在后台显示的页面形式

ModelAdmin类可以控制不同模型在Admin界面中的展示方式,主要包括在列表页的展示方式、添加修改页的展示方式

上文中展示了TestAdmin类的一种注册方法,还有一种方法,就是使用装饰器注册,如下:

@admin.register(Test)
class TestAdmin(admin.ModelAdmin):
    pass

页大小

每页中显示多少条数据,默认为每页显示100条数据,设置为20
class TestAdmin(admin.ModelAdmin):
    list_per_page = 20

操作选项的位置

  由action_on_bottom 和action_on_top两属性来控制 默认显示在顶部,默认值分别为:False 和 True,改为只显示在底部:

class TestAdmin(admin.ModelAdmin):
    list_per_page = 20
    actions_on_bottom = True
    actions_on_top = False

  

显示哪些列 

用   list_display=[模型字段1,模型字段2,模型方法1,...] 控制显示的列,Django 会尝试按照这个顺序解释 list_display 的每个元素:

  • 一个模型的字段。
  • 一个可调用对象。
  • 一个代表 ModelAdmin 属性的字符串。
  • 一个代表模型属性的字符串。

用模型属性显示 模型的id title pub_date 三个属性

class TestAdmin(admin.ModelAdmin):
    ...
    list_display = ['id','title','pub_date']

  或者模型方法,要求方法有返回值,如下在模型类中定义一个方法 

class TestInfo(models.Model):
    ...
    def atitle(self):
        return self.title

按以上方法显示的列是不能排序的,如果让这个方法显示的列也能排序,就给atitle方法的.admin_order_field属性,指定排序依据的模型属性,如下:

# from django.db import models
# from django.contrib import admin
class TestInfo(models.Model): ... def atitle(self): return self.title atitle.admin_order_field = 'title' #注意有引号

列标题

默认为方法的名称,

  可以通过.short_description属性设置

class TestInfo(models.Model):
    ...
    atitle.short_description='标题'

  如果是更改模型字段显示的列标题,可以在定义模型字段时,设置verbose_name的值 ,或者封装成方法,再对方法使用上面那个属性,模型字段不能直接使用那个属性。  

class Test(models.Model):
    title = models.CharField(max_length=20,verbose_name='标题')

如果一个字段的值是 None,一个空字符串,或者一个没有元素的可迭代字段,Django 将显示 - (破折号)。

  你可以用empty_value_display 属性更改

from django.contrib import admin
  ...
  atitle.empty_value_display = '(None)'

  或者管理类中设置属性

class PersonAdmin(admin.ModelAdmin):
    empty_value_display = 'unknown'

以上通过指定方法属性来控制显示是新老版本通用的,在Django3.2可以通过给装饰器传参来解决

from django.db import models
from django.contrib import admin

class Test(models.Model):
    ....
    
    """
    empty_value:属性值为空时 处理
    description:显示名
    ordering:排序依据
    boolean:返回值为bool型
    其中:
    empty_value 和 boolean 只能设置一个(互斥)
    """
    @admin.display(empty_value='空', description='父级地名', ordering='id',boolean=True)
    def title2(self):
        return self.title

过滤器

用 list_filter 来激活管理更改列表页面右侧侧栏的过滤器,如下截图所示:

../../../_images/list_filter.png  

 list_filter 应是一个元素的列表或元组,会将对应字段的值列出来,一般用于快速过滤有重复值的字段

 

class TestAdmin(admin.ModelAdmin):
    list_filter = ['is_delete']

  

搜索框

用 search_fields,在管理启用搜索框。 

class TestAdmin(admin.ModelAdmin):
    search_fields = ['id','name']

在搜索框中进行搜索时,Django 会将搜索查询拆分成多个词,并返回所有包含这些词的对象,不区分大小写(即 icontains 查找:不区分大小写的包含匹配),其中每个词必须在 search_fields 中至少有一个。例如,如果 search_fields 设置为 ['first_name', 'last_name'],用户搜索 john lennon',Django 会做相当于这个 SQL WHERE 子句。

WHERE (first_name ILIKE '%john%' OR last_name ILIKE '%john%')
AND (first_name ILIKE '%lennon%' OR last_name ILIKE '%lennon%')

搜索查询可以包含带空格的引号短语。我的理解就是分组整体匹配(Django3.2新增),例如,如果用户搜索 "john winston" 或 'john winston',Django 会做相当于这个 SQL 的 WHERE 子句:

WHERE (first_name ILIKE '%john winston%' OR last_name ILIKE '%john winston%')

如果你不想使用 icontains 查找方式,你可以使用 ModelAdmin.get_search_results() 来提供额外的或替代的搜索行为。