|
|
from django.contrib.auth.models import AbstractUser
|
|
|
from django.db import models
|
|
|
from django.urls import reverse
|
|
|
from django.utils.timezone import now
|
|
|
from django.utils.translation import gettext_lazy as _
|
|
|
from djangoblog.utils import get_current_site
|
|
|
|
|
|
|
|
|
# Create your models here.
|
|
|
|
|
|
class BlogUser(AbstractUser):
|
|
|
"""
|
|
|
博客用户模型，继承自Django内置的AbstractUser基类
|
|
|
扩展了标准用户模型，增加博客系统特有的字段
|
|
|
"""
|
|
|
|
|
|
#ZXY: 昵称字段：用户显示名称，可为空
|
|
|
nickname = models.CharField(
|
|
|
_('nick name'), #ZXY: 国际化标签，在admin中显示为"昵称"
|
|
|
max_length=100, #ZXY: 最大长度100个字符
|
|
|
blank=True) #ZXY: 允许为空，非必填字段
|
|
|
|
|
|
#ZXY: 创建时间：记录用户账号创建的时间点
|
|
|
creation_time = models.DateTimeField(
|
|
|
_('creation time'), #ZXY: 显示为"创建时间"
|
|
|
default=now) #ZXY: 默认值为当前时间，自动记录创建时间戳
|
|
|
|
|
|
#ZXY: 最后修改时间：记录用户信息最后一次修改的时间
|
|
|
last_modify_time = models.DateTimeField(
|
|
|
_('last modify time'), #ZXY: 显示为"最后修改时间"
|
|
|
default=now) #ZXY: 默认值为当前时间
|
|
|
|
|
|
#ZXY: 注册来源：记录用户是通过什么渠道注册的
|
|
|
source = models.CharField(
|
|
|
_('create source'), #ZXY: 显示为"创建来源"
|
|
|
max_length=100, #ZXY: 最大长度100个字符
|
|
|
blank=True) #ZXY: 允许为空
|
|
|
|
|
|
def get_absolute_url(self):
|
|
|
"""
|
|
|
获取用户详情页的URL路径（不含域名）
|
|
|
用于Django的通用视图和admin中的"查看现场"链接
|
|
|
Returns:
|
|
|
str: 用户详情页的URL路径，如 '/author/testuser/'
|
|
|
"""
|
|
|
return reverse(
|
|
|
'blog:author_detail', kwargs={
|
|
|
'author_name': self.username}) #ZXY: 使用用户名作为URL参数
|
|
|
|
|
|
def __str__(self):
|
|
|
"""
|
|
|
定义模型的字符串表示，在admin和shell中显示
|
|
|
这里使用邮箱而不是用户名，便于管理员识别用户
|
|
|
Returns:
|
|
|
str: 用户的邮箱地址
|
|
|
"""
|
|
|
return self.email
|
|
|
|
|
|
def get_full_url(self):
|
|
|
"""
|
|
|
获取包含完整域名的用户详情页URL
|
|
|
用于邮件通知、外部链接等需要完整URL的场景
|
|
|
Returns:
|
|
|
str: 完整的用户URL，如 'https://example.com/author/testuser/'
|
|
|
"""
|
|
|
site = get_current_site().domain #ZXY: 获取当前站点的域名
|
|
|
url = "https://{site}{path}".format(
|
|
|
site=site,
|
|
|
path=self.get_absolute_url()) #ZXY: 组合域名和路径
|
|
|
return url
|
|
|
|
|
|
class Meta:
|
|
|
"""
|
|
|
模型的元数据配置类
|
|
|
用于定义模型级别的选项和配置
|
|
|
"""
|
|
|
ordering = ['-id'] #ZXY: 默认按ID降序排列，新的用户显示在前面
|
|
|
verbose_name = _('user') #ZXY: 单数形式的显示名称
|
|
|
verbose_name_plural = verbose_name #ZXY: 复数形式与单数相同
|
|
|
get_latest_by = 'id' #ZXY: 指定获取最新记录的字段
|
