|
|
# 导入Django表单模块，用于创建自定义表单
|
|
|
from django import forms
|
|
|
# 导入Django admin模块，用于配置后台管理界面
|
|
|
from django.contrib import admin
|
|
|
# 导入Django用户模型获取工具，兼容自定义用户模型场景
|
|
|
from django.contrib.auth import get_user_model
|
|
|
# 导入Django URL反向解析模块，用于生成后台管理页面的链接
|
|
|
from django.urls import reverse
|
|
|
# 导入Django HTML格式化工具，用于在后台显示自定义HTML内容（如链接）
|
|
|
from django.utils.html import format_html
|
|
|
# 导入Django国际化翻译工具，用于实现后台文字的多语言支持
|
|
|
from django.utils.translation import gettext_lazy as _
|
|
|
|
|
|
# 注册自定义模型到admin后台的标识注释（固定写法）
|
|
|
# Register your models here.
|
|
|
# 从当前应用的models.py文件中导入Article模型（文章模型）
|
|
|
from .models import Article
|
|
|
|
|
|
|
|
|
# 自定义Article模型的列表页过滤器，继承自Django内置的SimpleListFilter
|
|
|
class ArticleListFilter(admin.SimpleListFilter):
|
|
|
# 过滤器在后台页面显示的标题（支持国际化），这里是“作者”
|
|
|
title = _("author")
|
|
|
# 过滤器对应的URL参数名，用于URL中传递过滤条件（如?author=1）
|
|
|
parameter_name = 'author'
|
|
|
|
|
|
# 定义过滤器的选项列表，返回（值, 显示文本）格式的元组
|
|
|
def lookups(self, request, model_admin):
|
|
|
# 1. 从Article模型中获取所有文章的作者，用set去重（避免同一作者多次出现）
|
|
|
# 2. 转换为list便于遍历，map函数提取每篇文章的author字段
|
|
|
authors = list(set(map(lambda x: x.author, Article.objects.all())))
|
|
|
# 遍历去重后的作者列表，生成过滤器选项
|
|
|
for author in authors:
|
|
|
# 选项值为作者ID（用于数据库查询），显示文本为作者用户名（支持国际化）
|
|
|
yield (author.id, _(author.username))
|
|
|
|
|
|
# 根据过滤器选择的参数，过滤文章查询集（queryset）
|
|
|
def queryset(self, request, queryset):
|
|
|
# 获取当前过滤器选中的参数值（即作者ID）
|
|
|
id = self.value()
|
|
|
# 如果有选中的作者ID，返回该作者的所有文章
|
|
|
if id:
|
|
|
return queryset.filter(author__id__exact=id)
|
|
|
# 如果未选中任何作者，返回全部文章查询集
|
|
|
else:
|
|
|
return queryset
|
|
|
|
|
|
|
|
|
# 自定义Article模型的表单类，继承自Django内置的ModelForm
|
|
|
class ArticleForm(forms.ModelForm):
|
|
|
# 注释：此处原本计划使用AdminPagedownWidget富文本编辑器渲染body字段，暂未启用
|
|
|
# body = forms.CharField(widget=AdminPagedownWidget())
|
|
|
|
|
|
# 表单元数据配置类，用于关联模型与字段
|
|
|
class Meta:
|
|
|
# 关联的模型为Article（表示该表单用于操作Article模型数据）
|
|
|
model = Article
|
|
|
# 表单包含模型的所有字段（__all__为通配符，也可指定具体字段列表）
|
|
|
fields = '__all__'
|
|
|
|
|
|
|
|
|
# 自定义批量操作函数：将选中的文章状态设为“已发布”（假设status='p'代表发布）
|
|
|
def makr_article_publish(modeladmin, request, queryset):
|
|
|
# 批量更新选中的文章查询集，将status字段设为'p'
|
|
|
queryset.update(status='p')
|
|
|
|
|
|
|
|
|
# 自定义批量操作函数：将选中的文章状态设为“草稿”（假设status='d'代表草稿）
|
|
|
def draft_article(modeladmin, request, queryset):
|
|
|
# 批量更新选中的文章查询集，将status字段设为'd'
|
|
|
queryset.update(status='d')
|
|
|
|
|
|
|
|
|
# 自定义批量操作函数：关闭选中文章的评论功能（假设comment_status='c'代表关闭）
|
|
|
def close_article_commentstatus(modeladmin, request, queryset):
|
|
|
# 批量更新选中的文章查询集，将comment_status字段设为'c'
|
|
|
queryset.update(comment_status='c')
|
|
|
|
|
|
|
|
|
# 自定义批量操作函数：开启选中文章的评论功能（假设comment_status='o'代表开启）
|
|
|
def open_article_commentstatus(modeladmin, request, queryset):
|
|
|
# 批量更新选中的文章查询集，将comment_status字段设为'o'
|
|
|
queryset.update(comment_status='o')
|
|
|
|
|
|
|
|
|
# 为批量操作函数设置后台显示名称（支持国际化），显示在“动作”下拉菜单中
|
|
|
makr_article_publish.short_description = _('Publish selected articles') # “发布选中的文章”
|
|
|
draft_article.short_description = _('Draft selected articles') # “将选中的文章设为草稿”
|
|
|
close_article_commentstatus.short_description = _('Close article comments') # “关闭选中文章的评论”
|
|
|
open_article_commentstatus.short_description = _('Open article comments') # “开启选中文章的评论”
|
|
|
|
|
|
|
|
|
# 自定义Article模型的Admin配置类，继承自Django内置的ModelAdmin
|
|
|
class ArticlelAdmin(admin.ModelAdmin):
|
|
|
# 后台列表页每页显示的文章数量，这里是20条/页
|
|
|
list_per_page = 20
|
|
|
# 后台列表页的搜索框配置，支持搜索文章的“内容（body）”和“标题（title）”字段
|
|
|
search_fields = ('body', 'title')
|
|
|
# 后台添加/编辑文章时使用的自定义表单，即上面定义的ArticleForm
|
|
|
form = ArticleForm
|
|
|
# 后台列表页显示的字段列表，按顺序展示
|
|
|
list_display = (
|
|
|
'id', # 文章ID
|
|
|
'title', # 文章标题
|
|
|
'author', # 文章作者
|
|
|
'link_to_category', # 自定义字段：文章分类（带跳转链接）
|
|
|
'creation_time', # 文章创建时间
|
|
|
'views', # 文章浏览量
|
|
|
'status', # 文章状态（发布/草稿等）
|
|
|
'type', # 文章类型（如原创/转载等，需在Article模型中定义）
|
|
|
'article_order' # 文章排序权重（用于自定义排序）
|
|
|
)
|
|
|
# 后台列表页中，点击哪些字段可以跳转到文章编辑页
|
|
|
list_display_links = ('id', 'title')
|
|
|
# 后台列表页的过滤器配置，包含自定义的作者过滤器和内置字段过滤器
|
|
|
list_filter = (ArticleListFilter, 'status', 'type', 'category', 'tags')
|
|
|
# 多对多字段（tags标签）的编辑界面样式，使用水平选择框（默认是垂直）
|
|
|
filter_horizontal = ('tags',)
|
|
|
# 后台添加/编辑文章时，隐藏的字段（不允许管理员手动修改）
|
|
|
exclude = ('creation_time', 'last_modify_time')
|
|
|
# 是否显示“在站点上查看”按钮（跳转到文章的前台页面）
|
|
|
view_on_site = True
|
|
|
# 后台列表页的批量操作功能列表，关联上面定义的4个批量操作函数
|
|
|
actions = [
|
|
|
makr_article_publish,
|
|
|
draft_article,
|
|
|
close_article_commentstatus,
|
|
|
open_article_commentstatus]
|
|
|
|
|
|
# 自定义列表页字段：显示文章分类，并添加跳转到分类编辑页的链接
|
|
|
def link_to_category(self, obj):
|
|
|
# 1. 获取文章分类（obj.category）的模型元数据（应用名、模型名）
|
|
|
# 2. 用于生成admin后台分类编辑页的URL
|
|
|
info = (obj.category._meta.app_label, obj.category._meta.model_name)
|
|
|
# 3. 反向解析分类编辑页的URL，参数为分类ID（obj.category.id）
|
|
|
link = reverse('admin:%s_%s_change' % info, args=(obj.category.id,))
|
|
|
# 4. 生成HTML链接，显示分类名称，点击跳转到分类编辑页
|
|
|
return format_html(u'<a href="%s">%s</a>' % (link, obj.category.name))
|
|
|
|
|
|
# 自定义字段“link_to_category”在后台列表页的显示标题（支持国际化）
|
|
|
link_to_category.short_description = _('category')
|
|
|
|
|
|
# 重写获取表单的方法，自定义作者字段（author）的可选值
|
|
|
def get_form(self, request, obj=None, **kwargs):
|
|
|
# 1. 先调用父类的get_form方法，获取默认表单
|
|
|
form = super(ArticlelAdmin, self).get_form(request, obj, **kwargs)
|
|
|
# 2. 限制作者字段的可选范围：仅显示超级用户（is_superuser=True）
|
|
|
form.base_fields['author'].queryset = get_user_model(
|
|
|
).objects.filter(is_superuser=True)
|
|
|
# 3. 返回修改后的表单
|
|
|
return form
|
|
|
|
|
|
# 重写保存模型的方法（此处未修改逻辑，仅保留父类功能，便于后续扩展）
|
|
|
def save_model(self, request, obj, form, change):
|
|
|
# 调用父类的save_model方法，完成默认的保存逻辑（如更新时间、权限验证等）
|
|
|
super(ArticlelAdmin, self).save_model(request, obj, form, change)
|
|
|
|
|
|
# 重写“在站点上查看”的链接地址，跳转到文章的前台完整URL
|
|
|
def get_view_on_site_url(self, obj=None):
|
|
|
# 如果有具体的文章对象（obj不为空），调用文章模型的get_full_url方法获取前台URL
|
|
|
if obj:
|
|
|
url = obj.get_full_url()
|
|
|
return url
|
|
|
# 如果没有文章对象（如在列表页顶部的“查看站点”按钮），返回当前站点的域名
|
|
|
else:
|
|
|
# 从自定义工具模块导入获取当前站点的函数（需确保djangoblog.utils存在）
|
|
|
from djangoblog.utils import get_current_site
|
|
|
# 获取当前站点的域名（如www.example.com）
|
|
|
site = get_current_site().domain
|
|
|
return site
|
|
|
|
|
|
|
|
|
# 自定义Tag模型（标签模型）的Admin配置类（假设Tag模型在models.py中定义）
|
|
|
class TagAdmin(admin.ModelAdmin):
|
|
|
# 后台添加/编辑标签时，隐藏的字段（不允许手动修改）
|
|
|
exclude = ('slug', 'last_mod_time', 'creation_time')
|
|
|
|
|
|
|
|
|
# 自定义Category模型（分类模型）的Admin配置类（假设Category模型在models.py中定义）
|
|
|
class CategoryAdmin(admin.ModelAdmin):
|
|
|
# 后台分类列表页显示的字段：分类名称、父分类、排序索引
|
|
|
list_display = ('name', 'parent_category', 'index')
|
|
|
# 后台添加/编辑分类时，隐藏的字段（不允许手动修改）
|
|
|
exclude = ('slug', 'last_mod_time', 'creation_time')
|
|
|
|
|
|
|
|
|
# 自定义Links模型（友情链接模型）的Admin配置类（假设Links模型在models.py中定义）
|
|
|
class LinksAdmin(admin.ModelAdmin):
|
|
|
# 后台添加/编辑友情链接时，隐藏的字段（不允许手动修改）
|
|
|
exclude = ('last_mod_time', 'creation_time')
|
|
|
|
|
|
|
|
|
# 自定义SideBar模型（侧边栏模型）的Admin配置类（假设SideBar模型在models.py中定义）
|
|
|
class SideBarAdmin(admin.ModelAdmin):
|
|
|
# 后台侧边栏列表页显示的字段：名称、内容、是否启用、排序序号
|
|
|
list_display = ('name', 'content', 'is_enable', 'sequence')
|
|
|
# 后台添加/编辑侧边栏时，隐藏的字段（不允许手动修改）
|
|
|
exclude = ('last_mod_time', 'creation_time')
|
|
|
|
|
|
|
|
|
# 自定义BlogSettings模型（博客设置模型）的Admin配置类（假设BlogSettings模型在models.py中定义）
|
|
|
class BlogSettingsAdmin(admin.ModelAdmin):
|
|
|
# 空配置，使用ModelAdmin的默认功能（如需自定义可后续添加字段）
|
|
|
pass |
