{"title":"编写你的第一个 Django 应用，第 7 部分","version":"5.2","locale":"zh-hans","docname":"intro/tutorial07","url":"/zh-hans/5.2/intro/tutorial07/","canonical":"https://djangodocs.dev/zh-hans/5.2/intro/tutorial07/","summary":"本教程从 教程第 6 部分 结束的地方开始。我们继续修改在线投票应用，这次我们专注于自定义我们在 教程第 2 部分 初见过的 Django 自动生成后台的过程。 从哪里获得帮助： 如果你在阅读本教程的过程中有任何疑问，可以前往 FAQ 的 获取帮助 的版块。 自定义后台表单 Link to this heading # 通过…","html":"

编写你的第一个 Django 应用，第 7 部分Link to this heading#

\n

本教程从 教程第 6 部分 结束的地方开始。我们继续修改在线投票应用，这次我们专注于自定义我们在 教程第 2 部分 初见过的 Django 自动生成后台的过程。

\n\n
\n

自定义后台表单Link to this heading#

\n

通过 admin.site.register(Question) 注册 Question 模型，Django 能够构建一个默认的表单用于展示。通常来说，你期望能自定义表单的外观和工作方式。你可以在注册模型时将这些设置告诉 Django。

\n

让我们通过重排列表单上的字段来看看它是怎么工作的。用以下内容替换 admin.site.register(Question)：

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fields = ["pub_date", "question_text"]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

你需要遵循以下流程——创建一个模型后台类，接着将其作为第二个参数传给 admin.site.register() ——在你需要修改模型的后台管理选项时这么做。

\n

以上修改使得 "Publication date" 字段显示在 "Question" 字段之前：

\n\"字段已重新排序\"\n

这在只有两个字段时显得没啥卵用，但对于拥有数十个字段的表单来说，为表单选择一个直观的排序方法就显得你的针很细了。

\n

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

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fieldsets = [\n        (None, {"fields": ["question_text"]}),\n        ("Date information", {"fields": ["pub_date"]}),\n    ]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

fieldsets 元组中的第一个元素是字段集的标题。以下是我们的表单现在的样子：

\n\"表单现在有字段集\"\n
\n\n
\n

自定义后台更改列表Link to this heading#

\n

现在投票的后台页看起来很不错，让我们对“更改列表”页面进行一些调整——改成一个能展示系统中所有投票的页面。

\n

以下是它此时的外观：

\n\"民意调查更改列表页面\"\n

默认情况下，Django 显示每个对象的 str()。但有时如果我们能显示单个字段会更有帮助。为此，请使用 list_display admin 选项，该选项是要在对象的更改列表页上以列形式显示的字段名称列表：

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date"]\n
\n

另外，让我们把 教程第 2 部分 中的 was_published_recently() 方法也加上：

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date", "was_published_recently"]\n
\n

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

\n\"投票更改列表页面，已更新\"\n

你可以点击列标题来对这些行进行排序——除了 was_published_recently 这个列，因为没有实现排序方法。顺便看下这个列的标题 was_published_recently，默认就是方法名（用空格替换下划线），该列的每行都以字符串形式展示出处。

\n

你可以通过在该方法上使用 display() 装饰器来改进这一点（扩展在 教程 2 中创建的 polls/models.py 文件），如下所示：

\n
polls/models.py
\n
Python
from django.contrib import admin\n\n\nclass Question(models.Model):\n    # ...\n    @admin.display(\n        boolean=True,\n        ordering="pub_date",\n        description="Published recently?",\n    )\n    def was_published_recently(self):\n        now = timezone.now()\n        return now - datetime.timedelta(days=1) <= self.pub_date <= now\n
\n

更多关于可通过装饰器设置的属性的信息，请参见 list_display。

\n

再次编辑文件 polls/admin.py，优化 Question 变更页：过滤器，使用 list_filter。将以下代码添加至 QuestionAdmin：

\n
Code
list_filter = ["pub_date"]\n
\n

这样做添加了一个“过滤器”侧边栏，允许人们以 pub_date 字段来过滤列表：

\n\"投票更改列表页面，已更新\"\n

展示的过滤器类型取决你你要过滤的字段的类型。因为 pub_date 是类 DateTimeField，Django 知道要提供哪个过滤器：“任意时间”，“今天”，“过去7天”，“这个月”和“今年”。

\n

这已经弄的很好了。让我们再扩充些功能:

\n
Code
search_fields = ["question_text"]\n
\n

在列表的顶部增加一个搜索框。当输入待搜项时，Django 将搜索 question_text 字段。你可以使用任意多的字段——由于后台使用 LIKE 来查询数据，将待搜索的字段数限制为一个不会出问题大小，会便于数据库进行查询操作。

\n

现在是给你的修改列表页增加分页功能的好时机。默认每页显示 100 项。变更页分页, 搜索框, 过滤器, 日期层次结构, 和 列标题排序 均以你期望的方式合作运行。

\n
\n
\n

自定义后台界面和风格Link to this heading#

\n

在每个后台页顶部显示“Django 管理员”显得很滑稽。这只是一串占位文本。

\n

不过，你可以通过 Django 的模板系统来修改。Django 的后台由自己驱动，且它的交互接口采用 Django 自己的模板系统。

\n
\n

自定义你的 工程的 模板Link to this heading#

\n

在你的 djangotutorial 目录中创建一个 templates 目录。模板可以存放在 Django 可以访问的文件系统中的任何位置。（Django 以服务器运行的任何用户身份运行。）然而，将模板保留在项目内是一个值得遵循的良好惯例。

\n

打开你的设置文件（mysite/settings.py，牢记），在 TEMPLATES 设置中添加 DIRS 选项：

\n
mysite/settings.py
\n
Python
TEMPLATES = [\n    {\n        "BACKEND": "django.template.backends.django.DjangoTemplates",\n        "DIRS": [BASE_DIR / "templates"],\n        "APP_DIRS": True,\n        "OPTIONS": {\n            "context_processors": [\n                "django.template.context_processors.request",\n                "django.contrib.auth.context_processors.auth",\n                "django.contrib.messages.context_processors.messages",\n            ],\n        },\n    },\n]\n
\n

DIRS 是一个包含多个系统目录的文件列表，用于在载入 Django 模板时使用，是一个待搜索路径。

\n\n

现在在 templates 目录内创建一个名为 admin 的目录，并将默认的 Django 管理界面模板目录中的模板文件 admin/base_site.html 复制到该目录中。默认的 Django 管理界面模板目录位于 Django 源代码中（django/contrib/admin/templates）。

\n\n

接着，用你网页站点的名字编辑替换文件内的 {{ site_header|default:_('Django administration') }} （包含大括号）。完成后，你应该看到如下代码：

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

我们会用这个方法来教你复写模板。在一个实际工程中，你可能更期望使用 django.contrib.admin.AdminSite.site_header 来进行简单的定制。

\n

这个模板文件包含很多类似 {% block branding %} 和 {{ title }} 的文本。 {% 和 {{ 标签是 Django 模板语言的一部分。当 Django 渲染 admin/base_site.html 时，这个模板语言会被求值，生成最终的网页，就像我们在 教程第 3 部分 所学的一样。

\n

注意，所有的 Django 默认后台模板均可被复写。若要复写模板，像你修改 base_site.html 一样修改其它文件——先将其从默认目录中拷贝到你的自定义目录，再做修改。

\n
\n
\n

自定义你 应用的 模板Link to this heading#

\n

机智的同学可能会问： DIRS 默认是空的，Django 是怎么找到默认的后台模板的？因为 APP_DIRS 被置为 True，Django 会自动在每个应用包内递归查找 templates/ 子目录（不要忘了 django.contrib.admin 也是一个应用）。

\n

我们的投票应用不是非常复杂，所以无需自定义后台模板。不过，如果它变的更加复杂，需要修改 Django 的标准后台模板功能时，修改 应用 的模板会比 工程 的更加明智。这样，在其它工程包含这个投票应用时，可以确保它总是能找到需要的自定义模板文件。

\n

更多关于 Django 如何查找模板的文档，参见 加载模板文档。

\n
\n
\n
\n

自定义后台主页Link to this heading#

\n

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

\n

默认情况下，它展示了所有配置在 INSTALLED_APPS 中，已通过后台应用注册，按拼音排序的应用。你可能想对这个页面的布局做重大的修改。毕竟，索引页是后台的重要页面，它应该便于使用。

\n

需要自定义的模板是 admin/index.html。（像上一节修改 admin/base_site.html 那样修改此文件——从默认目录中拷贝此文件至自定义模板目录）。打开此文件，你将看到它使用了一个叫做 app_list 的模板变量。这个变量包含了每个安装的 Django 应用。你可以用任何你期望的硬编码链接（链接至特定对象的管理页）替代使用这个变量。

\n

当你熟悉了管理员界面后，阅读 本教程的第 8 部分，学习如何使用第三方包。

\n
","rootId":"writing-your-first-django-app-part-7","toc":[{"title":"自定义后台表单","anchor":"customize-the-admin-form","children":[]},{"title":"添加关联的对象","anchor":"adding-related-objects","children":[]},{"title":"自定义后台更改列表","anchor":"customize-the-admin-change-list","children":[]},{"title":"自定义后台界面和风格","anchor":"customize-the-admin-look-and-feel","children":[{"title":"自定义你的 工程的 模板","anchor":"customizing-your-project-s-templates","children":[]},{"title":"自定义你 应用的 模板","anchor":"customizing-your-application-s-templates","children":[]}]},{"title":"自定义后台主页","anchor":"customize-the-admin-index-page","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"开始","url":"/zh-hans/5.2/intro/"}],"prev":{"docname":"intro/tutorial06","title":"编写你的第一个 Django 应用，第 6 部分","url":"/zh-hans/5.2/intro/tutorial06/"},"next":{"docname":"intro/tutorial08","title":"编写你的第一个 Django 应用程序，第 8 部分","url":"/zh-hans/5.2/intro/tutorial08/"},"formats":{"html":"/zh-hans/5.2/intro/tutorial07/","markdown":"/zh-hans/5.2/intro/tutorial07.md","json":"/zh-hans/5.2/intro/tutorial07.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/intro/tutorial07.txt","official":"https://docs.djangoproject.com/zh-hans/5.2/intro/tutorial07/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}