Django学习笔记2 【自定义你的admin】

迷南。 2022-05-31 01:23 227阅读 0赞

# 一.概述 #

本章内容为根据自己课设项目所需要的后台管理部分进行各种配置，所设置的admin配置知识在django官网中的1.11文档部分均可找到，写这篇的目的是为了优化django admin的使用。

环境说明：  
Django:1.11  
python版本：3.4.4  
操作系统：win10\_1709\_pro

# 二.表结构 #

数据库的表结构非常简单如下  
**bikedata表:**

+--------+-------------+------+-----+---------+----------------+
    | Field | Type | Null | Key | Default | Extra | +--------+-------------+------+-----+---------+----------------+
    | id     | int(11)     | NO   | PRI | NULL    | auto_increment | | bikeIp | varchar(50) | NO | | NULL | | +--------+-------------+------+-----+---------+----------------+

**bikelocation表:**

+---------------+---------+------+-----+---------+----------------+
    | Field         | Type    | Null | Key | Default | Extra          |
    +---------------+---------+------+-----+---------+----------------+
    | id            | int(11) | NO   | PRI | NULL    | auto_increment |
    | bikeLongitude | double  | NO   |     | NULL    |                |
    | bikeLatitude  | double  | NO   |     | NULL    |                |
    | bikeId_id     | int(11) | NO   | MUL | NULL    |                |
    +---------------+---------+------+-----+---------+----------------+

其中bikelocation表中的bikeID\_id字段引用了bikedata表为外键

# 三.一步一步优化你的admin #

### 1.数据库内表项无法区分 ###

![这里写图片描述][SouthEast]  
我在bikelocation数据库中添加了两行数据然而在admin中打开会发现我没有直接的办法区别他们，只能点击进去后才可以分辨，这是很不合理的，看了下他们显示的字符正好与类bikeLocation的实例输出后的结果是一致的，想到这里问题就简单了，将model的类中添加一个str方法即可。  
**修改后的model如下：**

class bikeData(models.Model):
        bikeIp = models.CharField(max_length=50)
    
        def __str__(self):
            str(return self.bikeIp)
    
    
    class bikeLocation(models.Model):
        bikeId = models.ForeignKey(bikeData)
        bikeLongitude = models.FloatField()
        bikeLatitude = models.FloatField()
    
        def __str__(self):
            return str(self.bikeId)

**修改后的admin显示如下:**  
![这里写图片描述][SouthEast 1]

从原理上讲，我们是重写了model中的`__str__`方法使得当使用model对象的输出属性时候，不是输出默认的`xxx object`，而是我们重写的方法中所定制返回的东西，后面会有一些更方便的admin设置来让这里的显示更丰富。

现在我们可以基本区分数据库中每一行了，当我们想添加更多数据在每一行上时我们直接修改`__str__`方法即可。现在我们引入一种新的方法，使用admin配置文件。  
首先在你的某个app目录下创建admin.py文件，下面展示了admin.py的一个基本模板

from django.contrib import admin
    from main_site.models import bikeData, bikeLocation
    
    
    # Register your models here.
    @admin.register(bikeData)
    class bikeDataAdmin(admin.ModelAdmin):
        list_display = ('bikeIp',)
    
    @admin.register(bikeLocation)
    class bikeLocationAdmin(admin.ModelAdmin):
        list_display = ('bikeId', 'bikeLongitude', 'bikeLatitude')  # 将表项以表格的形式展示出来，传递的参数是每一行中显示的列
    
    
    # admin.site.register(bikeData, bikeDataAdmin)
    # admin.site.register(bikeLocation, bikeLocationAdmin)

创建的类继承了admin.ModelAdmin后就可以对相应的admin文件进行修改了，为了具体到是对哪个model的页面，我们还要对相应的类进行注册，方法有两种，一种是装饰器。  
这里使用了list\_display属性，我们直接看使用效果  
![这里写图片描述][70]

根据显示的结果，我们知道，只要在list\_display中注册过的列都会在admin中显示，直接覆盖了刚才修改的`__str__`方法。

