Django 自動(dòng)管理工具是 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基本代碼的組成部分。
激活管理工具
通常我們?cè)谏身?xiàng)目時(shí)會(huì)在 urls.py 中自動(dòng)設(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)行了。
使用管理工具
啟動(dòng)開發(fā)服務(wù)器,然后在瀏覽器中訪問 http://127.0.0.1:8000/admin/,得到如下界面:
![](/d/20211017/6de826e44b9663e731a35fd25aa0db8c.gif)
你可以通過命令 python manage.py createsuperuser 來創(chuàng)建超級(jí)用戶(超級(jí)用戶創(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]#
之后輸入用戶名密碼登錄,界面如下:
![](/d/20211017/047cec7da158a4312e5a81399696320b.gif)
為了讓 admin 界面管理某個(gè)數(shù)據(jù)模型,我們需要先注冊(cè)該數(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ù)表:
![](/d/20211017/e62c56bbe675d58f29ba3734f1793f62.gif)
復(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 可以對(duì)應(yīng)多個(gè) Tag。
我們還可以看到許多在之前沒有見過的屬性類型,比如 IntegerField 用于存儲(chǔ)整數(shù)。
![](/d/20211017/3b2e0f5c3f87c1c28234d3f32a9116df.gif)
在 TestModel/admin.py 注冊(cè)多個(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é)果如下:
![](/d/20211017/85d70f78958531528df38f46d07f9e9e.gif)
在以上管理工具我們就能進(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 屬性定義了要顯示的字段。
由于該類對(duì)應(yīng)的是 Contact 數(shù)據(jù)模型,我們?cè)谧?cè)的時(shí)候,需要將它們一起注冊(cè)。顯示效果如下:
![](/d/20211017/c96bb89b581d03f490c55dc89f598f0f.gif)
我們還可以將輸入欄分塊,每個(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 部分隱藏:
![](/d/20211017/94c16ae05cccbe369fca3b57bf1d53ca.gif)
Advance 部分旁邊有一個(gè) Show 按鈕,用于展開,展開后可點(diǎn)擊 Hide 將其隱藏,如下圖所示:
![](/d/20211017/a6d38893c58b2979f8cb60719926437e.gif)
內(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])
顯示效果如下:
![](/d/20211017/8628573cb7db1f385886e27e493a8ae4.gif)
列表頁的顯示
在 Contact 輸入數(shù)條記錄后,Contact 的列表頁看起來如下:
![](/d/20211017/b96e0793c1c59f3fd8f52c9296079837.gif)
我們也可以自定義該頁面的顯示,比如在列表中顯示更多的欄目,只需要在 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])
刷新頁面顯示效果如下:
![](/d/20211017/d2b17fece66a10291e9dc33b8aa7eb02.gif)
搜索功能在管理大量記錄時(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é)果如下:
![](/d/20211017/0b4ede274dd37b7ddf95466ea1364574.gif)
Django Admin 管理工具還有非常多實(shí)用的功能,感興趣的同學(xué)可以深入研究下。
到此這篇關(guān)于Django Admin 管理工具的實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)Django Admin 管理工具內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
您可能感興趣的文章:- django admin管理工具自定義時(shí)間區(qū)間篩選器DateRangeFilter介紹
- Django admin管理工具TabularInline類用法詳解