admin.py

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'<a href="%s">%s</a>' %
-            (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'<a href="%s">%s</a>' % (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”显示为“文章”