编写你的第一个 Django 应用程序，第 7 部分 — Django 文档

编写你的第一个 Django 应用，第 7 部分

本教程从 教程 6 停止的地方开始。 我们将继续使用 Web-poll 应用程序，并将专注于自定义 Django 自动生成的管理站点，我们在 教程 2 中首次探讨了该站点。

自定义后台表单

通过将 Question 模型注册到 admin.site.register(Question)，Django 能够构建一个默认的表单表示。 通常，您需要自定义管理表单的外观和工作方式。 您将通过在注册对象时告诉 Django 您想要的选项来完成此操作。

让我们通过对编辑表单上的字段重新排序来看看这是如何工作的。 将 admin.site.register(Question) 行替换为：

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)

您将遵循此模式 - 创建一个模型管理类，然后将其作为第二个参数传递给 admin.site.register() - 任何时候您需要更改模型的管理选项。

上面的这个特殊更改使“发布日期”出现在“问题”字段之前：

Fields have been reordered 只有两个字段并不令人印象深刻，但对于具有数十个字段的管理表单，选择直观的顺序是一个重要的可用性细节。

说到拥有数十个字段的表单，你可能更期望将表单分为几个字段集：

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 中每个元组的第一个元素是字段集的标题。 这是我们的表单现在的样子：

Form has fieldsets now

添加关联的对象

好的，我们有我们的问题管理页面，但是 Question 有多个 Choice，并且管理页面不显示选项。

好了。

有两种方法可以解决这个问题。 第一个是向管理员注册 Choice，就像我们对 Question 所做的一样。 这很容易：

polls/admin.py

from django.contrib import admin

from .models import Choice, Question
# ...
admin.site.register(Choice)

现在“选择”是 Django 管理中的一个可用选项。 “添加选择”表单如下所示：

Choice admin page 在该表单中，“问题”字段是一个包含数据库中每个问题的选择框。 Django 知道 ForeignKey 应该在管理中表示为 <select> 框。 在我们的案例中，此时只存在一个问题。

另请注意“问题”旁边的“添加另一个”链接。 每个与另一个具有 ForeignKey 关系的对象都可以免费获得。 当您单击“添加另一个”时，您将看到一个带有“添加问题”表单的弹出窗口。 如果您在该窗口中添加一个问题并单击“保存”，Django 会将该问题保存到数据库中，并动态地将其添加为您正在查看的“添加选择”表单上的选定选项。

但是，实际上，这是将 Choice 对象添加到系统的一种低效方式。 如果在创建Question对象时能直接添加一堆Choices就更好了。 让我们做到这一点。

删除 Choice 模型的 register() 调用。 然后，编辑Question注册码为：

polls/admin.py

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 个选项提供足够的字段。”

加载“添加问题”页面以查看其外观：

Add question page now has choices on it 它的工作原理是这样的：相关选项有三个槽位——由 extra 指定——每次你回到一个已经创建的对象的“更改”页面时，你都会得到另外三个额外的槽位。

在三个当前插槽的末尾，您会找到“添加另一个选择”链接。 如果单击它，将添加一个新插槽。 如果要删除添加的插槽，可以单击添加的插槽右上角的 X。 请注意，您不能删除原来的三个插槽。 此图显示了添加的插槽：

Additional slot added dynamically 不过有一个小问题。 显示用于输入相关 Choice 对象的所有字段需要大量屏幕空间。 出于这个原因，Django 提供了一种显示内联相关对象的表格方式； 您只需要将 ChoiceInline 声明更改为：

polls/admin.py

class ChoiceInline(admin.TabularInline):
    #...

使用 TabularInline（而不是 StackedInline），相关对象将以更紧凑、基于表格的格式显示：

Add question page now has more compact choices 请注意，还有一个额外的“删除？” 允许删除使用“添加另一个选择”按钮添加的行和已保存的行的列。

自定义后台更改列表

现在问题管理页面看起来不错，让我们对“更改列表”页面进行一些调整——显示系统中所有问题的页面。

这是此时的样子：

Polls change list page 默认情况下，Django 显示每个对象的 str()。 但有时如果我们可以显示单个字段会更有帮助。 为此，请使用 list_display 管理选项，这是一个字段名称元组，以列的形式显示在对象的更改列表页面上：

polls/admin.py

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ('question_text', 'pub_date')

为了更好地衡量，我们还包括 教程 2 中的 was_published_recently() 方法：

polls/admin.py

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

现在修改投票的列表页看起来像这样：

Polls change list page, updated 您可以单击列标题以按这些值排序——was_published_recently 标题除外，因为不支持按任意方法的输出排序。 另请注意，was_published_recently 的列标题默认是方法的名称（下划线替换为空格），并且每一行都包含输出的字符串表示形式。

您可以通过为该方法（在 polls/models.py 中）提供一些属性来改进它，如下所示：

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?'

有关这些方法属性的更多信息，请参阅 list_display。

再次编辑您的 polls/admin.py 文件并对 Question 更改列表页面进行改进：使用 list_filter 的过滤器。 将以下行添加到 QuestionAdmin：

list_filter = ['pub_date']

