Django Admin之常用功能汇总
1.字段支持下拉搜索框
1）在admin中新增字段autocomplete_fields
autocomplete_fields = ("field1","field2") 注意：field1,field2字段需要的是外键字段
2）field1,field2字段需要在model中添加类属性search_fields
search_fields = ('name', ) 注意：name为field1或field2对应表中要进行搜索的字段
2.字段支持自定义颜色选择器
1）安装python扩展
pip install django-colorfield
生成静态文件
python manage.py collectstatic
2) 配置文件settings.py ， 添加配置项
在INSTALLED_APPS中添加 INSTALLED_APPS = [ ... 'colorfield', ... ]
3) 在model.py中添加字段支持
from django.db import models from colorfield.fields import ColorField class ComputerRoom(models.Model): name = models.CharField(max_length=256,verbose_name = "名称") abbr = models.CharField(max_length=128, blank=True, null=True,verbose_name = "缩写") type = models.CharField(max_length=256,verbose_name='类型', choices=typeChoices) color = ColorField(default='#FF0000',verbose_name='显示颜色')
然后在Django后台打开对应的模块就可以看到颜色选择器了。
3.自定义菜单
左侧可折叠菜单是Simple UI系统默认菜单，根据已注册的应用和模型自动生成，其中父级菜单是App名，子菜单一般是所属App的各个模型名。SimpleUI甚至会自动为你分配默认图标，比如本例的tasks的应用使用了font-awsome的fa fa-tasks。在大多数情况下，Simple UI系统默认菜单不能满足需求，这时你就需要自定义菜单了，比如添加新的选项或给菜单选项分配新的图标。
修改settings.py, 添加如下代码：
SIMPLEUI_CONFIG = { # 是否使用系统默认菜单，自定义菜单时建议关闭。 'system_keep': False, # 用于菜单排序和过滤, 不填此字段为默认排序和全部显示。空列表[] 为全部不显示. 'menu_display': ['任务管理', '权限认证'], # 设置是否开启动态菜单, 默认为False. 如果开启, 则会在每次用户登陆时刷新展示菜单内容。 # 一般建议关闭。 'dynamic': False, 'menus': [ { 'app': 'auth', 'name': '权限认证', 'icon': 'fas fa-user-shield', 'models': [ { 'name': '用户列表', 'icon': 'fa fa-user', 'url': 'auth/user/' }, { 'name': '用户组', 'icon': 'fa fa-th-list', 'url': 'auth/group/' } ] }, { 'name': '任务管理', 'icon': 'fa fa-th-list', 'models': [ { 'name': '任务列表', # 注意url按'/admin/应用名/模型名小写/'命名。 'url': '/admin/tasks/task/', 'icon': 'fa fa-tasks' }, ] }, ] }
自定义菜单效果如下所示。我们更改了SimpleUI默认分配的图标。你还可以随意增减菜单选项并对其进行排序:
查找相关图标：https://fontawesome.com/v5.15/icons?d=gallery&p=2
4.
一般测试环境会使用migrate来添加新的字段或者表， 但是线上一般不会使用命令直接操作，以防引起不可预知的问题， 这个时候就可以手动的将测试服的相关表变更同步到生产环境
尤其是使用的admin后台的时候， 依赖他本身的权限管理这一套， 涉及表：
django_content_type: 添加对应app_label和model记录
auth_permission: 添加对应操作项（Can add xxx,Can change xxx, Can delete xxx, Can view xxx）
5. 禁用编辑链接和添加，修改， 删除操作
在admin.py文件的具体类中 class MyModelAdmin(models.ModelAdmin): ... List_display_links = None #禁用编辑链接 def has_add_permission(self, request): # 禁用添加按钮 return False def has_delete_permission(self, request, obj=None): # 禁用删除按钮 return False def has_change_permission(self, request, obj=None): # 禁用修改按钮 return False def get_actions(self, request): # 在actions中去掉‘删除’操作 actions = super(GradesManagementAdmin, self).get_actions(request) if request.user.username[0].upper() != 'J': if 'delete_selected' in actions: del actions['delete_selected'] return actions
需要注意的是，这种禁用编辑链接的放法只是不让它在页面中显示，即把超链接去掉了，但是还是可以通过手动输入url的方式来进入编辑页面。不过可以配合设置fieldsets或者readonly_fieldss来达到目的。
6.常用设置项
1）展示模型字段
list_display= ('id', 'uid',)
2）设置隐藏信息
fieldsets = () fieldsets = ( ('职业信息', {'fields': ('job','title',)}), ('人员信息', { 'classes': ('collapse',), 'fields':('person',), }) )
3)将下拉框改成单选按钮
admin.HORIZONTAL 水平排列 admin.VERTICAL 垂直排列 radio_fields = ('person': admin.HORIZONTAL)
4).设置不可编辑字段
readonly_fields = [] readonly_fields = ['job']
5).设置升降序
ordering = [] ordering = ['id'] 默认是升序，降序为 ordering = ['-id']
6).设置字段可以排序显示 sortable_by = []
sortable_by = ['job','title']
7).为字段设置路由地址，点击即进入修改页面 list_display_links=[]
list_display_links = ['id','job']
8）设置过滤器 list_filter = []
list_filter = ['job','title']
9)设置每一个的数量
设置每一页的数据量 list_per_page = 100 设置每一个的最大数据量 list_max_show_all = 200
10)设置字段可编辑 list_editable =[]
list_editable = ['title']
11)设置可搜索字段search_fields=[]
search_fields = ['job']
12)修改/admin页面的index的title
在APP文件下的__init__.py
13)修改中文字段中多处的‘s’
models.py中添加verbose_name_plural
14）后台文字描述修改
后台网页title修改 APP下的urls.py 最后添加
admin.site.site_title = '后台标题' admin.site.site_header = '后台头部'
admin.site.index_title = '后台首页标题'
7, 文件上传并支持将docx文档内容转化为HTML
配置文件添加媒体路径:
MEDIA_ROOT = os.path.join(BASE_DIR, "uploads")
目录结构:
models.py
from django.db import models from django.core import validators from tinymce.models import HTMLField from colorfield.fields import ColorField class UserAgreement(models.Model): AGREE_TYPES = ( (1, '收集个人信息'), (2, '共享个人信息'), (3, '隐私协议'), (4, '服务协议'), ) appid = models.ForeignKey(Game, db_column='appid', null=True, default=0, on_delete=models.SET_NULL, verbose_name='游戏') type = models.IntegerField(default=0, choices=AGREE_TYPES, blank=True, verbose_name='类型') content = HTMLField('内容') background_color = ColorField(max_length=32, null=True, default='#fef9db', verbose_name='背景色') upload_file = models.FileField(upload_to='', null=False, default='', validators=[ validators.FileExtensionValidator(['docx', 'doc', 'pdf'], message='请上传正确格式的文件') ], verbose_name='上传文件', help_text='支持上传的文件格式:pdf,doc,docx') search_fields = ('appid',) def __str__(self): return self.content class Meta: db_table = "user_agreement" verbose_name = verbose_name_plural = "用户相关协议表"
安装docx转换HTML包pydocx
pip install pydocx
admin.php 文件
from django.contrib import admin from .models import * @admin.register(UserAgreement) class UserAgreementAdmin(admin.ModelAdmin): list_display = ('appid', 'type', 'content', 'background_color') list_filter = ('appid',) list_per_page = 10 autocomplete_fields = ('appid', ) def save_model(self, request, obj, form, change): file = request.FILES.get('upload_file') if file: html = PyDocX.to_html(file) obj.content = html cache_key = RedisKey.USER_AGREEMENT.format(obj.appid_id, obj.type) delete_cache(cache_key) super().save_model(request, obj, form, change)
展示效果:
参考：Django实战: 手把手教你配置Django SimpleUI打造美丽后台(多图) - 知乎 (zhihu.com)
