diff --git a/src/DjangoBlog/comments/admin.py b/src/DjangoBlog/comments/admin.py
index dbde14f..54fea33 100644
--- a/src/DjangoBlog/comments/admin.py
+++ b/src/DjangoBlog/comments/admin.py
@@ -1,49 +1,81 @@
+# zy: 评论管理模块 - 配置Django后台管理中评论模型的显示和操作功能
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 _
+# zy: 禁用评论状态 - 管理员动作函数,用于批量禁用评论
def disable_commentstatus(modeladmin, request, queryset):
+ # zy: 将选中的评论集的is_enable字段更新为False(禁用)
queryset.update(is_enable=False)
+# zy: 启用评论状态 - 管理员动作函数,用于批量启用评论
def enable_commentstatus(modeladmin, request, queryset):
+ # zy: 将选中的评论集的is_enable字段更新为True(启用)
queryset.update(is_enable=True)
+# zy: 设置动作在后台显示的描述文字(支持国际化)
disable_commentstatus.short_description = _('Disable comments')
enable_commentstatus.short_description = _('Enable comments')
+# zy: 评论管理类 - 自定义Django后台的评论管理界面
class CommentAdmin(admin.ModelAdmin):
+ # zy: 设置列表页每页显示20条评论
list_per_page = 20
+
+ # zy: 定义列表页显示的字段列
list_display = (
- 'id',
- 'body',
- 'link_to_userinfo',
- 'link_to_article',
- 'is_enable',
- 'creation_time')
+ 'id', # zy: 评论ID
+ 'body', # zy: 评论内容
+ 'link_to_userinfo', # zy: 自定义方法 - 用户信息链接
+ 'link_to_article', # zy: 自定义方法 - 文章链接
+ 'is_enable', # zy: 是否启用状态
+ 'creation_time' # zy: 创建时间
+ )
+
+ # zy: 设置哪些字段可以作为链接点击进入编辑页
list_display_links = ('id', 'body', 'is_enable')
- list_filter = ('is_enable',)
+
+ # zy: 设置右侧过滤侧边栏的过滤条件
+ list_filter = ('is_enable',) # zy: 按启用状态过滤
+
+ # zy: 排除在编辑表单中显示的字段(系统自动管理的字段)
exclude = ('creation_time', 'last_modify_time')
+
+ # zy: 定义批量操作动作列表
actions = [disable_commentstatus, enable_commentstatus]
+
+ # zy: 设置使用弹出窗口选择关联对象的字段(优化性能)
raw_id_fields = ('author', 'article')
- search_fields = ('body',)
+ # zy: 设置可搜索的字段
+ search_fields = ('body',) # zy: 按评论内容搜索
+
+ # zy: 自定义方法 - 生成用户信息链接
def link_to_userinfo(self, obj):
+ # zy: 获取作者模型的app名称和模型名称
info = (obj.author._meta.app_label, obj.author._meta.model_name)
+ # zy: 生成作者编辑页面的URL
link = reverse('admin:%s_%s_change' % info, args=(obj.author.id,))
+ # zy: 返回HTML链接,显示用户昵称或邮箱
return format_html(
u'%s' %
(link, obj.author.nickname if obj.author.nickname else obj.author.email))
+ # zy: 自定义方法 - 生成文章链接
def link_to_article(self, obj):
+ # zy: 获取文章模型的app名称和模型名称
info = (obj.article._meta.app_label, obj.article._meta.model_name)
+ # zy: 生成文章编辑页面的URL
link = reverse('admin:%s_%s_change' % info, args=(obj.article.id,))
+ # zy: 返回HTML链接,显示文章标题
return format_html(
u'%s' % (link, obj.article.title))
+ # zy: 设置自定义方法在列表页显示的列标题(支持国际化)
link_to_userinfo.short_description = _('User')
- link_to_article.short_description = _('Article')
+ link_to_article.short_description = _('Article')
\ No newline at end of file