|
|
# 导入Django内置的抽象用户模型，用于扩展自定义用户功能（包含基础用户名、密码等字段）
|
|
|
from django.contrib.auth.models import AbstractUser
|
|
|
# 导入Django模型相关类，用于定义数据库表结构
|
|
|
from django.db import models
|
|
|
# 导入reverse函数，用于通过URL名称生成对应的URL路径
|
|
|
from django.urls import reverse
|
|
|
# 导入now函数，用于获取当前时区的时间（作为字段默认值）
|
|
|
from django.utils.timezone import now
|
|
|
# 导入翻译工具，用于实现模型字段名称的国际化
|
|
|
from django.utils.translation import gettext_lazy as _
|
|
|
# 导入自定义工具函数get_current_site，用于获取当前站点的域名信息
|
|
|
from djangoblog.utils import get_current_site
|
|
|
|
|
|
|
|
|
class BlogUser(AbstractUser):
|
|
|
"""
|
|
|
自定义用户模型，继承自Django的AbstractUser
|
|
|
扩展了内置用户模型，增加了昵称、创建时间、修改时间、创建来源等自定义字段
|
|
|
"""
|
|
|
# 昵称字段：支持国际化标签，最大长度100，允许空白（不强制填写）
|
|
|
nickname = models.CharField(_('nick name'), max_length=100, blank=True)
|
|
|
# 创建时间字段：支持国际化标签，默认值为当前时间（调用now函数）
|
|
|
creation_time = models.DateTimeField(_('creation time'), default=now)
|
|
|
# 最后修改时间字段：支持国际化标签，默认值为当前时间
|
|
|
last_modify_time = models.DateTimeField(_('last modify time'), default=now)
|
|
|
# 创建来源字段：记录用户创建的渠道（如adminsite、frontend等），支持国际化标签，允许空白
|
|
|
source = models.CharField(_('create source'), max_length=100, blank=True)
|
|
|
|
|
|
def get_absolute_url(self):
|
|
|
"""
|
|
|
定义模型实例的绝对URL（标准Django方法）
|
|
|
通过URL名称'blog:author_detail'生成用户详情页的URL，参数为用户名
|
|
|
"""
|
|
|
return reverse(
|
|
|
'blog:author_detail', kwargs={
|
|
|
'author_name': self.username}) # kwargs传递URL所需的用户名参数
|
|
|
|
|
|
def __str__(self):
|
|
|
"""
|
|
|
定义模型实例的字符串表示
|
|
|
当打印或引用用户实例时，返回用户的邮箱地址（便于识别）
|
|
|
"""
|
|
|
return self.email
|
|
|
|
|
|
def get_full_url(self):
|
|
|
"""
|
|
|
生成用户详情页的完整URL（包含站点域名）
|
|
|
结合当前站点域名和get_absolute_url生成的相对路径，组成完整链接
|
|
|
"""
|
|
|
# 获取当前站点的域名（如www.example.com）
|
|
|
site = get_current_site().domain
|
|
|
# 拼接域名和相对路径，形成完整URL（使用HTTPS协议）
|
|
|
url = "https://{site}{path}".format(site=site,
|
|
|
path=self.get_absolute_url())
|
|
|
return url
|
|
|
|
|
|
class Meta:
|
|
|
"""
|
|
|
模型的元数据配置，用于定义模型的显示和行为规则
|
|
|
"""
|
|
|
ordering = ['-id'] # 数据查询时的默认排序：按ID降序（最新创建的用户在前）
|
|
|
verbose_name = _('user') # 模型的单数显示名称（支持国际化）
|
|
|
verbose_name_plural = verbose_name # 模型的复数显示名称（与单数一致，避免英文复数变形问题）
|
|
|
get_latest_by = 'id' # 获取"最新记录"时的依据字段：按ID判断（ID最大的为最新） |
