Django admin 一些有用的設置

 

Django自帶的后台管理是Django明顯特色之一，可以讓我們快速便捷管理數據。后台管理可以在各個app的admin.py文件中進行控制。以下是我最近摸索總結出比較實用的配置。若你有什么比較好的配置，歡迎補充。

 

一、基本設置

1、應用注冊

若要把app應用顯示在后台管理中，需要在admin.py中注冊。這個注冊有兩種方式，我比較喜歡用裝飾器的方式。

先看看普通注冊方法。打開admin.py文件，如下代碼：

?

1 2 3 4 5 6 7 8 9

from django.contrib import admin from blog.models import Blog    #Blog模型的管理器 class BlogAdmin(admin.ModelAdmin):      list_display = ( 'id' , 'caption' , 'author' , 'publish_time' )       #在admin中注冊綁定 admin.site.register(Blog, BlogAdmin)

　　上面方法是將管理器和注冊語句分開。有時容易忘記寫注冊語句，或者模型很多，不容易對應。

還有一種方式是用裝飾器，該方法是Django1.7的版本新增的功能：

?

1 2 3 4 5 6 7

from django.contrib import admin from blog.models import Blog    #Blog模型的管理器 @admin .register(Blog) class BlogAdmin(admin.ModelAdmin):      list_display = ( 'id' , 'caption' , 'author' , 'publish_time' )

　　該方式比較方便明顯，推薦用這種方式。

 

2、admin界面漢化

默認admin后台管理界面是英文的，對英語盲來說用起來不方便。可以在settings.py中設置：

1. LANGUAGE_CODE = 'zh-CN'
2. TIME_ZONE = 'Asia/Shanghai'

1.8版本之后的language code設置不同：

1. LANGUAGE_CODE = 'zh-hans'
2. TIME_ZONE = 'Asia/Shanghai'

 

二、記錄列表界面設置

記錄列表是我們打開后台管理進入到某個應用看到的界面，如下所示：

 

我們可以對該界面進行設置，主要包括列表和篩選器。

 

1、記錄列表基本設置

比較實用的記錄列表設置有顯示字段、每頁記錄數和排序等。

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

from django.contrib import admin from blog.models import Blog    #Blog模型的管理器 @admin .register(Blog) class BlogAdmin(admin.ModelAdmin):      #listdisplay設置要顯示在列表中的字段（id字段是Django模型的默認主鍵）      list_display = ( 'id' , 'caption' , 'author' , 'publish_time' )           #list_per_page設置每頁顯示多少條記錄，默認是100條      list_per_page = 50           #ordering設置默認排序字段，負號表示降序排序      ordering = ( '-publish_time' ,)         #list_editable 設置默認可編輯字段      list_editable = [ 'machine_room_id' , 'temperature' ]         #fk_fields 設置顯示外鍵字段       fk_fields = ( 'machine_room_id' ,)

　　

此處比較簡單，自己嘗試一下即可。

 

另外，默認可以點擊每條記錄第一個字段的值可以進入編輯界面。 

 

我們可以設置其他字段也可以點擊鏈接進入編輯界面。

?

1 2 3 4 5 6 7 8

from django.contrib import admin from blog.models import Blog    #Blog模型的管理器 @admin .register(Blog) class BlogAdmin(admin.ModelAdmin):         #設置哪些字段可以點擊進入編輯界面      list_display_links = ( 'id' , 'caption' )

　　

2、篩選器

篩選器是Django后台管理重要的功能之一，而且Django為我們提供了一些實用的篩選器。

主要常用篩選器有下面3個：

?

1 2 3 4 5 6 7 8 9 10 11 12

from django.contrib import admin from blog.models import Blog    #Blog模型的管理器 @admin .register(Blog) class BlogAdmin(admin.ModelAdmin):      list_display = ( 'id' , 'caption' , 'author' , 'publish_time' )            #篩選器      list_filter = ( 'trouble' , 'go_time' , 'act_man__user_name' , 'machine_room_id__machine_room_name' ) #過濾器      search_fields = ( 'server' , 'net' , 'mark' ) #搜索字段      date_hierarchy = 'go_time'    # 詳細時間分層篩選

對應效果如下：

 此處注意：

使用  date_hierarchy  進行詳細時間篩選的時候 可能出現報錯：Database returned an invalid datetime value. Are time zone definitions for your database and pytz installed?

處理方法：  

命令行直接執行此命令：     [root@mysql ~]#    mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root mysql

然后重啟數據庫即可。

 

一般ManyToManyField多對多字段用過濾器；標題等文本字段用搜索框；日期時間用分層篩選。