添加了一个“过滤器”侧边栏，让人们可以通过 pub_date 字段过滤更改列表：

Polls change list page, updated 显示的过滤器类型取决于您过滤的字段类型。 因为 pub_date 是 DateTimeField，所以 Django 知道提供适当的过滤选项：“任何日期”、“今天”、“过去 7 天”、“本月”、“今年”。

这塑造得很好。 让我们添加一些搜索功能：

search_fields = ['question_text']

这会在更改列表的顶部添加一个搜索框。 当有人输入搜索词时，Django 将搜索 question_text 字段。 您可以使用任意数量的字段——尽管因为它在后台使用 LIKE 查询，将搜索字段的数量限制为合理的数量将使您的数据库更容易进行搜索。

现在也是注意更改列表为您提供免费分页的好时机。 默认是每页显示 100 个项目。 更改列表分页、搜索框、过滤器、日期层次结构和列标题排序所有像您认为的那样一起工作。

自定义后台界面和风格

显然，在每个管理页面的顶部都有“Django 管理”是荒谬的。 这只是占位符文本。

但是，使用 Django 的模板系统很容易更改。 Django admin 由 Django 本身提供支持，其接口使用 Django 自己的模板系统。

自定义您的 项目的 模板

在您的项目目录（包含 manage.py 的目录）中创建一个 templates 目录。 模板可以位于文件系统上 Django 可以访问的任何位置。 （Django 以您的服务器运行的任何用户身份运行。）但是，将模板保留在项目中是一个很好的约定。

打开您的设置文件（mysite/settings.py ，记住）并添加一个 :setting:`目录 ` 选项中 ：设置：`模板` 环境：

mysite/settings.py

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(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',
            ],
        },
    },
]

:setting:`目录 ` 是加载 Django 模板时要检查的文件系统目录列表； 这是一个搜索路径。

组织模板

就像静态文件一样，我们 可以 将所有模板放在一起，放在一个大模板目录中，它会运行得非常好。 但是，属于特定应用程序的模板应放置在该应用程序的模板目录中（例如 polls/templates) 而不是项目的 (templates)。 我们将在 可重用应用教程 为什么 中更详细地讨论我们这样做。

现在在 templates 中创建一个名为 admin 的目录，并从 Django 本身的源代码中的默认 Django 管理模板目录中复制模板 admin/base_site.html (django/contrib/admin/templates ]) 进入该目录。

Django 的源文件在哪里？

如果你不知道 Django 源码在你系统的哪个位置，运行以下命令：

然后，只需编辑文件并将 模板:Site header（包括花括号）替换为您认为合适的站点名称。 你应该得到一段代码，如：

{% block branding %}
<h1 id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></h1>
{% endblock %}

我们使用这种方法来教您如何覆盖模板。 在实际项目中，您可能会使用 django.contrib.admin.AdminSite.site_header 属性来更轻松地进行此特定自定义。

该模板文件包含大量文本，如 {% block branding %} 和 模板:Title。 {% 和 {{ 标签是 Django 模板语言的一部分。 当 Django 呈现 admin/base_site.html 时，将评估此模板语言以生成最终的 HTML 页面，就像我们在 教程 3 中看到的那样。

请注意，任何 Django 的默认管理模板都可以被覆盖。 要覆盖模板，只需执行与 base_site.html 相同的操作——将其从默认目录复制到您的自定义目录中，然后进行更改。

自定义您的 应用程序的 模板

精明的读者会问：但如果 :setting:`目录 ` 默认情况下为空，Django 是如何找到默认管理模板的？ 答案是，由于 ：设置：`APP_DIRS ` 被设定为True , Django 会自动寻找一个templates/每个应用程序包中的子目录，用作后备（不要忘记django.contrib.admin是一个应用程序）。

我们的投票应用程序不是很复杂，也不需要自定义管理模板。 但是，如果它变得更加复杂并且需要针对其某些功能修改 Django 的标准管理模板，那么修改 应用程序的 模板而不是 项目 中的模板会更明智。 这样，您就可以在任何新项目中包含投票应用程序，并确保它会找到所需的自定义模板。

有关 Django 如何找到其模板的更多信息，请参阅 模板加载文档 。

自定义后台主页

在类似的说明中，你可能想要自定义 Django 后台索引页的外观。

默认情况下，它会按字母顺序显示 :setting:`INSTALLED_APPS` 中已在管理应用程序中注册的所有应用程序。 您可能希望对布局进行重大更改。 毕竟，索引可能是管理员最重要的页面，应该很容易使用。

自定义模板为admin/index.html。 （与上一节中的 admin/base_site.html 相同 - 将其从默认目录复制到您的自定义模板目录）。 编辑该文件，您将看到它使用了一个名为 app_list 的模板变量。 该变量包含每个已安装的 Django 应用程序。 您可以使用您认为最好的任何方式硬编码指向特定于对象的管理页面的链接，而不是使用它。

下一步是什么？

初学者教程到此结束。 同时，您可能想查看有关 从这里开始 的一些指示。

如果您熟悉 Python 打包并且有兴趣学习如何将投票变成“可重用的应用程序”，请查看 高级教程：如何编写可重用的应用程序 。