#hz 评论模块的Django后台管理配置
#hz 本模块配置了评论模型在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 _


#hz 批量禁用评论的管理动作函数
#hz 将选中的评论设置为不可见（is_enable=False）
def disable_commentstatus(modeladmin, request, queryset):
    #hz 批量更新选中评论的is_enable字段为False
    queryset.update(is_enable=False)


#hz 批量启用评论的管理动作函数
#hz 将选中的评论设置为可见（is_enable=True）
def enable_commentstatus(modeladmin, request, queryset):
    #hz 批量更新选中评论的is_enable字段为True
    queryset.update(is_enable=True)


#hz 设置批量禁用评论动作的显示名称
disable_commentstatus.short_description = _('Disable comments')
#hz 设置批量启用评论动作的显示名称
enable_commentstatus.short_description = _('Enable comments')


#hz 评论模型的后台管理类
#hz 配置评论在Django管理后台的显示方式、过滤选项、搜索字段和批量操作
class CommentAdmin(admin.ModelAdmin):
    #hz 每页显示的评论数量
    list_per_page = 20
    #hz 列表页显示的字段列
    list_display = (
        'id',
        'body',
        'link_to_userinfo',
        'link_to_article',
        'is_enable',
        'creation_time')
    #hz 列表页可点击的字段链接（点击可进入编辑页面）
    list_display_links = ('id', 'body', 'is_enable')
    #hz 列表页右侧的过滤选项，可按is_enable字段进行过滤
    list_filter = ('is_enable',)
    #hz 编辑页面中排除的字段（不显示在编辑表单中）
    #hz creation_time和last_modify_time通常由系统自动管理，不需要手动编辑
    exclude = ('creation_time', 'last_modify_time')
    #hz 可用的批量操作动作列表
    actions = [disable_commentstatus, enable_commentstatus]
    #hz 使用原始ID字段的选择器（用于外键字段，避免加载所有相关对象）
    #hz 当关联对象数量很大时，使用raw_id_fields可以提升性能
    raw_id_fields = ('author', 'article')
    #hz 可搜索的字段列表，支持按评论正文内容进行搜索
    search_fields = ('body',)

    #hz 生成指向用户信息管理页面的链接
    #hz 在列表页显示评论作者的可点击链接，点击后跳转到用户编辑页面
    def link_to_userinfo(self, obj):
        #hz 获取作者对象的应用标签和模型名称
        info = (obj.author._meta.app_label, obj.author._meta.model_name)
        #hz 生成用户编辑页面的URL
        link = reverse('admin:%s_%s_change' % info, args=(obj.author.id,))
        #hz 返回HTML格式的链接，显示用户的昵称或邮箱
        return format_html(
            u'<a href="%s">%s</a>' %
            (link, obj.author.nickname if obj.author.nickname else obj.author.email))

    #hz 生成指向文章管理页面的链接
    #hz 在列表页显示评论关联文章的可点击链接，点击后跳转到文章编辑页面
    def link_to_article(self, obj):
        #hz 获取文章对象的应用标签和模型名称
        info = (obj.article._meta.app_label, obj.article._meta.model_name)
        #hz 生成文章编辑页面的URL
        link = reverse('admin:%s_%s_change' % info, args=(obj.article.id,))
        #hz 返回HTML格式的链接，显示文章的标题
        return format_html(
            u'<a href="%s">%s</a>' % (link, obj.article.title))

    #hz 设置link_to_userinfo字段在列表页的列标题
    link_to_userinfo.short_description = _('User')
    #hz 设置link_to_article字段在列表页的列标题
    link_to_article.short_description = _('Article')
