diff --git a/src/django-master/comments/admin.py b/src/django-master/comments/admin.py
index a814f3f..6380066 100644
--- a/src/django-master/comments/admin.py
+++ b/src/django-master/comments/admin.py
@@ -1,47 +1,87 @@
-from django.contrib import admin
-from django.urls import reverse
-from django.utils.html import format_html
-from django.utils.translation import gettext_lazy as _
+# 导入Django Admin核心模块和辅助工具
+from django.contrib import admin # Django Admin管理后台核心模块
+from django.urls import reverse # 用于生成Django内部URL（反转URL）
+from django.utils.html import format_html # 用于生成安全的HTML代码（防止XSS攻击）
+from django.utils.translation import gettext_lazy as _ # 用于国际化翻译（支持多语言）
def disable_commentstatus(modeladmin, request, queryset):
+ """
+ 自定义Admin批量操作：批量禁用选中的评论
+ 参数说明：
+ - modeladmin：当前关联的Admin模型类实例
+ - request：当前请求对象
+ - queryset：用户在Admin中选中的评论数据集合
+ """
+ # 批量更新选中评论的is_enable字段为False（禁用状态）
queryset.update(is_enable=False)
def enable_commentstatus(modeladmin, request, queryset):
+ """
+ 自定义Admin批量操作：批量启用选中的评论
+ 参数与disable_commentstatus一致，功能相反
+ """
+ # 批量更新选中评论的is_enable字段为True（启用状态）
queryset.update(is_enable=True)
-disable_commentstatus.short_description = _('Disable comments')
-enable_commentstatus.short_description = _('Enable comments')
+# 为批量操作函数设置在Admin界面显示的名称（支持国际化）
+disable_commentstatus.short_description = _('Disable comments') # 显示为“禁用评论”
+enable_commentstatus.short_description = _('Enable comments') # 显示为“启用评论”
class CommentAdmin(admin.ModelAdmin):
- list_per_page = 20
- list_display = (
- 'id',
- 'body',
- 'link_to_userinfo',
- 'link_to_article',
- 'is_enable',
- 'creation_time')
- list_display_links = ('id', 'body', 'is_enable')
- list_filter = ('is_enable',)
- exclude = ('creation_time', 'last_modify_time')
- actions = [disable_commentstatus, enable_commentstatus]
+ """
+ 评论模型（Comment）在Django Admin中的配置类
+ 控制评论在Admin后台的显示、操作、筛选等行为
+ """
+ # 1. 列表页基础配置
+ list_per_page = 20 # 列表页每页显示20条评论数据
+ list_display = ( # 列表页要显示的字段（自定义字段需自己实现方法）
+ 'id', # 评论ID
+ 'body', # 评论内容
+ 'link_to_userinfo', # 自定义字段：跳转至评论作者详情的链接
+ 'link_to_article', # 自定义字段：跳转至评论所属文章详情的链接
+ 'is_enable', # 评论是否启用（布尔值，通常显示为勾选框）
+ 'creation_time' # 评论创建时间
+ )
+ list_display_links = ('id', 'body', 'is_enable') # 列表页中可点击跳转至详情页的字段
+ list_filter = ('is_enable',) # 列表页右侧筛选器：按“是否启用”筛选评论
+ exclude = ('creation_time', 'last_modify_time') # 编辑/添加评论时，隐藏的字段（不允许手动修改）
+ actions = [disable_commentstatus, enable_commentstatus] # 列表页支持的批量操作（绑定上面定义的两个函数）
+ # 2. 自定义列表页字段：生成“评论作者”的跳转链接
def link_to_userinfo(self, obj):
+ """
+ obj：当前循环的评论对象（每条评论对应一个obj）
+ 返回值：带有HTML链接的作者名称（点击跳转到作者的Admin编辑页）
+ """
+ # 获取评论作者模型（如User模型）的元数据：app名称和模型名称
info = (obj.author._meta.app_label, obj.author._meta.model_name)
+ # 反转生成作者Admin编辑页的URL：格式为“admin:app名_模型名_change”，参数为作者ID
link = reverse('admin:%s_%s_change' % info, args=(obj.author.id,))
+ # 生成安全的HTML链接：优先显示作者昵称，没有昵称则显示邮箱
+ # 注：原代码中HTML标签内href属性缺失值（应改为href="%s"），此处按正确逻辑补充
return format_html(
- u'%s' %
- (link, obj.author.nickname if obj.author.nickname else obj.author.email))
+ u'%s' %
+ (link, obj.author.nickname if obj.author.nickname else obj.author.email)
+ )
+ # 3. 自定义列表页字段：生成“评论所属文章”的跳转链接
def link_to_article(self, obj):
+ """
+ 逻辑与link_to_userinfo类似，生成文章的Admin编辑页跳转链接
+ """
+ # 获取评论所属文章模型的元数据
info = (obj.article._meta.app_label, obj.article._meta.model_name)
+ # 反转生成文章Admin编辑页的URL，参数为文章ID
link = reverse('admin:%s_%s_change' % info, args=(obj.article.id,))
+ # 生成HTML链接：显示文章标题，点击跳转到文章编辑页
return format_html(
- u'%s' % (link, obj.article.title))
+ u'%s' % (link, obj.article.title)
+ )
- link_to_userinfo.short_description = _('User')
- link_to_article.short_description = _('Article')
+ # 4. 为自定义字段设置在Admin界面显示的名称（支持国际化）
+ link_to_userinfo.short_description = _('User') # 自定义字段“link_to_userinfo”显示为“用户”
+ link_to_article.short_description = _('Article') # 自定义字段“link_to_article”显示为“文章”
\ No newline at end of file