過濾器如果是外鍵需要遵循這樣的語法：本表字段__外鍵表要顯示的字段。如：“user__user_name”

 

3、顏色顯示

想對某些字段設置顏色，可用下面的設置：

 

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

from django.db import models from django.contrib import admin from django.utils.html import format_html   class Person(models.Model):      first_name = models.CharField(max_length = 50 )      last_name = models.CharField(max_length = 50 )      color_code = models.CharField(max_length = 6 )        def colored_name( self ):          return format_html(              '<span style="color: #{};">{} {}</span>' ,              self .color_code,              self .first_name,              self .last_name,          )   class PersonAdmin(admin.ModelAdmin):      list_display = ( 'first_name' , 'last_name' , 'colored_name' )

　　

實際代碼（ 注意看上面代碼，是寫在models里，而不是admin中的ModelAdmin里）：

 

效果：

 

但是，我們看到標題並不是我們想要的，那么如何設置標題呢？

 

添加一行代碼：colored_status.short_description = u"狀態"

 

在函數結束之后添加上面代碼即可

 

 4.調整頁面頭部顯示內容和頁面標題

代碼：

?

1 2 3 4 5

class MyAdminSite(admin.AdminSite):      site_header = '好醫生運維資源管理系統'  # 此處設置頁面顯示標題      site_title = '好醫生運維'  # 此處設置頁面頭部標題   admin_site = MyAdminSite(name = 'management' )

　　需要注意的是：  admin_site = MyAdminSite(name='management') 此處括號內name值必須設置，否則將無法使用admin設置權限，至於設置什么值，經本人測試，沒有影響。

注冊的時候使用admin_site.register，而不是默認的admin.site.register。

效果如下：

 后經網友提示發現也可以這樣：

?

1 2 3 4 5 6 7 8 9 10 11 12

from django.contrib import admin from hys_operation.models import *     # class MyAdminSite(admin.AdminSite): #     site_header = '好醫生運維資源管理系統'  # 此處設置頁面顯示標題 #     site_title = '好醫生運維' # # # admin_site = MyAdminSite(name='management') # admin_site = MyAdminSite(name='adsff') admin.site.site_header = '修改后' admin.site.site_title = '哈哈'

　　不繼承 admin.AdminSite 了，直接用admin.site 下的 site_header 和 site_title 。

更加簡單方便，容易理解。  唯一的區別就是 這種方法 是登錄http://ip/admin/

 站點和用戶組在一起

而第一種方法是分開的。

 

5.通過當前登錄的用戶過濾顯示的數據

官方文檔的介紹：

 

 

實際代碼和效果：

 

@admin.register(MachineInfo)

class MachineInfoAdmin(admin.ModelAdmin):

 

    def get_queryset(self, request):

        """函數作用：使當前登錄的用戶只能看到自己負責的服務器"""

        qs = super(MachineInfoAdmin, self).get_queryset(request)

        if request.user.is_superuser:

            return qs

        return qs.filter(user=UserInfo.objects.filter(user_name=request.user))

 

    list_display = ('machine_ip', 'application', 'colored_status', 'user', 'machine_model', 'cache',

                    'cpu', 'hard_disk', 'machine_os', 'idc', 'machine_group')

 

 

 

三、編輯界面設置

編輯界面是我們編輯數據所看到的頁面。我們可以對這些字段進行排列設置等。

若不任何設置，如下圖所示：

 

這個界面比較簡陋，需要稍加設置即可。

 

1、編輯界面設置

首先多ManyToMany多對多字段設置。可以用filter_horizontal或filter_vertical：

1. #Many to many 字段
2. filter_horizontal=('tags',)

效果如下圖：

 

這樣對多對多字段操作更方便。

另外，可以用fields或exclude控制顯示或者排除的字段，二選一即可。

例如，我想只顯示標題、作者、分類標簽、內容。不想顯示是否推薦字段，可以如下兩種設置方式：

1. fields =  ('caption', 'author', 'tags', 'content')

或者

1. exclude = ('recommend',) #排除該字段

設置之后，你會發現這些字段都是一個字段占一行。若想兩個字段放在同一行可以如下設置：

1. fields =  (('caption', 'author'), 'tags', 'content')

效果如下：

 

 

2、編輯字段集合

不過，我不怎么用fields和exclude。用得比較多的是fieldsets。該設置可以對字段分塊，看起來比較整潔。如下設置：

1. fieldsets = (
2.     ("base info", {'fields': ['caption', 'author', 'tags']}),
3.     ("Content", {'fields':['content', 'recommend']})
4. )

效果如下：

 

 

3、一對多關聯

