Django 学习笔记——Model和Admin设置（继承模块）

        Django 虽然学习曲线很陡峭，但是它内置了一大堆基础模块供你继承，所以即便现在学得想吃屎，一旦掌握了就跟开挂了一样。我现在在学习的时候就感受到了。

        今天学习了两个最基本的，一个是用户模块继承AbstractUser,另一个是用户管理继承BaseUserManager。为什么要继承而不是自己写一个全新的model呢？主要就是方便，比如内置了判别该用户是不是超级用户、是否可以正常登录等等一些小众的属性以及大部分常见的你能想到的属性，更重要的是在后面设计用户注册和登录功能的时候，一行authenticate+login就可以实现，不用你再费劲去自己写代码。

一、Model调用库

from django.db import models
from django.utils import timezone
from django.contrib.auth.models import AbstractUser,BaseUserManager

二、Myuser设计

        Django 自带的AbstractUser模块包含了11个属性：

        • username: 用户名

        • password: 密码（加密存储、哈希加密，哪怕是super user也看不到密码，但是自带了权限可以修改）

        • email: 电子邮件地址

        • first_name: 名        

        • last_name: 姓

        • is_staff: 是否为工作人员

        • is_active: 账户是否活跃（如果后台改为否，该用户就无法登录了）

        • is_superuser: 是否为超级用户

        • last_login: 最后一次登录时间

        • date_joined: 注册时间

        默认 User 模型还包括一些重要的功能，如权限系统和组管理，这个在项目比较简单的时候一时半会儿用不到，我们以后再讲。

        当然我们也可以在添上自己想要的属性，比如用户的生日、学校等等。

class MyUser(AbstractUser):
    username = models.CharField(max_length=30,unique=True)
    email = models.EmailField(unique=True)
    date_joined = models.DateTimeField(default=timezone.now, editable=False)
    is_active = models.BooleanField(default=True)
    is_staff = models.BooleanField(default=False)
    is_superuser = models.BooleanField(default=False)

    objects = CustomUserManager()

    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = ['username']

    def __str__(self):
        return self.username

        这里在写代码的时候有几个小细节，需要注意：（1）email和username我们不希望有重复所以要加上unique=True（2）date_joined 这个属性我们希望系统能够自动获取所以要设置default=提交表单的时间，并设置为不可更改（这对后面admin部分造成影响）（3）is_active要调成默认True，is_staff和is_superuser要调成默认False

       objects = CustomUserManager()这一行在设置管理器，CustomUserManager也是自定义的，待会儿会讲。

        USERNAME_FIELD在设定唯一确定用户的属性，类似于账号（只能填一个属性）；       

        REQUIRED_FIELDS在设定用户必须得提供的信息，否则用户就无法创立（可以是多个）；      

        def __str__(self): return self.username 这部分代码非常重要，就是在后台管理的部分，我们想用username来指代这个用户，如果不添加，后台就会默认使用（如 MyUser object (1)来表示，这并不直观。

三、CustomUserManager自定义管理器设定

        如果在设置MyUser我们直接令Object = BaseUserManager()而不做任何关于管理器的自定义设定的话，一般情况下都会报错，比如我们想调用create superuser这个函数设置管理员账户的时候，它可能会说BaseUserManager没有这个函数。为什么呢？这并不是BaseUserManager真的不包含这个函数，而是它只针对自带的AbstractUser用户模型管用，但凡你自定义了一点内容（通常都会），甚至只是USERNAME_FIELD或者REQUIRED_FIELDS与原模型不一致都不行。所以我们通常需要自定义管理器来覆盖掉常用的方法才行。

class CustomUserManager(BaseUserManager):
    def create_user(self, email,username, password=None, **extra_fields):
        if not email:
            raise ValueError('The Email field must be set')
        email = self.normalize_email(email)
        user = self.model(email=email, username=username,**extra_fields)
        user.set_password(password)
        user.save(using=self._db)
        return user

    def create_superuser(self, email,username ,password=None, **extra_fields):
        extra_fields.setdefault('is_staff', True)
        extra_fields.setdefault('is_superuser', True)
        return self.create_user(email,username, password, **extra_fields)

        这里我们只设置了两个方法，一个是创造用户create_user。我们向里面传递三个必要参数email，username，password。而**extrafield 可以传递一些额外参数，如默认值等等。

        normalize_email方法可以把邮箱格式规范化，所有字母变成小写字母；

        user = self.model(email=email, username=username,**extra_fields)，创建一个新的用户对象，self.model是管理器关联的类（与MyUser中 objects = CustomUserManager()相对应）

       user.set_password(password)，设置用户密码并进行哈希加密。

       user.save(using=self._db)，将用户对象保存在数据库中，self._db是默认的主数据库。

        最后return user是方便后续在视图中或者测试中调用刚创建的user。

        第二个方法是create_superuser，最后是调用create_user这个方法，只不过extrafilds要传两个默认参数值，把‘is_staff’和‘is_superuser’改为True，设定为超级用户。

四、Admin设计

from django.contrib import admin
from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
from .models import MyUser

class MyUserAdmin(BaseUserAdmin):
    list_display = ('username','email','date_joined')
    list_filter = ('username','email','date_joined')
    fieldsets = (
        (None, {'fields': ('username', 'password')}),
        ('Personal info', {'fields': ('email',)}),
        ('Permissions', {'fields': ('is_staff', 'is_superuser', 'is_active')}),
        ('Important dates', {'fields': ('last_login', 'date_joined')}),
    )
    add_fieldsets = (
        (None, {
            'classes': ('wide',),
            'fields': ('username', 'email', 'password1', 'password2'),
        }),
    )
    readonly_fields = ('date_joined',)
    search_fields = ('username', 'email')
    ordering = ('username',)
    filter_horizontal = ()

admin.site.register(MyUser,MyUserAdmin)

        继承Django自带的BaseUserAdmin模块，list_display配置预览时展示的内容，list_filter配置筛选字段。

        fieldsets可以将Myuser属性界面进行分段，fieldsets((name1,{'fields':(''~,'~')}),(name2,{'fields':(''~,'~')})),～就是对应name底下的属性，当然还可以添加class字段，常见的有'wide'：使字段组的表单宽度最大化，填充整个表单区域。 'collapse'：使字段组在表单加载时默认折叠。用户可以点击字段组标题以展开或折叠内容。add_fieldsts指的是用户创建界面的属性和布局，原理类似。

        这里有个细节需要注意，就是fieldssets里默认都是可以修改的变量，如果我们放入了不能修改的属性比如，date_joined，就会报错。一定要放的话，要在后面补上一行代码readonly_fields = ('date_joined',)，以告诉admin这是不能修改的。

        search_fields是展示搜索框按照哪些属性进行搜做，ordering是说预览时按照那个变量排序，filter_horizontal 允许在 admin 表单中为多对多关系字段提供更友好的用户界面。这些字段会显示为带有可选项的双向列表框，用户可以将选项从一个框中移动到另一个框中。

        最后register绑定一下就大功告成了。admin界面如下：