快捷導(dǎo)航

Django Admin 管理工具的實(shí)現(xiàn)

更新時(shí)間：2021年05月10日 09:46:29 作者：Mr Allen

這篇文章主要介紹了Django Admin 管理工具的實(shí)現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

Django 自動管理工具是 django.contrib 的一部分。你可以在項(xiàng)目的 settings.py 中的 INSTALLED_APPS 看到它：

/HelloWorld/HelloWorld/settings.py 文件代碼：

INSTALLED_APPS = (    
	'django.contrib.admin',    
	'django.contrib.auth',    
	'django.contrib.contenttypes',    
	'django.contrib.sessions',    
	'django.contrib.messages',   
	 'django.contrib.staticfiles', 
 )

django.contrib是一套龐大的功能集，它是Django基本代碼的組成部分。

激活管理工具

通常我們在生成項(xiàng)目時(shí)會在 urls.py 中自動設(shè)置好，我們只需去掉注釋即可。

配置項(xiàng)如下所示：

/HelloWorld/HelloWorld/urls.py 文件代碼：

\# urls.py 
from django.conf.urls import url 
from django.contrib import admin  
urlpatterns = [    
	url(r'^admin/', admin.site.urls),
 ]

當(dāng)這一切都配置好后，Django 管理工具就可以運(yùn)行了。

使用管理工具

啟動開發(fā)服務(wù)器，然后在瀏覽器中訪問 http://127.0.0.1:8000/admin/，得到如下界面：

你可以通過命令 python manage.py createsuperuser 來創(chuàng)建超級用戶(超級用戶創(chuàng)建之前應(yīng)該先執(zhí)行數(shù)據(jù)庫遷移命令形成數(shù)據(jù)庫表)，這里已經(jīng)前已過了，如下所示：

# python manage.py createsuperuser
Username (leave blank to use 'root'): admin
Email address: admin@runoob.com
Password:
Password (again):
Superuser created successfully.
[root@solar HelloWorld]#

之后輸入用戶名密碼登錄，界面如下：

為了讓 admin 界面管理某個(gè)數(shù)據(jù)模型，我們需要先注冊該數(shù)據(jù)模型到 admin。比如，我們之前在 TestModel 中已經(jīng)創(chuàng)建了模型 Test 。修改 TestModel/admin.py:

HelloWorld/TestModel/admin.py: 文件代碼：

from django.contrib import admin 
from TestModel.models import Test  # Register your models here. admin.site.register(Test)

刷新后即可看到 Testmodel 數(shù)據(jù)表:

復(fù)雜模型

管理頁面的功能強(qiáng)大，完全有能力處理更加復(fù)雜的數(shù)據(jù)模型。

先在 TestModel/models.py 中增加一個(gè)更復(fù)雜的數(shù)據(jù)模型：

HelloWorld/TestModel/models.py: 文件代碼：

from django.db import models  # Create your models here. 
class Test(models.Model):   
 	name = models.CharField(max_length=20)  
class Contact(models.Model):   
  	name = models.CharField(max_length=200)    
  	age = models.IntegerField(default=0)   
   	email = models.EmailField()    
   def __unicode__(self):        
   		return self.name  
class Tag(models.Model):    
   contact = models.ForeignKey(Contact, on_delete=models.CASCADE,)
   name    = models.CharField(max_length=50)    
   def __unicode__(self):        
   		return self.name

這里有兩個(gè)表。Tag 以 Contact 為外部鍵。一個(gè) Contact 可以對應(yīng)多個(gè) Tag。

我們還可以看到許多在之前沒有見過的屬性類型，比如 IntegerField 用于存儲整數(shù)。

在 TestModel/admin.py 注冊多個(gè)模型并顯示：

HelloWorld/TestModel/admin.py: 文件代碼：

from django.contrib import admin 
from TestModel.models import Test,Contact,Tag  # Register your models here. 
admin.site.register([Test, Contact, Tag])

刷新管理頁面，顯示結(jié)果如下：

在以上管理工具我們就能進(jìn)行復(fù)雜模型操作。

如果你之前還未創(chuàng)建表結(jié)構(gòu)，可使用以下命令創(chuàng)建：

$ python manage.py migrate TestModel   # 創(chuàng)建表結(jié)構(gòu)

自定義表單

我們可以自定義管理頁面，來取代默認(rèn)的頁面。比如上面的 “add” 頁面。我們想只顯示 name 和 email 部分。修改 TestModel/admin.py:

HelloWorld/TestModel/admin.py: 文件代碼：

