### Django Admin 自定义显示配置教程 #### 1. 注册模型到 Admin 后台 为了使自定义的模型能够在 Django 的 Admin 后台中展示，首先需要将其注册到 `admin.py` 文件中。通过继承 `ModelAdmin` 类，可以进一步定制化模型在后台中的表现形式。 以下是基本的注册方法： ```python from django.contrib import admin from .models import MyCustomModel class MyCustomModelAdmin(admin.ModelAdmin): list_display = ('field1', 'field2', 'field3') # 显示字段列表 search_fields = ['field1'] # 添加搜索框功能 list_filter = ('field2',) # 添加过滤器 admin.site.register(MyCustomModel, MyCustomModelAdmin) ``` 上述代码实现了以下功能[^1]: - **list_display**: 定义了哪些字段会在 Admin 列表页面上显示。 - **search_fields**: 提供了一个基于指定字段的快速搜索栏。 - **list_filter**: 增加右侧筛选面板的功能。 --- #### 2. 配置高级选项 除了基础设置外，还可以利用更多 `ModelAdmin` 属性来增强用户体验： ##### (a) 表单布局调整 可以通过 `fields`, `fieldsets` 和 `inlines` 来控制表单的具体结构和分组方式。 示例代码如下： ```python class AdvancedModelAdmin(admin.ModelAdmin): fieldsets = ( ("基本信息", { 'fields': ('name', 'description'), }), ("高级设置", { 'classes': ('collapse',), # 收起该部分，默认隐藏 'fields': ('config_field',) }) ) ``` 这里使用了 `fieldsets` 将不同类型的字段划分为多个区域，并支持折叠效果。 ##### (b) 动态计算列 如果希望某些数据不是直接存储于数据库而是动态生成，则可通过定义只读字段实现这一需求。 例子： ```python def get_custom_value(self, obj): return f"{obj.field1} - {obj.field2}" get_custom_value.short_description = "组合值" class CustomValueAdmin(admin.ModelAdmin): readonly_fields = ('get_custom_value',) list_display = ('field1', 'field2', 'get_custom_value') ``` 此段逻辑创建了一种新的虚拟列用于呈现复合型信息。 --- #### 3. 扩展插件工具 当默认提供的样式无法满足个性化需求时，可借助第三方库完成更深层次的设计改造工作。 ##### (a) 使用 `django-admin-tools` 安装完成后，在项目的 `settings.py` 中加入必要的模块即可激活额外特性，比如主题切换、导航菜单编辑以及仪表板重组等功能[^2]。 具体操作步骤如下所示： ```python INSTALLED_APPS += [ 'admin_tools', 'admin_tools.theming', # 主题扩展包 'admin_tools.menu', # 菜单管理组件 'admin_tools.dashboard' # 数据看板框架 ] ``` ##### (b) 替代方案——水平标签式导航条 对于偏好简洁直观风格的人来说，“django-admin-menu”不失为一种理想的选择。它能够把传统的垂直侧边栏替换成顶部横向排列的一系列按钮链接[^4]。 集成过程相对简便，只需按照官方指引修改模板路径及相关参数设定便能生效。 --- #### 总结 通过对 `ModelAdmin` 对象属性的有效运用加上适当引入外部依赖项，完全可以打造出既美观又实用的操作环境给最终用户带来更好的交互体验。