### 2.在list\_display基础上继续优化 ###

这样修改过的admin在显示上已经比一开始的好很多了，现在我们希望添加一些花样，细心的朋友发现上一张截图中，BIKEID这一列的表项是蓝色的，为蓝色的这样一列可以点击从而进入修改界面。我们如果想让其他列为蓝色，只要使用`list_display_links`即可

![这里写图片描述][70 1]  
修改后后两列变成蓝色，点击即可进入修改界面。

这一列我们改了半天只是修改了相应的显示，我们现在想进行编辑可以吗，当然可以admin配置文件提供`list_editable`来进行对一行中某列的修改，但是这个方法中所注册的列不能在`list_display_link`中出现过

@admin.register(bikeLocation)
    class bikeLocationAdmin(admin.ModelAdmin):
        list_display = ('bikeId', 'bikeLongitude', 'bikeLatitude')  # 将表项以表格的形式展示出来，传递的参数是每一行中显示的列
        list_display_links = ('bikeId',)  # 选择"list_display"哪个项目可以点击进入修改界面,默认是第一个索引
        list_editable = (
            'bikeLongitude', 'bikeLatitude',)  # 可以直接在表项的目录中对数据进行修改，注意的是，某列不能同时出现在list_display_link与link_editable同时出现

结果如下  
![这里写图片描述][70 2]  
直接在这个界面就可以进行修改，十分方便

### 3.开始配置修改界面 ###

我们先通过模板界面的蓝色处点击进入未配置过的修改界面  
![这里写图片描述][70 3]

首先依旧是对显示的修改，默认情况下，我们可以在修改界面中修改每一行的所有列，使用`fields`属性即可自定义修改界面中可以显示的列

我们这样修改后现在这可以修改两个列  
![这里写图片描述][70 4]

`fields`中还有一些小技巧，比如我们想让BikeLongituude和BikeLatitude列在一行中显示我们直接将这两个放在一个额外元组中即可

`fields = (('bikeLongitude', 'bikeLatitude', ),)`  
![这里写图片描述][70 5]

### 4.其他修改 ###

`list_display_links = None`  
如果该项为`None`那么我们也就无法进入修改界面了  
![这里写图片描述][70 6]  
如上图所示，没有蓝色的项

`actions_selection_counter = False`  
![这里写图片描述][70 7]  
这个选项用来屏蔽图中黄色的部分，如果为False也就不显示多少个中几个被选中  
![这里写图片描述][70 8]

`actions_on_bottom = True actions_on_top = False`  
这两个选项可以改变动作菜单的位置，默认是只有一个在上面，如果两个都为True那么就是上下各有一个动作菜单，如下。  
![这里写图片描述][70 9]

### 5.django admin的汉化 ###

![这里写图片描述][70 10]

修改setting配置文件中的LANGUAGE\_CODE字段就可以进行汉化

[SouthEast]: /images/20220531/2d898dc7c1c148a4a7d60986d5e6bc7b.png
[SouthEast 1]: /images/20220531/6446b94bcda04d90bc49116f1d8d1989.png
[70]: /images/20220531/ddceba1b277c4a8f9e144c0a9b1ba3f3.png
[70 1]: /images/20220531/5846a8627dbd40968116fe5248854b6e.png
[70 2]: /images/20220531/f18b47184f7048eabb8a52bb65353f45.png
[70 3]: /images/20220531/22226046a6bf403ea6edf4bc6ed969a1.png
[70 4]: /images/20220531/d452e72a3ca84d7abab9ed3ea1b6f42d.png
[70 5]: /images/20220531/97158e86f3344404b486e6a131b4641c.png
[70 6]: /images/20220531/e28ceb922e784de6940443c534569c06.png
[70 7]: /images/20220531/db3a19ad75ad4567a5e5e440b9cbe61b.png
[70 8]: /images/20220531/dd648811565b435e8d11c9fe1c2e91d5.png
[70 9]: /images/20220531/a6ea8fb172c14450b405baec1b7ac8e8.png
[70 10]: /images/20220531/9c84575861c94610a080314b803dc1d4.png