Django——后台管理

2024-02-22 23:41:04

1、要使用Django-admin后台的前提

INSTALLED_APPS = [
    'simpleui',
    'django.contrib.admin',        #必须有这一项
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog.apps.BlogConfig',
]

path('admin/', admin.site.urls)    #需要有admin的路由

2、访问后台页面

http://127.0.0.1:8000/admin/

3、创建管理员用户（超级用户）

命令行执行：

python manage.py createsuperuser

4、使用创建的管理员登录后台

5、添加数据库表到后台管理系统（此时展示的效果不太友好）

在app应用的admin.py文件中：

from django.contrib import admin
from blog.models import Article    #导入数据库表模型

admin.site.register(Article)       #把数据库表注册到后台中显示

6、让数据库表在后台更友好的展示（自定义）

在admin.py中定义一个类，类名为---- “模型类+Admin”，并注册这个类，如下：

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的界面和功能，如下是一些例子：

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）

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 完全是可选的）：

—— 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后台管理的标题

在admin.py中：

from django.contrib import admin
admin.site.site_header = '我的后台'

修改后如下：

9、修改后台的app名称

修改对应的app下的apps.py：

from django.apps import AppConfig

class BlogConfig(AppConfig):
    name = 'blog'
    verbose_name = '博客'   #app应用在后台显示的名称

10、Django的后台美化组件 ———— simpleui

pip install django-simpleui

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的上面

效果如下：

码农公寓

相关文章