自訂管理表單¶

透過使用 admin.site.register(Question) 註冊 Question 模型，Django 能夠建構預設的表單表示。通常，您會想要自訂管理表單的外觀和運作方式。您會在註冊物件時告訴 Django 您想要的選項來執行此操作。

讓我們看看它是如何運作的，方法是重新排序編輯表單上的欄位。將 admin.site.register(Question) 行替換為

from django.contrib import admin

from .models import Question


class QuestionAdmin(admin.ModelAdmin):
    fields = ["pub_date", "question_text"]


admin.site.register(Question, QuestionAdmin)

您將遵循此模式 - 建立一個模型管理類別，然後在需要變更模型的管理選項時，將其作為第二個引數傳遞給 admin.site.register()。

上面的這個特定變更會使「發佈日期」出現在「問題」欄位之前

只有兩個欄位時，這並沒有什麼了不起，但是對於有數十個欄位的管理表單，選擇直覺的順序是很重要的可用性細節。

說到有數十個欄位的表單，您可能想要將表單分成多個欄位集

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中每個 tuple 的第一個元素是欄位集的標題。以下是我們現在的表單外觀

新增相關物件¶

好的，我們有了 Question 管理頁面，但是一個 Question 有多個 Choice，而且管理頁面沒有顯示選項。

還沒。

有兩種方法可以解決這個問題。第一種方法是像我們對 Question 所做的一樣，使用管理員註冊 Choice

from django.contrib import admin

from .models import Choice, Question

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

現在，「選項」是 Django 管理員中的可用選項。「新增選項」表單如下所示

在該表單中，「問題」欄位是一個選擇方塊，其中包含資料庫中的每個問題。Django 知道 ForeignKey 在管理員中應該表示為 <select> 方塊。在我們的例子中，此時只存在一個問題。

另請注意「問題」旁邊的「新增另一個問題」連結。每個與另一個物件具有 ForeignKey 關係的物件都會免費獲得此功能。當您點擊「新增另一個問題」時，會彈出一個視窗，其中包含「新增問題」表單。如果您在該視窗中新增一個問題並點擊「儲存」，Django 會將問題儲存到資料庫，並動態地將其新增為您正在檢視的「新增選項」表單上的選定選項。

但是，實際上，這是一種向系統新增 Choice 物件的效率低下的方式。如果您可以在建立 Question 物件時直接新增一堆選項會更好。讓我們來實現這一點。

移除 Choice 模型的 register() 呼叫。然後，編輯 Question 註冊程式碼以讀取

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)

這會告訴 Django：「Choice 物件是在 Question 管理頁面上編輯的。預設情況下，為 3 個選項提供足夠的欄位。」

載入「新增問題」頁面以查看其外觀

它的運作方式如下：相關的「選項」有三個插槽 - 如 extra 所指定 - 並且每次您回到已建立物件的「變更」頁面時，您都會獲得另外三個額外的插槽。

在目前的 3 個插槽的末尾，您會找到「新增另一個選項」連結。如果您點擊它，將新增一個新的插槽。如果您想要移除新增的插槽，您可以點擊新增插槽右上角的 X。此圖顯示新增的插槽

但是，有一個小問題。顯示所有用於輸入相關 Choice 物件的欄位會佔用大量螢幕空間。因此，Django 提供了一種以表格方式顯示內嵌相關物件的方式。要使用它，請將 ChoiceInline 宣告變更為讀取

class ChoiceInline(admin.TabularInline): ...

使用 TabularInline（而不是 StackedInline），相關物件會以更精簡、基於表格的格式顯示

請注意，有一個額外的「刪除？」欄，允許移除使用「新增另一個選項」按鈕新增的列和已儲存的列。

自訂管理變更清單¶

現在 Question 管理頁面看起來不錯，讓我們對「變更清單」頁面進行一些調整 - 該頁面會顯示系統中的所有問題。

以下是目前的外觀