還有一種比較特殊的情況，父子表的情況。編輯父表之后，再打開子表編輯，而且子表只能一條一條編輯，比較麻煩。

這種情況，我們也是可以處理的，將其放在同一個編輯界面中。

例如，有兩個模型，一個是訂單主表(BillMain)，記錄主要信息；一個是訂單明細(BillSub)，記錄購買商品的品種和數量等。

admin.py如下：

1. #coding:utf-8
2. from django.contrib import admin
3. from bill.models import BillMain, BillSub
4.  
5. @admin.register(BillMain)
6. class BillMainAdmin(admin.ModelAdmin):
7.     inlines = [BillSubInline,]    #Inline把BillSubInline關聯進來
8.     list_display = ('bill_num', 'customer',)
9.     
10. class BillSubInline(admin.TabularInline):
11.     model = BillSub
12.     extra = 5 #默認顯示條目的數量

 

這樣就可以快速方便處理數據。

相關的admin比較有用的設置大致這些，若你覺得還有一些比較有用的，可以留意參與討論。

 

4.設置只讀字段

 在使用admin的時候，ModelAdmin默認對於model的操作只有增加，修改和刪除，但是總是有些字段是不希望用戶來編輯的。而 readonly_fields 設置之后不管是admin還是其他用戶都會變成只讀，而我們通常只是想限制普通用戶。 這時我們就可以通過重寫 get_readonly_fields 方法來實現對特定用戶的只讀顯示。

官網介紹：  （https://docs.djangoproject.com/en/1.10/ref/contrib/admin/#django.contrib.admin.ModelAdmin.readonly_fields）

代碼：

?

1 2 3 4 5 6 7 8 9 10

class MachineInfoAdmin(admin.ModelAdmin):        def get_readonly_fields( self , request, obj = None ):          """  重新定義此函數，限制普通用戶所能修改的字段  """          if request.user.is_superuser:              self .readonly_fields = []          return self .readonly_fields            readonly_fields = ( 'machine_ip' , 'status' , 'user' , 'machine_model' , 'cache' ,                         'cpu' , 'hard_disk' , 'machine_os' , 'idc' , 'machine_group' )

　　效果：

 

 5、數據保存時進行一些額外的操作（通過重寫ModelAdmin的save_model實現）

 

代碼：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

def save_model( self , request, obj, form, change):      """  重新定義此函數，提交時自動添加申請人和備案號  """        def make_paper_num():          """ 生成隨機備案號 """          import datetime          import random          CurrentTime = datetime.datetime.now().strftime( "%Y%m%d%H%M%S" )  # 生成當前時間          RandomNum = random.randint( 0 , 100 )  # 生成的隨機整數n，其中0<=n<=100          UniqueNum = str (CurrentTime) + str (RandomNum)          return UniqueNum        obj.proposer = request.user      obj.paper_num = make_paper_num()      super (DataPaperStoreAdmin, self ).save_model(request, obj, form, change)

　　這樣，在添加數據時，會自動保存申請人和備案號。

 我們也可以在修改數據時獲取保存前的數據：

通過change參數，可以判斷是修改還是新增，同時做相應的操作。上述代碼就是在替換磁盤的時候修改狀態，並寫入日志。

 代碼：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

def save_model( self , request, obj, form, change):      if change:  # 更改的時候          machine_code = self .model.objects.get(pk = obj.pk).machine          disk_id = self .model.objects.get(pk = obj.pk).disk_id          disk_code = self .model.objects.get(pk = obj.pk).disk          machine.Device.objects. filter (pk = disk_id).update(device_status = '待報廢' )          data = { 'server_code' : machine_code,                  'device_type' : '硬盤' ,                  'original_code' : disk_code,                  'way' : '變更' ,                  'current_code' : obj.disk}          common.DeLog.objects.create( * * data)  # 創建日志      else :  # 新增的時候          data = { 'server_code' : obj.machine,                  'device_type' : '硬盤' ,                  'original_code' : '',                  'way' : '新增' ,                  'current_code' : obj.disk}          common.DeLog.objects.create( * * data)  # 創建日志      super (MachineExDiskAdmin, self ).save_model(request, obj, form, change)

　　同樣的，還有delete_model：

?

1 2 3 4 5 6 7 8 9 10

def delete_model( self , request, obj):      machine.Device.objects. filter (pk = obj.pk).update(device_status = '待報廢' )      data = { 'server_code' : obj.machine,              'device_type' : '硬盤' ,              'original_code' : obj.disk,              'way' : '刪除' ,              'current_code' : '',              'user_name' : request.user}      common.DeLog.objects.create( * * data)  # 創建日志      super (MachineExDiskAdmin, self ).delete_model(request, obj)

　　

