該系列教程系個人原創(chuàng)，并完整發(fā)布在個人官網(wǎng)劉江的博客和教程

所有轉(zhuǎn)載本文者，需在頂部顯著位置注明原作者及www.官網(wǎng)地址。

本節(jié)我們主要介紹在第二部分提到過的admin后臺管理站點。

Django的admin站點是自動生成的、高度可定制的，它是Django相較其它Web框架獨有的內(nèi)容，廣受歡迎。如果你覺得它不夠美觀，還有第三方美化版xadmin。請一定不要忽略它，相信我，它值得擁有！

一、定制模型表單

在前面的學(xué)習(xí)過程中，通過admin.site.register(Question)語句，我們在admin站點中注冊了Question模型。Django會自動生成一個該模型的默認表單頁面。如果你想自定義該頁面的外觀和工作方式，可以在注冊對象的時候告訴Django你的自定義選項。

下面是一個修改admin表單默認排序方式的例子。修改polls/admin.py的代碼：：

from django.contrib import admin
from .models import Question


class QuestionAdmin(admin.ModelAdmin):
    fields = ['pub_date', 'question_text']
    
admin.site.register(Question, QuestionAdmin)

你只需要創(chuàng)建一個繼承admin.ModelAdmin的模型管理類，然后將它作為第二個參數(shù)傳遞給admin.site.register()，第一個參數(shù)則是Question模型本身。

上面的修改讓Publication date字段顯示在Question字段前面了（默認是在后面）。如下圖所示：

對于只有2個字段的情況，效果看起來還不是很明顯，但是如果你有一打的字段，選擇一種直觀的符合我們?nèi)祟惲?xí)慣的排序方式則非常有用。

還有，當(dāng)表單含有大量字段的時候，你也許想將表單劃分為一些字段的集合。再次修改polls/admin.py:

from django.contrib import admin

from .models import Question

class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,               {'fields': ['question_text']}),
        ('Date information', {'fields': ['pub_date']}),
    ]

admin.site.register(Question, QuestionAdmin)

字段集合fieldsets中每一個元組的第一個元素是該字段集合的標(biāo)題。它讓我們的頁面看起來像下面的樣子：

二、添加關(guān)聯(lián)對象

雖然我們已經(jīng)有了Question的管理頁面，但是一個Question有多個Choices，如果想顯示Choices的內(nèi)容怎么辦？有兩個辦法可以解決這個問題。第一個是像Question一樣將Choice注冊到admin站點，這很容易，修改polls/admin.py，增加下面的內(nèi)容：

from django.contrib import admin
from .models import Choice, Question

# ...
admin.site.register(Choice)

重啟服務(wù)器，再次訪問admin頁面，就可以看到Choice條目了：

點擊它右邊的add按鈕，進入“Add Choice”表單頁面，看起來如下圖：

在這個表單中，Question字段是一個select選擇框，包含了當(dāng)前數(shù)據(jù)庫中所有的Question實例。Django在admin站點中，自動地將所有的外鍵關(guān)系展示為一個select框。在我們的例子中，目前只有一個question對象存在。

請注意圖中的綠色加號，它連接到Question模型。每一個包含外鍵關(guān)系的對象都會有這個綠色加號。點擊它，會彈出一個新增Question的表單，類似Question自己的添加表單。填入相關(guān)信息點擊保存后，Django自動將該Question保存在數(shù)據(jù)庫，并作為當(dāng)前Choice的關(guān)聯(lián)外鍵對象。白話講就是，新建一個Question并作為當(dāng)前Choice的外鍵。

但是實話說，這種創(chuàng)建方式的效率不怎么樣。如果在創(chuàng)建Question對象的時候就可以直接添加一些Choice，那會更好，這就是我們要說的第二種方法。下面，讓我們來動手試試。

首先，刪除polls/admin.py中Choice模型對register()方法的調(diào)用。然后，編輯Question的內(nèi)容，最后整個文件的代碼應(yīng)該如下：

from django.contrib import admin

from .models import Choice, Question


class ChoiceInline(admin.StackedInline):
    model = Choice
    extra = 3


class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,               {'fields': ['question_text']}),
        ('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}),
    ]
    inlines = [ChoiceInline]

admin.site.register(Question, QuestionAdmin)

