python+django(admin管理工具)

Django Admin 管理工具

Django 提供了基於 web 的管理工具。python

Django 自動管理工具是 django.contrib 的一部分。你能夠在項目的 settings.py 中的 INSTALLED_APPS 看到它:web

/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

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

激活管理工具

一般咱們在生成項目時會在 urls.py 中自動設置好,咱們只需去掉註釋便可。服務器

配置項以下所示:session

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

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

當這一切都配置好後,Django 管理工具就能夠運行了。工具

使用管理工具

啓動開發服務器,而後在瀏覽器中訪問 http://127.0.0.1:8000/admin/,獲得以下界面:url

你能夠經過命令spa

一、python manage.py migrate

二、 python manage.py createsuperuser 來建立超級用戶,以下所示:

 

# 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 界面管理某個數據模型,咱們須要先註冊該數據模型到 admin。好比,咱們以前在 TestModel 中已經建立了模型 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 數據表:

複雜模型

管理頁面的功能強大,徹底有能力處理更加複雜的數據模型。

先在 TestModel/models.py 中增長一個更復雜的數據模型:

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) name = models.CharField(max_length=50) def __unicode__(self): return self.name

這裏有兩個表。Tag 以 Contact 爲外部鍵。一個 Contact 能夠對應多個 Tag。

咱們還能夠看到許多在以前沒有見過的屬性類型,好比 IntegerField 用於存儲整數。

在 TestModel/admin.py 註冊多個模型並顯示:

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])

刷新管理頁面,顯示結果以下:

在以上管理工具咱們就能進行復雜模型操做。

若是你以前還未建立表結構,可以使用如下命令建立:

$ python manage.py makemigrations TestModel  # 讓 Django 知道咱們在咱們的模型有一些變動
$ python manage.py migrate TestModel   # 建立表結構

自定義表單

咱們能夠自定義管理頁面,來取代默認的頁面。好比上面的 "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])

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

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

因爲該類對應的是 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 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 部分旁邊有一個 Show 按鈕,用於展開,展開後可點擊 Hide 將其隱藏,以下圖所示:

內聯(Inline)顯示

上面的 Contact 是 Tag 的外部鍵,因此有外部參考的關係。

而在默認的頁面顯示中,將二者分離開來,沒法體現出二者的從屬關係。咱們可使用內聯顯示,讓 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 輸入數條記錄後,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])

刷新頁面顯示效果以下:

搜索功能在管理大量記錄時很是有,咱們可使用 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])

在本實例中咱們搜索了 name 爲 runoob 的記錄,顯示結果以下:

Django Admin 管理工具還有很是多實用的功能,感興趣的同窗能夠深刻研究下。

相關文章
相關標籤/搜索