Django——后台管理
1、要使用Django-admin后台的前提
1 2 3 4 5 6 7 8 9 10 | INSTALLED_APPS = [ 'simpleui' , 'django.contrib.admin' , #必须有这一项 'django.contrib.auth' , 'django.contrib.contenttypes' , 'django.contrib.sessions' , 'django.contrib.messages' , 'django.contrib.staticfiles' , 'blog.apps.BlogConfig' , ] |
1 | path( 'admin/' , admin.site.urls) #需要有admin的路由 |
2、访问后台页面
1 | http: / / 127.0 . 0.1 : 8000 / admin / |
3、创建管理员用户(超级用户)
命令行执行:
1 | python manage.py createsuperuser |
4、使用创建的管理员登录后台
5、添加数据库表到后台管理系统(此时展示的效果不太友好)
在app应用的admin.py文件中:
1 2 3 4 | from django.contrib import admin from blog.models import Article #导入数据库表模型 admin.site.register(Article) #把数据库表注册到后台中显示 |
6、让数据库表在后台更友好的展示(自定义)
在admin.py中定义一个类,类名为---- “模型类+Admin”,并注册这个类,如下:
1 2 3 4 5 6 7 8 | from django.contrib import admin from blog.models import Article class ArticleAdmin(admin.ModelAdmin): #list_display表示:设置可显示的字段 list_display = ( 'title' , 'content' , 'author' , 'created_time' ) admin.site.register(Article,ArticleAdmin) |
除了list_display之外,这个ModelAdmin类还有很多功能,非常灵活,它有许多内置属性,帮助我们自定义admin的界面和功能,如下是一些例子:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | from django.contrib import admin from blog.models import Article class ArticleAdmin(admin.ModelAdmin): # list_per_page设置每页显示多少条记录,默认是100条 list_per_page = 50 # ordering设置默认排序字段,负号表示降序排序 # ordering = ('-name',) # 操作项功能显示位置设置,两个都为True则顶部和底部都显示 actions_on_top = True actions_on_bottom = True # 操作项功能显示选中项的数目 actions_selection_counter = True # 字段为空值显示的内容 empty_value_display = ' -空白- ' # list_editable 设置默认可编辑字段 list_editable = [ 'TEL' , 'member_type' ,] # fk_fields 设置显示外键字段 fk_fields = ( 'member_type' ,) # 过滤器功能及能过滤的字段 list_filter = ( 'name' , 'member_type' ) # 搜索功能及能实现搜索的字段 search_fields = ( 'name' , 'TEL' , ) # 补充: # 默认情况下,更改列表页面会只将第一列链接到每个项目的更改页面。 # 使用 list_display_links 可以控制 list_display 中的字段是否应该链接到对象的“更改”页面。 # 它的使用格式和 list_display 相同,是是列表或者元组类型。 # 同时它也可以指定一个或多个字段。只要这些字段在中 list_display 中存在 ,那么 Django 就不会在意链接了多少个字段。 # 注意:要使用 list_display_links 这个属性 ,必须先要定义 list_display。 admin.site.register(Article,ArticleAdmin) |
7、模型models.py中定义时关于后台的相关配置
(1)在模型类中定义一个字段在后台页面的显示内容(verbose_name)
1 2 3 4 5 | class Article(models.Model): title = models.CharField(max_length = 70 ,verbose_name = '文章标题' ) content = models.TextField(verbose_name = '正文' ) author = models.ForeignKey(to = User,on_delete = models.CASCADE,verbose_name = '作者' ) created_time = models.DateTimeField(auto_now_add = True ,verbose_name = '发布时间' ) |
(2)模型类下的class Meta(下面是所有可能用到的 Meta 选项,没有一个选项是必需的. 是否添加 class Meta 到你的 model 完全是可选的):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 | —— app_label: app_label这个选项只在一种情况下使用,就是你的模型类不在默认的应用程序包下的models.py文件中,这时候你需要指定你这个模型类是那个应用程序的。比如你在其他地方写了一个模型类,而这个模型类是属于myapp的,那么你这是需要指定为: app_label = 'myapp' —— db_table: db_table是用于指定自定义数据库表名的。Django有一套默认的按照一定规则生成数据模型对应的数据库表名,如果你想使用自定义的表名,就通过这个属性指定,比如: table_name = 'my_owner_table' —— db_tablespace: 有些数据库有数据库表空间,比如Oracle。你可以通过db_tablespace来指定这个模型对应的数据库表放在哪个数据库表空间。 —— get_latest_by: 由于Django的管理方法中有个lastest()方法,就是得到最近一行记录。如果你的数据模型中有 DateField 或 DateTimeField 类型的字段,你可以通过这个选项来指定lastest()是按照哪个字段进行选取的。 一个 DateField 或 DateTimeField 字段的名字. 若提供该选项, 该模块将拥有一个 get_latest() 函数以得到 "最新的" 对象(依据那个字段): get_latest_by = "order_date" —— managed: 由于Django会自动根据模型类生成映射的数据库表,如果你不希望Django这么做,可以把managed的值设置为 False 。 默认值为 True ,这个选项为 True 时Django可以对数据库表进行 migrate或migrations、删除等操作。在这个时间Django将管理数据库中表的生命周期 如果为 False 的时候,不会对数据库表进行创建、删除等操作。可以用于现有表、数据库视图等,其他操作是一样的。 —— order_with_respect_to: 这个选项一般用于多对多的关系中,它指向一个关联对象。就是说关联对象找到这个对象后它是经过排序的。指定这个属性后你会得到一个get_XXX_order()和set_XXX_order()的方法,通过它们你可以设置或者回去排序的对象。 举例来说, 如果一个 PizzaToppping 关联到一个 Pizza 对象, 这样做: order_with_respect_to = 'pizza' ...就允许 toppings 依照相关的 pizza 来排序。 —— ordering: 这个字段是告诉Django模型对象返回的记录结果集是按照哪个字段排序的。比如下面的代码(需要注意的是:不论你使用了多少个字段排序, admin 只使用第一个字段): ordering = [ 'order_date' ] # 按订单升序排列 ordering = [ '-order_date' ] # 按订单降序排列,-表示降序 ordering = [ '?order_date' ] # 随机排序,?表示随机 ordering = [ '-pub_date' , 'author' ] # 对 pub_date 降序,然后对 author 升序 —— permissions: permissions主要是为了在Django Admin管理模块下使用的,如果你设置了这个属性可以让指定的方法权限描述更清晰可读。 要创建一个对象所需要的额外的权限. 如果一个对象有 admin 设置, 则每个对象的添加,删除和改变权限会人(依据该选项)自动创建.下面这个例子指定了一个附加权限: can_deliver_pizzas: permissions = (( "can_deliver_pizzas" , "Can deliver pizzas" ),) 这是一个 2 - 元素 tuple 的 tuple 或列表, 其中两 2 - 元素 tuple 的格式为:(permission_code, human_readable_permission_name). —— unique_together: unique_together这个选项用于:当你需要通过两个字段保持唯一性时使用。这会在 Django admin 层和数据库层同时做出限制(也就是相关的 UNIQUE 语句会被包括在 CREATE TABLE 语句中)。比如:一个Person的FirstName和LastName两者的组合必须是唯一的,那么需要这样设置: unique_together = (( "first_name" , "last_name" ),) —— verbose_name: verbose_name的意思很简单,就是给你的模型类起一个更可读的名字: verbose_name = "pizza" —— verbose_name_plural: 这个选项是指定,模型的复数形式是什么,比如: verbose_name_plural = "stories" |
8、修改Django后台管理的标题
1 2 3 4 | 在admin.py中: from django.contrib import admin admin.site.site_header = '我的后台' |
修改后如下:
9、修改后台的app名称
修改对应的app下的apps.py:
1 2 3 4 5 | from django.apps import AppConfig class BlogConfig(AppConfig): name = 'blog' verbose_name = '博客' #app应用在后台显示的名称 |
10、Django的后台美化组件 ———— simpleui
1 | pip install django - simpleui |
1 2 3 4 5 6 7 8 9 10 11 12 | INSTALLED_APPS = [ 'simpleui' , 'django.contrib.admin' , 'django.contrib.auth' , 'django.contrib.contenttypes' , 'django.contrib.sessions' , 'django.contrib.messages' , 'django.contrib.staticfiles' , 'blog.apps.BlogConfig' , ] # simpleui必须放在admin的上面 |
效果如下:
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· AI与.NET技术实操系列:基于图像分类模型对图像进行分类
· go语言实现终端里的倒计时
· 如何编写易于单元测试的代码
· 10年+ .NET Coder 心语,封装的思维:从隐藏、稳定开始理解其本质意义
· .NET Core 中如何实现缓存的预热?
· 分享一个免费、快速、无限量使用的满血 DeepSeek R1 模型,支持深度思考和联网搜索!
· 基于 Docker 搭建 FRP 内网穿透开源项目(很简单哒)
· ollama系列01:轻松3步本地部署deepseek,普通电脑可用
· 25岁的心里话
· 按钮权限的设计及实现