上面的代碼相當(dāng)于告訴Django，Choice對象將在Question管理頁面進行編輯，默認情況，請?zhí)峁?個Choice對象的編輯區(qū)域。

重啟服務(wù)器，進入“Add question”頁面，應(yīng)該看到如下圖所示：

在3個插槽的最后，還有一個Add another Choice鏈接。點擊它，又可以獲得一個新的插槽。如果你想刪除新增的插槽，點擊它最右邊的灰色X圖標(biāo)即可。但是，默認的三個插槽不可刪除。

這里還有點小問題。上面頁面中插槽縱隊排列的方式需要占據(jù)大塊的頁面空間，查看起來很不方便。為此，Django提供了一種扁平化的顯示方式，你僅僅只需要修改一下ChoiceInline繼承的類為admin.TabularInline替代先前的StackedInline類（其實，從類名上你就能看出兩種父類的區(qū)別）。

# polls/admin.py
class ChoiceInline(admin.TabularInline):
    #...

重啟服務(wù)器，刷新一下頁面，你會看到類似表格的顯示方式：

注意“DELETE”列，它可以刪除那些已有的Choice和新建的Choice。

三、定制實例列表頁面

Question的添加和修改頁面我們已經(jīng)修改得差不多了，下面讓我們來裝飾一下“實例列表”(change list)頁面，該頁面顯示了當(dāng)前系統(tǒng)中所有的questions實例。

默認情況下，該頁面看起來是這樣的：

通常，Django只顯示__str()__方法指定的內(nèi)容。但是很多時候，我們可能要同時顯示一些別的內(nèi)容。要實現(xiàn)這一目的，可以使用list_display屬性，它是一個由字段組成的元組，其中的每一個字段都會按順序顯示在“change list”頁面上，代碼如下：

# polls/admin.py
class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ('question_text', 'pub_date', 'was_published_recently')

額外的，我們把was_published_recently()方法的結(jié)果也顯示出來?，F(xiàn)在，頁面看起來會是下面的樣子：

你可以點擊每一列的標(biāo)題，來根據(jù)這列的內(nèi)容進行排序。但是was_published_recently這一列除外，不支持這種根據(jù)函數(shù)輸出結(jié)果進行排序的方式。同時請注意，was_published_recently這一列的列標(biāo)題默認是方法的名字，內(nèi)容則是輸出的字符串表示形式。

可以通過給方法提供一些屬性來改進輸出的樣式，如下面所示。注意這次修改的是polls/models.py文件，不要搞錯了！主要是增加了最后面三行內(nèi)容：

# polls/models.py
class Question(models.Model):
    # ...
    def was_published_recently(self):
        now = timezone.now()
        return now - datetime.timedelta(days=1) <= self.pub_date <= now
    was_published_recently.admin_order_field = 'pub_date'
    was_published_recently.boolean = True
    was_published_recently.short_description = 'Published recently?'

重啟服務(wù)器(這個我就不再啰嗦了，大家心里都有數(shù))。刷新頁面，效果如下：

以上的定制功能還不是admin的全部，我們接著往下看！

我們還可以對顯示結(jié)果進行過濾!使用list_filter屬性，在polls/admin.py的QuestionAdmin中添加下面的代碼：

list_filter = ['pub_date']

再次刷新change list頁面，你會看到在頁面右邊多出了一個基于pub_date的過濾面板，如下圖所示：

根據(jù)你選擇的過濾條件的不同，Django會在面板中添加不同的過濾選項。由于pub_date是一個DateTimeField，因此Django自動添加了這些選項：“Any date”, “Today”, “Past 7 days”, “This month”, “This year”。

順理成章的，讓我們添加一些搜索的能力：

search_fields = ['question_text']

這會在頁面的頂部增加一個搜索框。當(dāng)輸入搜索關(guān)鍵字后，Django會在question_text字段內(nèi)進行搜索。只要你愿意，你可以使用任意多個搜索字段，Django在后臺使用的都是SQL查詢語句的LIKE語法，但是有限制的搜索字段有助于后臺的數(shù)據(jù)庫查詢效率。

其實，這個頁面還提供分頁功能，默認每頁顯示100條，只是我們的實例只有一個，囧，所以看到分頁鏈接。

四、定制admin整體界面

