|
|
from django import forms
|
|
|
from django.contrib.auth.admin import UserAdmin
|
|
|
from django.contrib.auth.forms import UserChangeForm
|
|
|
from django.contrib.auth.forms import UsernameField
|
|
|
from django.utils.translation import gettext_lazy as _
|
|
|
|
|
|
# 模块级注释——accounts应用的Admin后台表单配置文件，
|
|
|
# 自定义BlogUser（自定义用户模型）的创建表单、修改表单，以及Admin后台管理配置，
|
|
|
# 适配Django Admin的用户管理逻辑，支持自定义字段（如nickname、source）的后台操作
|
|
|
from .models import BlogUser
|
|
|
|
|
|
|
|
|
class BlogUserCreationForm(forms.ModelForm):
|
|
|
"""
|
|
|
自定义用户创建表单（用于Django Admin后台添加新用户）
|
|
|
扩展默认表单，增加密码二次验证逻辑，适配BlogUser模型的字段要求
|
|
|
"""
|
|
|
# 密码输入字段：label支持国际化，使用密码输入控件（隐藏输入内容）
|
|
|
password1 = forms.CharField(label=_('password'), widget=forms.PasswordInput)
|
|
|
# 密码二次确认字段：用于验证两次输入密码一致
|
|
|
password2 = forms.CharField(label=_('Enter password again'), widget=forms.PasswordInput)
|
|
|
|
|
|
class Meta:
|
|
|
model = BlogUser # 关联的模型：accounts应用的BlogUser（自定义用户模型）
|
|
|
fields = ('email',) # 后台创建用户时，必填的核心字段（仅邮箱，用户名可后续补充或自动生成）
|
|
|
|
|
|
def clean_password2(self):
|
|
|
"""
|
|
|
密码二次验证的清洁方法（Django表单验证机制）
|
|
|
检查两次输入的密码是否一致，不一致则抛出验证错误
|
|
|
"""
|
|
|
# 获取第一次和第二次输入的密码（已通过表单基础验证的清洁数据）
|
|
|
password1 = self.cleaned_data.get("password1")
|
|
|
password2 = self.cleaned_data.get("password2")
|
|
|
# 若两次密码均存在且不一致，抛出验证错误（错误信息支持国际化）
|
|
|
if password1 and password2 and password1 != password2:
|
|
|
raise forms.ValidationError(_("passwords do not match"))
|
|
|
# 验证通过，返回第二次输入的密码（用于后续保存）
|
|
|
return password2
|
|
|
|
|
|
def save(self, commit=True):
|
|
|
"""
|
|
|
重写保存方法，实现密码哈希存储和创建来源标记
|
|
|
Django默认会对密码进行哈希处理，此处明确调用set_password确保安全性
|
|
|
"""
|
|
|
# 调用父类save方法，先不提交到数据库（commit=False）
|
|
|
user = super().save(commit=False)
|
|
|
# 对密码进行哈希处理后存储（避免明文存储，符合Django安全规范）
|
|
|
user.set_password(self.cleaned_data["password1"])
|
|
|
# 若需要提交到数据库（默认commit=True）
|
|
|
if commit:
|
|
|
user.source = 'adminsite' # 标记用户创建来源：Django Admin后台
|
|
|
user.save() # 最终保存用户数据到数据库
|
|
|
return user
|
|
|
|
|
|
|
|
|
class BlogUserChangeForm(UserChangeForm):
|
|
|
"""
|
|
|
自定义用户修改表单（用于Django Admin后台编辑用户信息）
|
|
|
继承Django内置UserChangeForm，适配BlogUser模型的所有字段
|
|
|
"""
|
|
|
class Meta:
|
|
|
model = BlogUser # 关联的模型：accounts应用的BlogUser
|
|
|
fields = '__all__' # 后台可修改的字段：所有模型字段（支持自定义扩展字段）
|
|
|
field_classes = {'username': UsernameField} # 用户名字段的类：使用Django内置UsernameField（确保符合用户名验证规则）
|
|
|
|
|
|
def __init__(self, *args, **kwargs):
|
|
|
"""
|
|
|
初始化表单，调用父类构造方法保持默认逻辑
|
|
|
若后续需要扩展表单初始化行为（如隐藏字段、设置默认值），可在此方法中添加
|
|
|
"""
|
|
|
super().__init__(*args, **kwargs)
|
|
|
|
|
|
|
|
|
class BlogUserAdmin(UserAdmin):
|
|
|
"""
|
|
|
自定义UserAdmin配置（用于Django Admin后台管理BlogUser模型）
|
|
|
配置后台显示字段、排序规则、搜索字段等，优化用户管理体验
|
|
|
"""
|
|
|
form = BlogUserChangeForm # 关联用户修改表单：使用自定义的BlogUserChangeForm
|
|
|
add_form = BlogUserCreationForm # 关联用户创建表单：使用自定义的BlogUserCreationForm
|
|
|
|
|
|
# 后台列表页显示的字段（按业务优先级排序）
|
|
|
list_display = (
|
|
|
'id', # 用户ID（唯一标识）
|
|
|
'nickname', # 用户昵称（自定义扩展字段）
|
|
|
'username', # 用户名（Django用户模型核心字段）
|
|
|
'email', # 邮箱（用于登录和通知，核心字段）
|
|
|
'last_login', # 最后登录时间（安全审计字段）
|
|
|
'date_joined', # 注册时间（业务统计字段）
|
|
|
'source' # 创建来源（区分后台创建/前台注册等，自定义扩展字段）
|
|
|
)
|
|
|
|
|
|
# 后台列表页可点击跳转的字段（用于快速进入编辑页）
|
|
|
list_display_links = ('id', 'username')
|
|
|
|
|
|
# 后台列表页默认排序规则：按ID倒序（新创建的用户排在前面）
|
|
|
ordering = ('-id',)
|
|
|
|
|
|
# 后台搜索支持的字段（支持模糊查询，提升管理效率）
|
|
|
search_fields = ('username', 'nickname', 'email') |
