Django Admin 管理工具

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

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

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

激活管理工具

通常我們在生成項目時會在 urls.py 中自動設置好，我們只需去掉注釋即可。

配置項如下所示：

當這一切都配置好後，Django 管理工具就可以運行了。

使用管理工具

啟動開發服務器，然後在瀏覽器中訪問 http://127.0.0.1:8000/admin/，得到如下界面：

你可以通過命令 python manage.py createsuperuser 來創建超級用戶，如下所示：

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

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

為了讓 admin 界面管理某個數據模型，我們需要先注冊該數據模型到 admin。比如，我們之前在 TestModel 中已經創建了模型 Test 。修改 TestModel/admin.py:

刷新後即可看到 Testmodel 數據表:

復雜模型

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

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

這里有兩個表。Tag 以 Contact 為外部鍵。一個 Contact 可以對應多個 Tag。

我們還可以看到許多在之前沒有見過的屬性類型，比如 IntegerField 用於存儲整數。

在 TestModel/admin.py 注冊多個模型併顯示：

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

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

如果你之前還未創建表結構，可使用以下命令創建：

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

自定義表單

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

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

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

由於該類對應的是 Contact 數據模型，我們在注冊的時候，需要將它們一起注冊。顯示傚果如下：

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

上面的欄目分為了 Main 和 Advance 兩部分。classes 說明它所在的部分的 CSS 格式。這里讓 Advance 部分隱藏：

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

內聯(Inline)顯示

上面的 Contact 是 Tag 的外部鍵，所以有外部參考的關系。

而在默認的頁面顯示中，將兩者分離開來，無法體現出兩者的從屬關系。我們可以使用內聯顯示，讓 Tag 附加在 Contact 的編輯頁面上顯示。

修改TestModel/admin.py：

顯示傚果如下：

列表頁的顯示

在 Contact 輸入數條記錄後，Contact 的列表頁看起來如下:

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

刷新頁面顯示傚果如下：

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

在本實例中我們搜索了 name 為 runoob 的記錄，顯示結果如下：

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