The Django Book：第6章 Django管理系統admin

Web開發中有一些我們最討厭的部分：開發管理界面
開發站點中公眾可以看見的部分一直不一樣也很有趣，但是管理用來編輯站點的部分一直是一樣的
你不得不處理用戶認證，顯示和處理表單，處理狡猾的驗證問題...這很無聊而且是重復性的
Django解決這個無聊、重復的任務的方式呢？已經幫你都做好了，只需幾行不能再少的代碼即可
Django中最老和最強大的部分就是自動管理界面，它從你的模型中取得元數據來提供強大的產品級的界面
內容制造者可以馬上使用它給站點添加內容

激活管理界面
我們認為管理界面是Django中最cool的部分，大部分Djangonauts也同意這點
但是由于不是每個人都需要它，它是一個可選的部分
有3個步驟來激活管理界面：
1，向你的模型添加admin metadata
并不是所有的模型都可以或者應該被admin用戶編輯，所以你需要標記那些需要管理界面的模型
上一章的Book模型添加一個管理界面的方法就是：

class Book(models.Model):
    title = models.CharField(maxlength=100)
    authors = models.ManyToManyField(Author)
    publisher = models.ForeignKey(Publisher)
    publication_date = models.DateField()

    class Admin:
        pass

Admin聲明標記這個類擁有一個管理界面，在Admin之下你可以配置許多選項
目前我們采用默認值，所以我們使用pass來表示Admin類是空的
如果你正在按這個例子寫自己的代碼，現在給Publisher和Author類添加Admin聲明是個好主意
2，安裝admin模型，簡單的把"django.contrib.admin"添加到你的INSTALLED_APPS設置里
然后運行python manage.py syncdb來安裝admin使用的額外的表
注意，在你第一次運行syncdb時，你很可能被問起是否創建一個superuser
如果那時你沒有創建superuser，你需要運行djang/contrib/auth/bin/create_superuser.py
來創建一個admin用戶，否則你就不能登錄到管理界面里去
3，把URL模式添加到urls.py，如果仍在使用startproject創建的工程，admin的URL模式可能
已經在那兒了，但是被注釋掉了，你的URL模式應該像這樣：

from django.conf.urls.defaults import *

urlpatterns = patterns('',
    (r'^admin/', include('django.contrib.admin.urls')),
)

就這樣，現在運行python manage.py runserver來啟動服務器，你將看到如下信息：
Validating models...
0 errors found.

Django version 0.96-pre, using settings 'mysite.settings'
Development server is running at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
現在你可以訪問http://127.0.0.1:8000/admin/，登錄，然后隨便玩玩

使用管理界面
管理頁面設計用來給非技術人員使用，所有非常簡單，但有幾個地方需要注意
首先你將看到登錄界面，可以用你第一次運行syncdb時創建的用戶名和密碼來登錄

登錄之后你將看到你可以管理用戶，組和權限
每個聲明了Admin的對象將顯示在首頁上，添加和編輯這兩個鏈接將導向改動列表和編輯表單的頁面

改動列表是系統中對象列表的首頁
[img]http://media.djangobook.com/content/chapter06/changelist.png[/imag]
有很多選項來控制哪些域顯示在這個列表中以及其它特性的外觀，如日期格式，搜索域和過濾接口
下面會有對這些特性更多的解釋
編輯表單用來編輯已有的對象和創建新對象
你的模型的每個域將顯示在這里，不同的域類型有不同的顯示界面，如日期和時間域是日歷控件
而外鍵使用的是選擇框等等

你會注意到admin也為你處理輸入驗證，試著留一個需要的域不填，或者在一個時間域里輸入不合法的時間，你會看到當你保存時出現錯誤顯示

驗證是第7章講到的一個強大的驗證框架來做的
當編輯一個對象時你會在右上方看到一個歷史鏈接，admin上的每一個改動都會被記入日志
你可以點擊歷史按鈕來查看日志

admin里的刪除是級聯的，當你刪除一個對象時，admin會讓你確認刪除動作以避免代價昂貴的錯誤
確認頁面也會顯示所有將被刪除的相關的對象


用戶，組，權限
既然你用superuser登錄，你擁有創建，編輯和刪除任何對象的權限
盡管如此，admin也有一個用戶權限系統，你可以使用它來約束其它用戶的訪問權限
你可以像編輯其它對象一樣來編輯這些用戶和權限，用戶和組模型的鏈接和其它你定義的對象一樣顯示在admin首頁
用戶對象有標準的用戶名，密碼，郵件和真實姓名域，以及一些定義用戶在admin的權限的域
首先，這里有一些flags：
1，“is active”控制用戶是否是活動的，如果這項flag為off，這個用戶將不能訪問任何需要登錄的URL
2，“is staff”控制用戶是否允許登錄admin，由于第12章講到這個用戶系統同樣被用來控制對public頁面的
訪問權限，這個flag對于public用戶和管理員的含義不同
3，“is superuser”給予用戶在admin的任何訪問權限，普通的權限將被忽略
對于正常的admin用戶，即活動的而非superuser的staff用戶，他們的訪問權限取決于一些被分配的權限
每個可以在admin編輯的對象擁有3個權限：創建權限，編輯權限和刪除權限，給一個用戶賦予權限將
允許用戶訪問這些權限所描述的頁面
注意，對編輯用戶和編輯權限的訪問同樣在這個權限系統控制，如果你給一個用戶編輯用戶的權限，
她將可以編輯她自己的權限，這可能是你的初衷！
你也可以給用戶分配組，一個組就是一些權限，組的權限將分配給組的成員
給用戶賦予一套數量很多的權限時組就很有用了

