Django 的最大賣點之一是其一流的管理界面。這個工具是按照最終用戶的思路設計的。它為我們的項目提供了很多數據輸入工具。管理工具是 Dj
管理工具是 Django 提供的一個應用程序。與 jobs
應用程序一樣,在使用之前也必須進行安裝。第一個步驟是將應用程序的模塊(django.contrib.admin
)添加到 INSTALLED_APPS 設置中:
1
2
3
4
5
6
7
8
|
INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'djproject.jobs', 'django.contrib.admin', ) |
要讓該管理工具可以通過 /admin URL 使用,只需要簡單地取消項目的 urls.py 文件中提供的對應行的內容即可。下一節將詳細介紹 URL 的配置。
1
2
3
4
5
|
from django.conf.urls.defaults import * urlpatterns = patterns('', (r'^admin/', include('django.contrib.admin.urls.admin')), ) |
這個管理應用程序有自己的數據庫模型,但也需要進行安裝。我們可以再次使用 syncdb
命令來完成這個過程:
python manage.py syncdb
要查看這個管理工具,可以使用 Django 提供的測試服務器。
1
2
3
4
5
6
7
|
~/dev/djproject$ python manage.py runserver Validating models... 0 errors found. Django version 0.95 (post-magic-removal), using settings 'djproject.settings' Development server is running at http://127.0.0.1:8000/ Quit the server with CONTROL-C (Unix) or CTRL-BREAK (Windows). |
現在可以使用 http://localhost:8000/admin 啟動管理工具,并使用前面創建的超級用戶帳號進行登錄。我們注意到現在還沒有可用的模塊。
要讓一個類可以通過管理工具進行訪問,我們需要為其創建一個 Admin 子類。然后可以通過為這個子類添加類屬性來定制如何對每個類進行管理。清單 19 展示了如何將 Location 類添加到這個管理工具中。
1
2
3
4
|
class Location(meta.Model): ... class Admin: list_display = ("city", "state", "country") |
現在就可以通過管理界面來創建、更新和刪除 Location 記錄了。
可以按照 list_display
類的屬性指定的城市、州和國家來列出記錄并對它們進行排序。
管理工具有無數用來管理每種模塊類的選項。清單 20 給出了幾個適用于 Job 類的例子:
1
2
3
4
5
6
7
|
class Job(meta.Model): ... class Admin: list_display = ("job_title", "location", "pub_date") ordering = ["-pub_date"] search_fields = ("job_title", "job_description") list_filter = ("location",) |
根據以上設置,職位的標題、位置和發布日期都會在顯示職位記錄時用到。職位可以按照發布時間進行排序,最開始是最近發布的職位(減號表示降序)。用戶可以按照標題和說明來查找職位,管理員可以根據位置對記錄進行過濾。