11-Django站点管理

站点管理

内容发布的部分由网站的管理员负责，包括查看、添加、修改、删除数据
- 开发这些重复的功能是一件单调乏味、缺乏创造力的工作，为此，Django能够根据定义的模型类自动地生成管理模块
在Django项目中默认启用Admin管理站点
- 列表页选项
- 编辑页选项
- 重写模板

1、启动mysql数据库：

  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.mysql',
          'NAME': 'bookdb',
          'HOST': 'localhost',
          'PORT': '3306',
          'USER': 'root',
          'PASSWORD': '',
      }
  }

2、models.py文件中，定义模型类（没有迁移数据表的需要线迁移数据表）

python manage.py makemigrations

python manage.py migrate

from django.db import models

# Create your models here.
#创建作者信息表
class Authors(models.Model):
    name = models.CharField(max_length=20)#作者名字
    gender = models.BooleanField(default=True)#性别
    age = models.IntegerField()#年龄
    addr = models.CharField(max_length=60)
    tel = models.IntegerField()
    #元类修改表名
    class Meta:
        db_table = "authors"
    def __str__(self):
        return self.name
#创建书籍信息
class Books(models.Model):
    name = models.CharField(max_length=20)#书名
    pub_data = models.DateField(null=True)#出版日期
    #参数max_digits表示总位数 参数decimal_places表示小数位数
    price = models.DecimalField(max_digits=8,decimal_places=2)#价格
    publish = models.CharField(max_length=20)
    #外键 将字段定义在多的一端中 级联删除
    author = models.ForeignKey(Authors,on_delete=models.CASCADE)
    #修改表名（元类）
    class Meta:
        db_table = "books"

    def __str__(self):
        return self.name

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

python manage.py createsuperuser

4、在admin.py文件中将书籍与作者类名注册到后台站点

from django.contrib import admin
from Book.models import *
# Register your models here.
admin.site.register(Authors)

#为了让站点显示书籍完整信息，需要重新注册模型类
class BookAdmin(admin.ModelAdmin):
    list_display = ["id","name","pub_data","price","publish","author_id"]

admin.site.register(Books,BookAdmin)

5、输入网址http://127.0.0.1:8000/admin/登录后台站点

进去就可以查看、添加、修改、删除操作

6、重写模型的__str__显示各个模型类的name(我上面已经写出来了)

  # 在站点显示name而不是模型类对象
  def __str__(self):
      return self.name.encode('utf-8')

控制站点管理页的展示

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

1、注册参数：

#为了让站点显示书籍完整信息，需要重新注册模型类
class BookAdmin(admin.ModelAdmin):
    list_display = ["id","name","pub_data","price","publish","author_id"]

admin.site.register(Books,BookAdmin)

2、注册装饰器

 @admin.register(Books)
  class BookAdmin(admin.ModelAdmin):
      pass

接下来就可以在类BookAdmin中控制列表页、增加修改页展示效果(例如注册参数的例子)

1、列表页选项

　　页大小：指定每页多少条数据，默认为每页显示100条数据

list_per_page = 5

#为了让站点显示书籍完整信息，需要重新注册模型类
class BookAdmin(admin.ModelAdmin):
    list_display = ["id","name","pub_data","price","publish","author_id"]
    #在管理站点页大小，指定每页5条
    list_per_page = 5
admin.site.register(Books,BookAdmin)

操作选项Action（动作）的位置（默认在管理页的顶部有一个，管理页底部每页）

actions_on_top = True

action_on_bottom = False

#为了让站点显示书籍完整信息，需要重新注册模型类
class BookAdmin(admin.ModelAdmin):
    list_display = ["id","name","pub_data","price","publish","author_id"]
    #在管理站点页大小，指定每页5条
    list_per_page = 5
    #在底部新加一个Action
    actions_on_bottom = True
admin.site.register(Books,BookAdmin)

列表中的列：

 list_display=[字段1, 字段2, ...]

#为了让站点显示书籍完整信息，需要重新注册模型类（列表中的列）
class BookAdmin(admin.ModelAdmin):
    list_display = ["id","name","pub_data","price","publish","author_id"]

admin.site.register(Books,BookAdmin)

模型方法作为列（地区示例：复制过来的）：