定制管理界面
有許多方式來定制admin的界面外觀和行為，我們僅僅看其中跟我們的“Book”模型相關的一些
第12章詳述了定制admin界面
現在books的改動列表僅僅顯示模型的string展現，即__str__
這對于少量的books可以很好的工作，但是如果我們有成千上萬的books，這將很難在干草推里找到唯一的那根針
盡管如此，我們可以給這個界面很方便的添加一些顯示，搜索和過濾方法，編輯Admin定義：

class Book(models.Model):
    title = models.CharField(maxlength=100)
    authors = models.ManyToManyField(Author)
    publisher = models.ForeignKey(Publisher)
    publication_date = models.DateField()

    class Admin:
        list_display   = ('title', 'publisher', 'publication_date')
        list_filter    = ('publisher', 'publication_date')
        ordering       = ('-publication_date',)
        search_fields  = ('title',)

這4行代碼神奇的改變了我們的列表界面：

這些定義中的每一行都告訴admin來構建一個不同的界面：
1，ordering選項控制了對象在admin里面顯示的順序，它是對結果排序的域的列表
前面加一個減號將排反序，所以例子中我們對publication_date排序，最近的書將顯示在最前面
2，list_display選項控制了在改動列表里哪些列將顯示，默認情況下將只顯示對象的string展示
這一個單獨的列，這里我們顯示title，publisher和publication_date
3，list_filter選項將在列表的右上方創建過濾器條,我們允許通過date和publisher來過濾
你可以讓admin過濾任何域，但是外鍵或者有chioces屬性集的域工作的更好
4，最后search_fields選項創建一個允許文本搜索的域，這里允許通過title域搜索
通過這里以及第12章描述的選項你可以只用幾行代碼構建一個強大的具備產品能力的編輯數據界面


定制管理系統的外觀
顯然在每個管理頁面的頂端擁有一個“Django 管理系統”是很荒謬的，它只是一個占位文本
盡管如此，使用Django的模板系統可以很容易改變這點，Django的admin是Django自己支持的
它的界面使用Django自己的模板系統
打開mysite/settings.py看看TEMPLATE_DIRS設置，用來載入Django模板時檢查文件系統目錄
它是一個搜索的路徑，默認情況下它是空的，下面我們加點東西來告訴Django我們的模板在哪：

TEMPLATE_IDRS = (
    "/home/mytemplates", # Change this to your own directory.
)

注意這里包括了最后的逗號，Python使用它來區分單元素元組和括號括起來的表達式
現在把admin/base_site.html從Django的admin模板目錄(django/contrib/admin/templates)復制到
TEMPLATE_DIRS下的admin子目錄下，admin是新建的子目錄
然后編輯admin/base_site.html，用你自己的站點的名字替換Django文本
注意任何Django的默認admin模板都可以覆蓋，只需像base_site.html一樣覆蓋模板
即從默認目錄復制你的自定義目錄然后改變這個副本
敏銳的讀者可能想知道，如果TEMPLATE_DIRS默認是空的，Django是怎樣找到默認的admin模板的？
答案是，默認情況下Django自動在每個app包下搜尋templates/子目錄下的模板
看看第10章的“模板載入器”你將了解關于它的更多信息

定制管理系統首頁
同樣需要注意的是，你可能想定制Django的admin首頁外觀
默認時它將根據INSTALLED_APPS并按程序名排序顯示所有的apps
盡管如此，你可能想改變這個顯示順序來使你更容易找到你要的apps
畢竟首頁時admin最重要的頁面，它應該很容易使用才行
需要定制的模板時admin/index.html，記得把admin/base_site.html復制到你的自定義模板目錄
編輯這個文件，你將看到它使用模板標簽{% get_admin_app_list as app_list %}
這就是得到所有安裝的Django app的魔法所在
你可以用你認為最好的方法硬編碼對象專有的admin頁面來替換這個標簽
如果你不太明白硬編碼鏈接，可以參考第10章的實現你自己的模板標簽的細節
Django在這個地方提供另一個捷徑，運行python mange.py adminindex <app>來在admin首頁模板
包含一些模板代碼，開始時這十分有用
參考第12章關于定制Django的admin站點外觀的細節

何時使用和為什么使用管理界面
我們認為Django的admin界面很神奇，事實上，我們稱它為Django的一個“殺手級特性”
盡管如此，我們經常被問到admin的“use cases”這個問題，即什么時候我們使用它，以及為什么使用它？
這幾年我們討論了許多使用admin界面可能有幫助的模式
顯然它對于編輯數據十分有用，如果你有一些數據輸入的任務，admin就是你想要的
我們也發現admin在下面幾種情況下十分有用：
1，檢查數據模型，當我們定義一個新模型后第一件事就是在admin里面激活它并且輸入一些模擬數據
發現一些數據模型錯誤是很常見的，有一個圖形界面來揭露這些錯誤會很有用
2，管理需要的數據，例如對于chicagocrime.org有自動的數據數據產生源，但是當數據源出現問題，
我們可以通過admin很輕松的編輯數據

安徽新華電腦學校專業職業規劃師為你提供更多幫助【在線咨詢】