from django.contrib import admin 
from TestModel.models import Test,Contact,Tag  # Register your models here. 
class ContactAdmin(admin.ModelAdmin):    
	fields = ('name', 'email')  
	admin.site.register(Contact, ContactAdmin) 
	admin.site.register([Test, Tag])

以上代碼定義了一個(gè) ContactAdmin 類，用以說明管理頁面的顯示格式。

里面的 fields 屬性定義了要顯示的字段。

由于該類對應(yīng)的是 Contact 數(shù)據(jù)模型，我們在注冊的時(shí)候，需要將它們一起注冊。顯示效果如下：

我們還可以將輸入欄分塊，每個(gè)欄也可以定義自己的格式。修改 TestModel/admin.py為：

HelloWorld/TestModel/admin.py: 文件代碼：

from django.contrib import admin 
from TestModel.models import Test,Contact,Tag  # Register your models here. 
class ContactAdmin(admin.ModelAdmin):    
	fieldsets = (        
		['Main',{
		'fields':('name','email'),
		}],        
		['Advance',
		{ 'classes': ('collapse',), # CSS            
		'fields': ('age',),        
		}]
	)  
admin.site.register(Contact, ContactAdmin) 
admin.site.register([Test, Tag])

上面的欄目分為了 Main 和 Advance 兩部分。classes 說明它所在的部分的 CSS 格式。這里讓 Advance 部分隱藏：

Advance 部分旁邊有一個(gè) Show 按鈕，用于展開，展開后可點(diǎn)擊 Hide 將其隱藏，如下圖所示：

內(nèi)聯(lián)(Inline)顯示

上面的 Contact 是 Tag 的外部鍵，所以有外部參考的關(guān)系。

而在默認(rèn)的頁面顯示中，將兩者分離開來，無法體現(xiàn)出兩者的從屬關(guān)系。我們可以使用內(nèi)聯(lián)顯示，讓 Tag 附加在 Contact 的編輯頁面上顯示。

修改TestModel/admin.py：

HelloWorld/TestModel/admin.py: 文件代碼：

from django.contrib import admin 
from TestModel.models import Test,Contact,Tag  # Register your models here. 
class TagInline(admin.TabularInline):    
model = Tag  
class ContactAdmin(admin.ModelAdmin):    
	inlines = [TagInline]  # Inline    
	fieldsets = (        
		['Main',{            
		'fields':('name','email'),        
		}],        
		['Advance',{            
		'classes': ('collapse',),            
		'fields': ('age',),        
		}]     
	)  
admin.site.register(Contact, ContactAdmin) 
admin.site.register([Test])

顯示效果如下：

列表頁的顯示

在 Contact 輸入數(shù)條記錄后，Contact 的列表頁看起來如下:

我們也可以自定義該頁面的顯示，比如在列表中顯示更多的欄目，只需要在 ContactAdmin 中增加 list_display 屬性:

HelloWorld/TestModel/admin.py: 文件代碼：

from django.contrib import admin 
from TestModel.models import Test,Contact,Tag  # Register your models here. 
class TagInline(admin.TabularInline):    
	model = Tag  
class ContactAdmin(admin.ModelAdmin):    
	list_display = ('name','age', 'email') # list    
	inlines = [TagInline]  # Inline    
	fieldsets = (        
	['Main',{            
	'fields':('name','email'),        
	}],        
	['Advance',{            
	'classes': ('collapse',),           
	'fields': ('age',),        
	}]     
	)  
admin.site.register(Contact, ContactAdmin) 
admin.site.register([Test])

刷新頁面顯示效果如下：

搜索功能在管理大量記錄時(shí)非常有，我們可以使用 search_fields 為該列表頁增加搜索欄：

HelloWorld/TestModel/admin.py: 文件代碼：

from django.contrib import admin 
from TestModel.models import Test,Contact,Tag  # Register your models here. 
class TagInline(admin.TabularInline):    
		model = Tag  
class ContactAdmin(admin.ModelAdmin):    
		list_display = ('name','age', 'email') # list    
		search_fields = ('name',)    
		inlines = [TagInline]  # Inline    
		fieldsets = (        
		['Main',{            
		'fields':('name','email'),       
		 }],        
		 ['Advance',{            
		 'classes': ('collapse',),            
		 'fields': ('age',),        
		 }]     
		 )  
 admin.site.register(Contact, ContactAdmin) 
 admin.site.register([Test])

在本實(shí)例中我們搜索了 name 為 runoob 的記錄，顯示結(jié)果如下：