模型方法和模型字段都指定为列显示在管理界面上
- 模型方法作为列无法直接点击列头排序，如果需要排序需要为方法指定排序依据
```
# 定义AreaInfo模型方法作为列
def title(self):
  return self.name
list_display = ['id', 'name', 'parent', 'title']
```
浏览效果

方法作为列排序：指定方法作为列的排序依据

  # 定义模型方法作为列
  def title(self):
      return self.name
  # 指定方法作为列的排序依据
  title.admin_order_field = 'name'

***列标题：

列标题默认为属性或方法的名称，可以通过属性设置为其他名称
列标题的设置方式
- 1.short_description属性设置
- 2.verbose_name属性设置
short_description属性设置
- 需要先将模型字段封装成方法，再对方法使用这个属性，模型字段不能直接使用

short_description属性

方法名.short_description = '列标题'
# 定义模型方法作为列
def title(self):
  return self.name
# 指定方法作为列的排序依据
title.admin_order_field = 'name'
# 修改模型title方法作为列的标题名称
title.short_description = '区域名称'

verbose_name属性设置

定义模型字段时指定该属性的值

# 地区列表信息
class AreaInfo(models.Model):
  name = models.CharField(verbose_name='地区标题', max_length=30) #名称
  parent = models.ForeignKey('self',null=True,blank=True) #关系

  # 元类信息 ：修改表名
  class Meta:
      db_table = 'areainfo'

浏览效果

右侧栏过滤器

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

  list_filter = ['字段1', '字段2', ...]
  class AreaAdmin(admin.ModelAdmin):
      # 右侧栏过滤器
      list_filter = ['name']

浏览效果

搜索框

用于对指定字段的值进行搜索，支持模糊查询

 search_fields = ['字段1', '字段2', ...]
  class AreaAdmin(admin.ModelAdmin):
      # 搜索框
      search_fields = ['name']

浏览效果

2、编辑页选项

进入编辑页面

字段顺序

根据列表顺序指定编辑界面字段顺序

  fields = ['字段1', '字段2', ...]
  class AreaAdmin(admin.ModelAdmin):
      # 显示字段顺序
      fields = ['parent', 'name']

浏览效果

字段分组

字段分组fieldsets与字段顺序fields二选一使用

对字段进行分组管理，有如下两种写法

  fieldsets = (
      ('组1标题', {'fields':('字段1', '字段2')}),
      ('组2标题', {'fields':('字段3', '字段4')}),
  )
  fieldsets = [
      ('组1标题', {'fields':['字段1', '字段2']}),
      ('组2标题', {'fields':['字段3', '字段4']}),
  ]
  class AreaAdmin(admin.ModelAdmin):
      # 字段分组：与fields二选一使用
      fieldsets = [
          ('基本', {'fields':['name']}),
          ('高级', {'fields':['parent']}),
      ]

浏览效果

关联对象

在一对多的关系中，可以在一端的编辑页面中编辑多端的对象
- 嵌入多端对象的方式包括表格、块两种
类型InlineModelAdmin：表示在模型的编辑页面嵌入关联模型的编辑
- 子类StackedInline：以块的形式嵌入
- 子类TabularInline：以表格的形式嵌入

在admin.py文件中，创建AreaStackedInline类,继承自admin.StackedInline

  class AreaStackedInline(admin.StackedInline):
      model = AreaInfo #关联子对象
      extra = 2 #额外编辑2个子对象
  class AreaAdmin(admin.ModelAdmin):
      # 嵌入关联子对象
      inlines = [AreaStackedInline]

浏览效果：以块形式嵌入
浏览效果：以列表形式嵌入

以上站点管理的素材以及教程来源于github：记录下来，以便需要时能迅速查阅，翻看。

3、重写模板

　　当我们需要修改站点管理页面的样式时，可以重写站点的模板

步骤：

　　1、在templates目录下创建admin目录

2、打开当前虚拟环境中的Django目录，在向下找到站点页面的模板

代码如下：

{% extends "admin/base.html" %}

{% block title %}{{ title }} | {{ site_title|default:_('Django site admin') }}{% endblock %}

{% block branding %}
{#<h1 id="site-name"><a href="{% url 'admin:index' %}">{{ site_header|default:_('Django administration') }}</a></h1>#}

{# 自定义内容 #}
<h1 id="site-name"><a href="{% url 'admin:index' %}">welcome use manage!!!</a></h1>

{% endblock %}

{% block nav-global %}{% endblock %}