Update admin.py

src/DjangoBlog/comments/admin.py

@@ -4,44 +4,91 @@ from django.utils.html import format_html
 from django.utils.translation import gettext_lazy as _
 
 
+# 批量禁用评论的 admin 动作
 def disable_commentstatus(modeladmin, request, queryset):
+    """
+    将选中的评论批量更新为禁用状态（is_enable=False）
+    :param modeladmin: 当前 ModelAdmin 实例
+    :param request: HTTP 请求对象
+    :param queryset: 选中的评论查询集
+    """
     queryset.update(is_enable=False)
 
 
+# 批量启用评论的 admin 动作
 def enable_commentstatus(modeladmin, request, queryset):
+    """
+    将选中的评论批量更新为启用状态（is_enable=True）
+    :param modeladmin: 当前 ModelAdmin 实例
+    :param request: HTTP 请求对象
+    :param queryset: 选中的评论查询集
+    """
     queryset.update(is_enable=True)
 
 
+# 设置 admin 动作在后台显示的友好名称（支持国际化）
 disable_commentstatus.short_description = _('Disable comments')
 enable_commentstatus.short_description = _('Enable comments')
 
 
+# Comment 模型的后台管理配置类
 class CommentAdmin(admin.ModelAdmin):
+    # 列表页每页显示 20 条记录
     list_per_page = 20
+
+    # 列表页显示的字段（按顺序）
     list_display = (
-        'id',
-        'body',
-        'link_to_userinfo',
-        'link_to_article',
-        'is_enable',
-        'creation_time')
+        'id',                    # 评论 ID
+        'body',                  # 评论内容
+        'link_to_userinfo',      # 自定义方法：链接到用户信息
+        'link_to_article',       # 自定义方法：链接到文章
+        'is_enable',             # 是否启用
+        'creation_time'          # 创建时间
+    )
+
+    # 可点击跳转到详情页的字段
     list_display_links = ('id', 'body', 'is_enable')
+
+    # 右侧过滤栏，按 is_enable 字段过滤
     list_filter = ('is_enable',)
+
+    # 在编辑/创建页面排除的字段（这些字段会自动处理）
     exclude = ('creation_time', 'last_modify_time')
+
+    # 注册批量操作动作
     actions = [disable_commentstatus, enable_commentstatus]
 
+    # 自定义方法：生成指向用户详情页的链接
     def link_to_userinfo(self, obj):
+        """
+        构建指向评论作者后台详情页的 HTML 链接
+        :param obj: 当前评论实例
+        :return: 包含作者昵称或邮箱的 HTML 超链接
+        """
+        # 获取作者模型的 app 名称和模型名称，用于构建 admin URL
         info = (obj.author._meta.app_label, obj.author._meta.model_name)
+        # 反向解析作者详情页的 admin URL
         link = reverse('admin:%s_%s_change' % info, args=(obj.author.id,))
+        # 返回 HTML 超链接，优先显示昵称，无昵称则显示邮箱
         return format_html(
             u'<a href="%s">%s</a>' %
             (link, obj.author.nickname if obj.author.nickname else obj.author.email))
 
+    # 自定义方法：生成指向文章详情页的链接
     def link_to_article(self, obj):
+        """
+        构建指向评论所属文章后台详情页的 HTML 链接
+        :param obj: 当前评论实例
+        :return: 包含文章标题的 HTML 超链接
+        """
+        # 获取文章模型的 app 名称和模型名称，用于构建 admin URL
         info = (obj.article._meta.app_label, obj.article._meta.model_name)
+        # 反向解析文章详情页的 admin URL
         link = reverse('admin:%s_%s_change' % info, args=(obj.article.id,))
+        # 返回 HTML 超链接，显示文章标题
         return format_html(
             u'<a href="%s">%s</a>' % (link, obj.article.title))
 
+    # 为自定义方法设置后台显示的友好名称（支持国际化）
     link_to_userinfo.short_description = _('User')
-    link_to_article.short_description = _('Article')
+    link_to_article.short_description = _('Article')