『Django』自带的后台

theme: smartblue

本文简介

点赞 + 关注 + 收藏 = 学会了

上一篇讲了 Django 操作 MySQL 的方法，讲了如何创建模型，如何对数据库做增删改查的操作。但每次修改数据都要写代码，多少有点麻烦。

有没有简单一点的方法呢？

有的有的，Django 其实自带了一个后台，是图形界面的，你可以在上面很方便的操作各种数据内容。

接下来就讲讲这个自带的后台怎么用。

配置后台路由地址

其实在创建 Django 项目时就已经帮我们把后台的路由地址配置好了。

如果你是跟着我前面的文章一步步做的话，可能后台路由会被删掉。没关系，补回去就好了。

打开项目的 urls.py 文件，找到 urlpatterns 这个变量，把后台路由补上。

```python

urls.py 项目的路由文件

from django.urls import path from blog.views import blogIndex

urlpatterns = [ # 省略了其他路由 # 下面这句才是配置后台的路由 path('admin/', admin.site.urls) ] ```

配置完成后，启动项目，在浏览器打开 http://127.0.0.1:8000/admin/ 就能看到后台的登录页面。

创建管理员账号

有登录页面，那就要有对应的账号才能登录上去。

所以我们要先创建一个超管账号。

打开终端，进入项目目录，输入以下这条命令创建超管账号。

python manage.py createsuperuser

然后终端会返回这一行信息给你，让你输入超管的用户名(账号)

Username (leave blank to use 'xxx'): admin

这里的'xxx'是我的计算机名字，你在冒号后面输入超管的账号即可。这里我输入的是 admin。

输入完用户名后，它会继续让你输入邮箱。

Email address: 123@qq.com

输入完邮箱会让你输入2次密码。

Password: 
Password (again):

我这里输入的密码是 12345678，它很智能的提醒我的密码太常见了，但我输入 y ，坚持使用这么简单的密码。

This password is too common.
This password is entirely numeric.
Bypass password validation and create user anyway? [y/N]: y
Superuser created successfully.

看到 Superuser created successfully. 这句就表示账号创建成功了。

此时在浏览器打开 http://127.0.0.1:8000/admin/，账号输入 admin，密码输入 12345678 就能登录成功。

模型关联后台

我们前面都是使用代码的方式去操作数据库，不是那么方便。

Django 提供了一种方式，让我们将应用的模型和后台绑定，这样就可以在后台界面里直接操作数据了。

以上一篇文章创建的 account 应用为例。

在 account 应用中找到 admin.py 文件，写入以下代码。

```python

account/admin.py

from django.contrib import admin from account.models import User

class UserAdmin(admin.ModelAdmin): # 要展示的内容 list_display = ['username', 'email']

将 User 模型绑定到 UserAdmin

admin.site.register(User, UserAdmin) ```

这里需要先引入 admin 和 User，因为我们要将 account 应用的模型和后台关联起来。

创建一个名为 UserAdmin 的类，在里面写明 list_display = ['username', 'email'] ，意思是要在后台页面显示 username 和 email 这两个字段。

最后 admin.site.register(User, UserAdmin) 的意思是将 User 模型和后台绑定在一起。

运行项目，打开 http://127.0.0.1:8000/admin/ 并登录，就能看到刚刚绑定的模型了。

点击“用户表s”会看到在数据库中这个表的信息。

可以点击“Add”按钮在这个表里新增数据。

也可以对指定数据进行修改、删除操作。

后台页面修改完的数据会直接影响到数据库里的数据的。

以同样的方式，把 blog 应用的模型和后台关联起来。这里的操作和前面是相同的，我就不再重复讲解了。

```python

blog/admin.py

from django.contrib import admin from blog.models import Article

Register your models here.

class ArticleAdmin(admin.ModelAdmin): # 要展示的内容 list_display = ['id', 'title']

将 User 模型绑定到 UserAdmin

admin.site.register(Article, ArticleAdmin) ```

我们创建一篇文章看看。

点击“文章信息表s”旁边的Add按钮，然后填写好以下内容。

点击 SAVE 按钮后就将数据写入到数据库了，回到“文章信息表s”的列表页就能看到刚刚写入的数据。

如果不太清楚整个项目的内容，可以看回我整理的《Django专栏》。

后台的基础配置

在前面的操作中，细心的工友可能已经留意到一些问题，比如界面怎么是英文的？为什么表名后面会有个“s”？为什么创建文章的时候User这个字段可选的不是用户名，而是 User object(1)？