6. 修改模版 chang_form.html 讓普通用戶 無法看到 “歷史” 按鈕。

默認 普通用戶下 是存在 “歷史” 按鈕的：

此時  chang_form.html  的代碼為：

我們將代碼修改為：

這樣，就可以限制 只讓管理員看到歷史 按鈕了。普通用戶看不到了：

 

7.對單條數據 顯示樣式的修改

 需求如下：

每條數據都有 個確認標識（上圖紅框中），如果已經確認，用戶再點擊進入查看信息的時候全部只讀顯示，即不能在做修改，如果沒確認在可以修改。如下：

已確認：

 

未確認：

 

 實現方法：

change_view 方法 和 get_readonly_fields 方法 配合，代碼：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

def get_readonly_fields( self , request, obj = None ):      """  重新定義此函數，限制普通用戶所能修改的字段  """      if request.user.is_superuser:          self .readonly_fields = [ 'commit_date' , 'paper_num' ]      elif hasattr (obj, 'is_sure' ):          if obj.is_sure:              self .readonly_fields = ( 'project_name' , 'to_mail' , 'data_selected' , 'frequency' , 'start_date' ,                                      'end_date' )      else :          self .readonly_fields = ( 'paper_num' , 'is_sure' , 'proposer' , 'sql' , 'commit_date' )        return self .readonly_fields   def change_view( self , request, object_id, form_url = '', extra_context = None ):      change_obj = DataPaperStore.objects. filter (pk = object_id)      self .get_readonly_fields(request, obj = change_obj)      return super (DataPaperStoreAdmin, self ).change_view(request, object_id, form_url, extra_context = extra_context)

　　注：

change_view方法，允許您在渲染之前輕松自定義響應數據。（凡是對單條數據操作的定制，都可以通過這個方法配合實現）
詳細信息可見：https://docs.djangoproject.com/en/1.10/ref/contrib/admin/#django.contrib.admin.ModelAdmin.change_view

8.修改app的顯示名稱

Dajngo在Admin后台默認顯示的應用的名稱為創建app時的名稱。

我們如何修改這個app的名稱達到定制的要求呢，其實Django已經在文檔里進行了說明。

從Django1.7以后不再使用app_label，修改app相關需要使用AppConfig。我們只需要在應用的__init__.py里面進行修改即可：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

from django.apps import AppConfig import os     default_app_config = 'hys_operation.PrimaryBlogConfig'   VERBOSE_APP_NAME = u "1-本地服務器資源"     def get_current_app_name(_file):      return os.path.split(os.path.dirname(_file))[ - 1 ]     class PrimaryBlogConfig(AppConfig):      name = get_current_app_name(__file__)      verbose_name = VERBOSE_APP_NAME

　　

 9.自定義列表字段

上面的一對多和多對多可以數據編輯中顯示，但在列表中沒有顯示。有時還需要顯示一些其他東西。例如兩個字段相乘計算結果等等。這些都可以通過自定義列表字段處理和顯示。

例如，兩個模型Blog和Tag。多對多關系。簡單模型代碼如下：

?

1 2 3 4 5 6

class Tag(models.Model):      tag_name = models.CharField(max_length = 20 ,blank = True )       class Blog(models.Model):      caption = models.CharField(max_length = 20 ,blank = True )      tags = models.ManyToManyField(Tag,blank = True )

　　 

在Blog模型中有tags字段，但admin列表顯示不能直接用該字段，也顯示不出來。可以通過自定義列表字段顯示。如下設置admin：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

#coding:utf-8 from django.contrib import admin from blog.models import Blog, Tag    # Blog模型的管理器 @admin .register(Blog) class BlogAdmin(admin.ModelAdmin):      # listdisplay添加 tags_list 不存在的字段名      list_display = ( 'id' , 'caption' , 'tags_list' )            # 定義tags_list，方法名和tags_list一致      def tags_list( self , blog):          """自定義列表字段"""          tag_names = map ( lambda x: x.tag_name, blog.tags. all ())          return ', ' .join(tag_names)

　　 

通過自定義列表字段，獲取相關數據再列表中顯示，效果如下：

 

參考了博客：https://www.cnblogs.com/wumingxiaoyao/p/6928297.html

　　　　　　

 

參考網站： http://code.ziqiangxuetang.com/django/django-admin.html

                  http://django-intro-zh.readthedocs.io/zh_CN/latest/part2/

　　　　   http://python.usyiyi.cn/translate/django_182/ref/contrib/admin/index.html

                 https://www.ibm.com/developerworks/cn/opensource/os-django-admin/

　　　　  http://www.cnblogs.com/linxiyue/p/4074141.html