預設情況下，Django 會顯示每個物件的 str()。但有時，如果我們可以顯示個別欄位會更有幫助。若要執行此操作，請使用 list_display 管理員選項，這是要顯示在物件的變更清單頁面上的欄位名稱清單（作為欄）。

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ["question_text", "pub_date"]

為了謹慎起見，我們也加入教學課程 2的 was_published_recently() 方法

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ["question_text", "pub_date", "was_published_recently"]

現在問題變更清單頁面如下所示

您可以點擊欄標題以按這些值排序 - 除了 was_published_recently 標頭的情況，因為不支援按任意方法的輸出排序。另請注意，was_published_recently 的欄標頭預設為該方法的名稱（底線會以空格取代），並且每行都包含輸出的字串表示形式。

您可以使用該方法上的 display() 修飾器（擴充在教學課程 2中建立的 polls/models.py 檔案）來改善這一點，如下所示

from django.contrib import admin


class Question(models.Model):
    # ...
    @admin.display(
        boolean=True,
        ordering="pub_date",
        description="Published recently?",
    )
    def was_published_recently(self):
        now = timezone.now()
        return now - datetime.timedelta(days=1) <= self.pub_date <= now

如需透過修飾器設定的屬性的詳細資訊，請參閱list_display。

再次編輯您的 polls/admin.py 檔案，並在 Question 變更清單頁面中新增改進：使用 list_filter 進行篩選。將以下行新增至 QuestionAdmin

list_filter = ["pub_date"]

這會新增一個「篩選器」側邊欄，讓使用者可以按 pub_date 欄位篩選變更清單

顯示的篩選器類型取決於您篩選的欄位類型。由於 pub_date 是一個 DateTimeField，Django 知道要提供適當的篩選選項：「任何日期」、「今天」、「過去 7 天」、「本月」、「今年」。

這樣看來進展不錯。讓我們加入一些搜尋功能。

search_fields = ["question_text"]

這會在變更列表的頂部加入一個搜尋框。當有人輸入搜尋詞時，Django 會搜尋 question_text 欄位。您可以根據需要使用任意多個欄位 – 雖然因為它在底層使用 LIKE 查詢，所以將搜尋欄位數量限制在合理的範圍內，會讓您的資料庫更容易執行搜尋。

現在也是時候注意到，變更列表會免費提供您分頁功能。預設是每頁顯示 100 個項目。變更 列表 分頁、搜尋 框、篩選器、日期階層 和 欄位標題排序 都會如您所想般地協同運作。

自訂管理介面的外觀和風格¶

顯然，在每個管理頁面的頂部都顯示「Django administration」是荒謬的。這只是佔位符文字。

不過，您可以使用 Django 的範本系統來變更它。Django 管理介面本身就是由 Django 提供支援，且其介面使用 Django 自己的範本系統。

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "DIRS": [BASE_DIR / "templates"],
        "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",
            ],
        },
    },
]

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

...\> py -c "import django; print(django.__path__)"

{% block branding %}
<div id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></div>
{% if user.is_anonymous %}
  {% include "admin/color_theme_toggle.html" %}
{% endif %}
{% endblock %}

自訂管理索引頁面¶

同樣地，您可能想要自訂 Django 管理索引頁面的外觀和風格。

預設情況下，它會按照字母順序列出所有在管理應用程式中註冊的 INSTALLED_APPS 中的應用程式。您可能想要對版面配置進行重大變更。畢竟，索引可能是管理介面中最重要的頁面，它應該易於使用。

要自訂的範本是 admin/index.html。（執行與上一節中 admin/base_site.html 相同的操作 – 將其從預設目錄複製到您的自訂範本目錄）。編輯該檔案，您會看到它使用一個名為 app_list 的範本變數。該變數包含每個已安裝的 Django 應用程式。您可以不使用它，而是以您認為最佳的任何方式，將連結硬編碼到特定物件的管理頁面。

當您熟悉管理介面後，請閱讀本教學的第 8 部分，以學習如何使用第三方套件。