接下来我们把这些问题一个个解决。

设置时区和语言

打开项目的 settings.py 文件，找到 LANGUAGE_CODE ，将它的值设置为 'zh-hans'。然后再找到 TIME_ZONE 将其设置为 Asia/Shanghai。

```python

settings.py

语言

LANGUAGE_CODE = 'zh-hans'

时区

TIME_ZONE = 'Asia/Shanghai' ```

将栏目名改成中文

但此时 ACCOUNT 和 BLOG 仍然是英文的，这里 Django 是不能直接将其翻译成中文，需要你给这两个应用配置别名。

配置的地方在各个应用自身的 apps.py 文件里，通过 verbose_name 变量来自定义栏目名称。

以 account 应用为例。

```python

account/apps.py

from django.apps import AppConfig

class AccountConfig(AppConfig): defaultautofield = 'django.db.models.BigAutoField' name = 'account' verbose_name = '用户管理' ```

blog 应用同理。

```python

blog/apps.py

from django.apps import AppConfig

class BlogConfig(AppConfig): defaultautofield = 'django.db.models.BigAutoField' name = 'blog' verbose_name = '文章管理' ```

此时再刷新页面就能看到栏目名称被改过来了。

删除复数形式

表名后面的“s“是 Django 自带的，要删掉这个“s”同样需要配置表的别名。

在各个应用的模型文件(models.py)里配置 Meta 信息的 verbose_name_plural。

以 account 应用为例。

```python

account/models.py

from django.db import models

创建一个用户表

class User(models.Model): id = models.AutoField(primarykey=True) # 用户名 username = models.CharField('用户名', maxlength=30, null=True, blank=True, unique=True) # 密码 password = models.CharField('密码', max_length=30) # 邮箱 email = models.EmailField('邮箱', unique=True, null=True, blank=True)

class Meta:# 自定义表名db_table = 'user'# 表别名verbose_name = '用户表'verbose_name_plural = '用户表'

```

刷新一下页面就能看到“用户表”后面的“s”没了。

blog 同理。

展示外键字段

我们在添加文章的时候需要输入选择文章作者，文章表的作者是关联了用户表的。

在添加作者的时候页面直接展示了“User object”这种名字，用户数量一多的话我们就分不清谁是谁了。

我们应该将用户名展示出来。

这里我们先修改一下 blog 要展示的字段。

```python

blog/admin.py

from django.contrib import admin from blog.models import Article

获取作者

这个 obj 对象是用来接收 Article 实例

def get_author(obj): return obj.user.username

Register your models here.

class ArticleAdmin(admin.ModelAdmin): # 要展示的内容 # 此时这里就可以使用 getauthor 换取用户名了。这里不需要加上单引号，也不需要加上括号。 # django 在使用 listdisplay 时，会默认给方法传递一个参数。 listdisplay = ['id', getauthor, 'title', 'content']

getauthor.shortdescription = '作者'

将 User 模型绑定到 UserAdmin

admin.site.register(Article, ArticleAdmin) ```

通过 get_author 方法把外健关联的 username 字段展示出来了。

此时我们将能看到这篇文章的作者是谁了。但我们还需要在编辑页里的用户名展示出来才行。

此时需要修改 User 模型才行。

```python

account/models.py

from django.db import models

创建一个用户表

class Meta:# 自定义表名db_table = 'user'# 表别名verbose_name = '用户表'verbose_name_plural = '用户表'# 返回用户名
def __str__(self):return self.username

```

在 account/models.py 的最后加上 __str__ 方法，返回 username。

此时在文章信息的编辑页里就能看到用户名了。

自定义编辑的跳转链接

在文章管理页面里，想要编辑文章只能点击“ID”这个字段才能跳转进编辑页。如果想通过点击其他字段也能跳转进编辑页就需要手动配置 blog/admin.py 了，比如我想点击“TITLE”也能跳进编辑页。

```python

blog/admin.py

省略部分代码

class ArticleAdmin(admin.ModelAdmin): # 要展示的内容 listdisplay = ['id', getauthor, 'title', 'content'] # 可跳转的字段 listdisplaylinks = ['id', 'title'] # 省略部分代码 ```

我在 ArticleAdmin 里添加了 list_display_links = ['id', 'title']，表示点击 id 和 title 都可以跳转到编辑页。