Django Admin 管理工具

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

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

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)如下所示：

from django.contrib import admin
admin.autodiscover()

# And include this URLpattern...
urlpatterns = patterns('',
    # ...
    (r'^admin/', include(admin.site.urls)),
    # ...
)

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

使用管理工具

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

你可以通過命令 python manage.py createsuperuser 來(lái)創(chuàng)建超級(jí)用戶，如下所示：

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

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

為了讓admin界面管理某個(gè)數(shù)據(jù)模型，我們需要先注冊(cè)該數(shù)據(jù)模型到admin。比如，我們之前在 TestModel 中已經(jīng)創(chuàng)建了模型 Test 。修改 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ù)雜模型

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

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

from django.db import models

# Create your models here.
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

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

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

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

from django.contrib import admin
from TestModel.models import Test,Contact,Tag

# Register your models here.
admin.site.register([Test, Contact, Tag])

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

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

自定義表單

我們可以自定義管理頁(yè)面，來(lái)取代默認(rèn)的頁(yè)面。比如上面的"add"頁(yè)面。我們想只顯示name和email部分。修改 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類，用以說(shuō)明管理頁(yè)面的顯示格式。

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

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

我們還可以將輸入欄分塊，每個(gè)欄也可以定義自己的格式。修改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說(shuō)明它所在的部分的CSS格式。這里讓Advance部分隱藏：

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

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

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

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

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

顯示效果如下：

列表頁(yè)的顯示

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

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

from django.contrib import admin
from TestModel.models import Test,Contact,Tag

# Register your models here.
class ContactAdmin(admin.ModelAdmin):
    list_display = ('name','age', 'email') # list

admin.site.register(Contact, ContactAdmin)
admin.site.register([Test, Tag])

刷新頁(yè)面顯示效果如下：

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

from django.contrib import admin
from TestModel.models import Test,Contact,Tag

# Register your models here.
class ContactAdmin(admin.ModelAdmin):
    list_display = ('name','age', 'email') 
    search_fields = ('name',)

admin.site.register(Contact, ContactAdmin)
admin.site.register([Test])

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

Django Admin 管理工具還有非常多實(shí)用的功能，感興趣的同學(xué)可以深入研究下。