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',
)

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

管理工具

在項目的urls.py文件中添加url(r'^admin/' ,admin.site.urls)，一般在生成項目時會自動設置好，我們只需要去掉注釋就行。

from django.conf.urls import url
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', admin.site.urls),
]

使用管理工具

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

image

接著可以通過命令 python manage.py createsuperuser來創(chuàng)建超級用戶。

>> python manage.py createsuperuser
?
Username (leave blank to use 'root'): 用戶名
Email address: 郵箱
Password: 密碼
Password (again):  確認密碼
Superuser created successfully.

創(chuàng)建好超級用戶之后我們可以在剛剛的那個登錄界面輸入用戶名和密碼，登錄成功后的界面如下所示：

image

為了讓 admin 界面管理某個數據模型，我們需要先注冊該數據模型到 admin。比如我們之前在TestApp中已經創(chuàng)建了模型Test。修改TestApp/admin.py文件：

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

在網頁中刷新后即可看到TestApp數據表，如下圖：

image

復雜的后臺數據模型

我們的django頁面管理功能非常強大，完全有能力處理更加復雜的數據模型。

首先我們可以在TestApp/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

上述兩個表中，Tag以Contact為外部鍵。一個Contact可以對應多個Tag。

在TestApp/admin.py文件中注冊多個模型并顯示：

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

刷新管理頁面，顯示結果如下所示：

image

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

自定義表單

我們可以自定義管理頁面，來取代默認的頁面。比如上面的 "add" 頁面。我們想只顯示 name 和 email 部分。修改 TestApp/admin.py：

from django.contrib import admin
from TestApp.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 數據模型，我們在注冊的時候，需要將它們一起注冊。顯示效果如下：

image

還可以將輸入欄分塊，每個欄也可以定義自己的格式。修改 TestApp/admin.py為：

from django.contrib import admin
from TestApp.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 部分隱藏：

image

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

image

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

上面的 Contact 是 Tag 的外部鍵，所以有外部參考的關系。而在默認的頁面顯示中，將兩者分離開來，無法體現(xiàn)出兩者的從屬關系。我們可以使用內聯(lián)顯示，讓 Tag 附加在 Contact 的編輯頁面上顯示。

修改TestApp/admin.py：

from django.contrib import admin
from TestApp.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])

訪問頁面后的效果圖如下所示：

image

列表頁的顯示

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

from django.contrib import admin
from TestApp.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])

刷新頁面后效果如圖所示：

image

搜索功能

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

from django.contrib import admin
from TestApp.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])

參考：https://www.9xkd.com