很明顯，在每一個項目的admin頁面頂端都顯示Django administration是很可笑的，它僅僅是個占位文本。利用Django的模板系統(tǒng)，我們可以快速修改它。

1.定制項目模板

在manage.py文件同級下創(chuàng)建一個templates目錄。然后，打開設(shè)置文件mysite/settings.py，在TEMPLATES條目中添加一個DIRS選項：

# mysite/settings.py
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],  # 要有這一行，如果已經(jīng)存在請保持原樣
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

DIRS是一個文件系統(tǒng)目錄的列表，是模板的搜索路徑。當(dāng)加載Django模板時，會在DIRS中進行查找。

PS：模板的組織方式

就像靜態(tài)文件一樣，我們可以把所有的模板都放在一起，形成一個大大的模板文件夾，并且工作正常。但是請一定不要這么做！強烈建議每一個模板都應(yīng)該存放在它所屬應(yīng)用的模板目錄內(nèi)（例如polls/templates）而不是整個項目的模板目錄（templates），因為這樣每個應(yīng)用才可以被方便和正確的重用。只有對整個項目有作用的模板文件才放在根目錄的templates中，比如admin界面。

回到剛才創(chuàng)建的templates目錄中，再創(chuàng)建一個admin目錄，將admin/base_site.html模板文件拷貝到該目錄內(nèi)。這個HTML文件來自Django源碼，它位于django/contrib/admin/templates目錄內(nèi)。
（在我的windows系統(tǒng)中，它位于C:\Python36\Lib\site-packages\django\contrib\admin\templates\admin，請大家參考。）

Django的源代碼在哪里？

如果你無法找到Django源代碼文件的存放位置，可以使用下面的命令：

$ python -c "import django; print(django.__path__)"

編輯base_site.html文件，用你喜歡的站點名字替換掉{{ site_header|default:_(’Django administration’) }}（包括兩個大括號一起替換掉），看起來像下面這樣：

{% extends "admin/base.html" %}

{% block title %}{{ title }} | {{ site_title|default:_('Django site admin') }}{% endblock %}

{% block branding %}
<h1 id="site-name"><a href="{% url 'admin:index' %}">投票站點管理界面</a></h1>
{% endblock %}

{% block nav-global %}{% endblock %}

在這里，我們使用的是硬編碼，強行改名為"投票站點管理界面"。但是在實際的項目中，你可以使用django.contrib.admin.AdminSite.site_header屬性，方便的對這個頁面title進行自定義。

修改完后，刷新頁面，效果如下：

提示：所有Django默認的admin模板都可以被重寫，類似剛才重寫base_site.html模板的方法一樣，從源代碼目錄將HTML文件拷貝至你自定義的目錄內(nèi)，然后修改文件。

五、定制admin首頁

默認情況下，admin首頁顯示所有INSTALLED_APPS內(nèi)并在admin應(yīng)用中注冊過的app，以字母順序進行排序。

要定制admin首頁，你需要重寫admin/index.html模板，就像前面修改base_site.html模板的方法一樣，從源碼目錄拷貝到你指定的目錄內(nèi)。編輯該文件，你會看到文件內(nèi)使用了一個app_list模板變量。該變量包含了所有已經(jīng)安裝的Django應(yīng)用。你可以硬編碼鏈接到指定對象的admin頁面，使用任何你認為好的方法，用于替代這個app_list。

六、源碼對照

至此，Django教程的入門部分已經(jīng)結(jié)束了。下面將polls/admin.py的全部代碼貼出來：

from django.contrib import admin

from .models import Choice, Question


class ChoiceInline(admin.TabularInline):
    model = Choice
    extra = 3


class QuestionAdmin(admin.ModelAdmin):
    list_display = ('question_text', 'pub_date', 'was_published_recently')
    fieldsets = [
        (None,               {'fields': ['question_text']}),
        ('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}),
    ]
    inlines = [ChoiceInline]
    list_filter = ['pub_date']
    search_fields = ['question_text']

admin.site.register(Question, QuestionAdmin)

整個投票項目mysite，在Pycharm中的文件組織結(jié)構(gòu)如下圖所示，對比一下你自己的，看看是否一樣。

注意2017.png是展示用的背景圖，這個可以不一樣....

admin后臺管理站點可以定制得很強大，比如下面是博主站點的評論后臺，完全手工定制，非常實用！