Django Admin 管理工具
一.Django 提供了基於 web 的管理工具。
Django admin自動管理工具是 django.contrib 的一部分,我們可以在項目的 settings.py 中的 INSTALLED_APPS 看到它,我們可以把他看成django本身自帶的一個app應用程序。
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'bookmodels',
]
django.contrib是一套龐大的功能集,它是Django基本代碼的組成部分。
二.使用管理工具:
通常我們在生成項目時會在 urls.py 中自動設置好,我們只需去掉注釋即可。
配置項如下所示:
# urls.py
from django.conf.urls import url
from django.contrib import admin
urlpatterns = [
url(r'^admin/', admin.site.urls),
]
當這一切都配置好后,Django 管理工具就可以運行了
啟動服務器:
我們就可以使用admin管理工具了。
瀏覽器中輸入:http://39.106.11.3:8090/admin/
即可登錄到admin登錄管理界面。
此時我們需要手動創建一個我們想要的Django后台管理登錄賬戶和密碼。
輸入:python manage.py createsuperuser 來創建超級賬戶。
輸入用戶名:fengjunhua並按回車。
出現提示輸入我們的郵箱:
輸入我們的郵箱:feng_junhua@126.com
出現提示輸入我們的密碼,我們輸入密碼后回車,出現提示超級用戶創建成功。
此時我們就可以用我們的超級用戶名和密碼登錄我們的超級后台管理界面了。
輸入用戶名和密碼並按回車,即可登錄到我們的后台管理界面。
因為我們這個后台管理界面是超級用戶,我們也可以通過這種web界面對我們的django數據庫進行操作更改,所以我們首先要做的就是需要將想要管理監控的數據庫注冊到我們的這個超級用戶底下。
我們需要切換到我們含有數據庫models模板文件的app實例目錄底下,找到admin.py這個python文件,注意:我們所有實例app目錄底下的admin.py這個文件就是當前實例app下對我們所有實例進行控制管理的文件。
我們打開admin.py文件,輸入以下代碼:
# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.contrib import admin
from bookmodels.models import bookdb
# Register your models here.
admin.site.register(bookdb)
數據庫注冊好以后,刷新瀏覽器:
這時,從瀏覽器我們就可以看到我們所能管理的數據庫了。
我們可以看到我們的django管理的界面其實可以看成是一個個數據庫表通過前端form表單給我展示出來,我們可以看成django界面就是這些后台的數據庫數據組合而成的,因此我們也可以創建更加復雜的后台數據模型,來更加多樣化,美觀,復雜的展示出我們的前端django界面。
復雜的后台數據模型:
我們的django頁面管理功能非常強大,完全有能力處理更加復雜的數據模型。
首先我們在我們的后台數據庫模板文件中再創建兩個表單:
vim models.py
增加Contect和Tag兩個表單:
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)
name = models.CharField(max_length=50)
def __unicode__(self):
return self.name
我們可以看到這兩個表,Tag以Contect為外鍵,一個Contect可以對應多個Tag,
我們還可以看到IntegerField,屬性類型,用來存儲整數。
我們可以看到這兩個表單的關聯與聯系:
同時我們還必須得把這兩個表單注冊到我們的后台admin管理界面。
# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.contrib import admin
from bookmodels.models import bookdb,Contact,Tag
# Register your models here.
admin.site.register([bookdb,Contact,Tag])
瀏覽器刷新頁面,我們即可看到,這兩個相互關聯的復雜表單。
通過我們的django web admin.site后台管理界面,我們也可以對我們的項目中的復雜的數據庫表單進行操作了。
如果我們之前一次也沒創建過表單,我們需要執行下面這兩步進行models數據庫注冊服務。
$ python manage.py makemigrations TestModel
# 讓 Django 知道我們在我們的模型有一些變更,這步主要是提示我們的項目,setting中的app發生了改變。
$ python manage.py migrate TestModel
# 這句的意思主要是創建models數據庫,並創建數據中的表。
三.我們既可以創建添加我們自己自定義的數據庫表單,也可以對我們web界面顯示的系統默認的顯示界面的數據庫表單進行自定義更改。
編輯admin.py文件
修改為如下:
# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.contrib import admin
from bookmodels.models import bookdb,Contact,Tag
class ContactAdmin(admin.ModelAdmin):
fields = ('name', 'email')
# Register your models here.
admin.site.register(Contact,ContactAdmin)
admin.site.register([bookdb,Tag])
以上代碼定義了一個 ContactAdmin 表單,用以說明管理頁面的顯示格式。
里面的 fields 屬性定義了要顯示的字段。
由於該表單類對應的是 Contact 數據模型,所以我們在注冊的時候,需要將他們一起注冊。
ContactAdmin表單需要對Contect數據模型進行迭代管理。
此外因為我們在這個地方新注冊了一個ContactAdmin表單,所以我們在啟動服務的時候,需要重新將這個表單創建並生成一下,才能起作用,否則報錯。
# python manage.py makemigrations
# python manage.py migrate
我們還可以將輸入欄分塊,每個欄也可以定義自己的格式。修改 bookmodels/admin.py為:
# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.contrib import admin
from bookmodels.models import bookdb,Contact,Tag
class ContactAdmin(admin.ModelAdmin):
fieldsets = (
['Main',{
'fields':('name','email'),
}],
['Advance',{
'classes': ('collapse',), # CSS
'fields': ('age',),
}]
)
# Register your models here.
admin.site.register(Contact,ContactAdmin)
admin.site.register([bookdb,Tag])
我們打開瀏覽器測試,上面的欄目分為了 Main 和 Advance 兩部分。classes 說明它所在的部分的 CSS 格式。這里讓 Advance 部分隱藏:
Advance 部分旁邊有一個 Show 按鈕,用於展開,展開后可點擊 Hide 將其隱藏,如上下圖所示:
四.內聯(Inline)顯示
上面的 Contact 是 Tag 的外部鍵,所以有外部參考的關系。而在默認的頁面顯示中,將兩者分離開來,無法體現出兩者的從屬關系。我們可以使用內聯顯示,讓 Tag 附加在 Contact 的編輯頁面上顯示。
修改bookmodels/admin.py:
# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.contrib import admin
from bookmodels.models import bookdb,Contact,Tag
class TagInline(admin.TabularInline):
model = Tag
class ContactAdmin(admin.ModelAdmin):
inlines = [TagInline] # Inline
fieldsets = (
['Main',{
'fields':('name','email'),
}],
['Advance',{
'classes': ('collapse',), # CSS
'fields': ('age',),
}]
)
# Register your models here.
admin.site.register(Contact,ContactAdmin)
admin.site.register([bookdb])
顯示效果如下:
五.列表頁的顯示
在 Contact 輸入數條記錄后,Contact 的列表頁看起來如下:
我們也可以自定義該頁面的顯示,比如在列表中顯示更多的欄目,只需要在 ContactAdmin 中增加 list_display 屬性:
編輯bookmodels/admin.py:
# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.contrib import admin
from bookmodels.models import bookdb,Contact,Tag
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',), # CSS
'fields': ('age',),
}]
)
# Register your models here.
admin.site.register(Contact,ContactAdmin)
admin.site.register([bookdb])
刷新頁面顯示如下:
六.為頁面增加搜索框
搜索功能在管理大量記錄時非常有,我們可以使用 search_fields 為該列表頁增加搜索欄:
編輯bookmodels/admin.py如下:
# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.contrib import admin
from bookmodels.models import bookdb,Contact,Tag
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',), # CSS
'fields': ('age',),
}]
)
# Register your models here.
admin.site.register(Contact,ContactAdmin)
admin.site.register([bookdb])
刷新頁面顯示如下:
我們在搜索框中輸入name姓名為xiaoli,顯示如下:
加入搜索框以后,我們即會很方便的對頁面進行搜索管理。
Django Admin 管理工具還有很多非常強大的功能,主要是可以對我們的頁面以及后台的數據表單進行很方便的顯示,搜索,操作等管理。