后台管理
#管理后台 #创建管理员用户 $python manage.py createsuperuser Username: admin Email address: [email protected] #你将被要求输入你的密码两次,第二次输入是确认密码 Password: ********** Password (again): ********* Superuser created successfully. #启动服务器,现在,打开一个浏览器访问你域名中的 “/admin/” —— 例如 你应该会看到管理站点的登录界面,登录后你将看到几类可编辑的内容:groups和users。 它们是由django.contrib.auth提供的,这个认证框架集成在Django中。
让应用在管理站点中可编辑
但我们的app_poll应用在哪儿? 它没有显示在管理站点的首页面上。
只需要做一件事:我们需要告诉管理站点Question 对象要有一个管理界面。要做这件事,需要打开polls/admin.py文件,把它编辑成这样:
polls/admin.py
from django.contrib import admin from .models import Questions admin.site.register(Questions)
然后后台就出现该应用的管理界面了,可以点开进行编辑管理.
自定义管理表单
你没有写多少代码,却得到了这一切。 只需使用admin.site.register(Question)注册Question模型,Django就能构造一个默认的表单表示。通常,你会想要自定义管理界面中表单的外观和功能。你可以通过在注册对象的时候告知Django一些你想要的选项来完成。
让我们通过对编辑表单上的字段重新排序来看一下它是如何工作的。将admin.site.register(Question)行替换成:
polls/admin.py
from django.contrib import adminfrom .models import Questionclass QuestionAdmin(admin.ModelAdmin): fields = ['pub_date', 'question_text']admin.site.register(Question, QuestionAdmin)
无论何时,当你需要为一个对象修改管理选项的话,就按照这样的步骤来做:创建一个模型管理对象,然后把该对象作为第二个参数传入admin.site.register()。
上面那特定的更改,使得“Publication date”字段排在“Question”字段前面:
仅有两个字段不会令你印象深刻,但是当管理有许多字段的表单时,选择一个直观的排序方式是一个重要而实用的细节。
说到有许多字段的表单,你可能想把表单分割成字段集:
polls/admin.py
from django.contrib import adminfrom .models import Questionclass QuestionAdmin(admin.ModelAdmin): fieldsets = [ (None, {'fields': ['question_text']}), ('Date information', {'fields': ['pub_date']}), ]admin.site.register(Question, QuestionAdmin)
fieldsets中每个元组的第一个元素是字段集的标题。以下是我们的对象表单现在的样子:
你可以任意地为每个字段集指定HTML样式类。
polls/admin.py
from django.contrib import adminfrom .models import Questionclass QuestionAdmin(admin.ModelAdmin): fieldsets = [ (None, {'fields': ['question_text']}), ('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}), ]admin.site.register(Question, QuestionAdmin)
添加关联对象
好了,我们已经有自己的Question管理界面。 但是一个Question有多个Choices,管理界面中并没有将选项显示出来。
的确没有,但只是暂时没有。
有两种方法来解决这个问题。 第一种是像我们为Question做的一样,在管理站点中注册Choice。这简单:
polls/admin.py
from django.contrib import adminfrom .models import Choice, Question# ...admin.site.register(Choice)
现在,可以在Django管理站点中管理“Choices”。 “Add choice”表单看起来像这样:
在这个表单中,“Question”字段是一个可选的选项框,包含数据库中所有的Question。 Django知道ForeignKey应该在管理界面中显示为一个选框。在我们的例子中,目前选框里只有一个Question。
另外,注意一下“Question”旁边的“Add Another”链接。 每个与其它对象拥有ForeignKey关系的对象都有一个这种链接。当你点击“Add Another”,你将看到一个带有“Add question”表单的弹出窗口。如果你在这个窗口中添加了一个Question并点击“Save”,Django会将保存这个Question到数据库中,然后动态地将这个对象添加为你正在查看的“Add choice”表单的选择项。
但事实上,这不是一种高效的方式来添加Choice对象到系统中。在创建Question对象的同时可以直接添加一组Choice将会更好。让我们实现这个功能。
移除对Choice模型的register()调用。然后将Question的注册代码编辑为:
polls/admin.py
from django.contrib import adminfrom .models import Choice, Questionclass ChoiceInline(admin.StackedInline): model = Choice extra = 3class 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个Choice的空间。
打开“Add question”页面:
它这样工作:有三个所关联的Choice —— 由extra指定 —— 每次你回到已经存在对象的"Change"页面时,都会额外地获得三个空白Choice。
在现有的三个Choice的底部,你会发现一个“Add another Choice”的链接。 如果你点击它,就会增加一个新的空白Choice。 如果你想移除一个新增加的空白Choice,可以点击其右上角的X。 请注意,你无法移除那最初的三个空白Choice。 下面的图片展示新增加的一个空白Choice:
还有个小问题。 显示所有关联的Choice 对象的字段占用大量的屏幕空间。 为了解决这个问题,Django提供了一种以表格的形式显示内嵌的相关联对象的方法; 你只需改变一下ChoiceInline 的声明:
polls/admin.py
class ChoiceInline(admin.TabularInline): #...
使用 TabularInline(不是StackedInline),这些相关联的对象显示成紧凑的、基于表格的形式:
你有没有注意有一个额外的列“Delete?”,用“Add Another Choice”按钮添加的行和已经保存的行可以通过它来删除
自定义管理界面中的变更列表
现在,Question管理界面看起来已经很好了,让我们再来稍微调整一下“变更列表”界面 —— 该界面显示系统中所有的Question。
下面是目前为止它的样子:
默认地,Django显示每个对象的str()返回的内容。但有时如果我们能显示个别的字段将很有帮助。 我们使用list_display 选项来实现这个功能,它是一个要显示的字段名称的元组,在对象的变更列表页面上作为列显示:
polls/admin.py
class QuestionAdmin(admin.ModelAdmin): # ... list_display = ('question_text', 'pub_date')
为了更好地评估对象,让我们将教程1中自定义的方法was_published_recently 添加进来:
polls/admin.py
class QuestionAdmin(admin.ModelAdmin): # ... list_display = ('question_text', 'pub_date', 'was_published_recently')
现在,Question变更列表页面看起来就像如下所示:
你可以点击其中一列的头部来让列表按照这列的值来进行排序 —— 除了was_published_recently这列的头部,因为Django不支持按照随便一个方法的输出进行排序。另外注意, was_published_recently这列的头部默认是这个方法的名字(用空格取代下划线),并且这列的每一项内容都是用返回值的字符串形式表示。
你可以通过给这个方法(在polls/models.py中)添加一些属性来改进这些:
polls/models.py
class Question(models.Model): # ... def was_published_recently(self): return self.pub_date >= timezone.now() - datetime.timedelta(days=1) 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']
这行代码添加一个“Filter”侧边栏,可以使人们通过pub_date字段对变更列表进行过滤:
显示的过滤器类型取决于你所使用的字段类型。 由于pub_date为DateTimeField类型,所以Django将根据该类型给出相应的选项:“Any date”、“Today”、“Past 7 days”、“This month”、“This year”。
这样看起来有些像我们想要的样子了。让我们再来添加一些搜索功能:
search_fields = ['question_text']
这行代码在变更列表的顶部添加了一个搜索框。 当有人将搜索的内容输入搜索框,Django将在question_text字段中进行搜索。 你可以使用任意数量的字段进行搜索 —— 但由于它在后台使用LIKE进行查询,所以限制搜索字段的数量会使数据库查询更加容易。
现在又是一个好时机来告诉你变更列表界面提供方便的分页功能。 默认每页显示100条记录。 Change list pagination、searchboxes、filters、date-hierarchies和column-header-ordering 都将按照你设想的那样工作。
自定义管理站点的外观
很明显,每个管理页面的顶部都有“Django administration”还蛮搞笑的。它仅仅起到了占位符的作用。
它可以用Django的模板系统轻松改变。 Django的管理站点是用Django自己制作出来的,它的界面代码使用的是Django自己的模板系统。
自定义项目的模板
在你项目的文件夹内(包含 manage.py的目录)创建一个templates目录。模板可以放在你的文件系统中Django所能访问到的任何地方。 (运行Web服务器的用户即是运行Django的用户)。然而,把模板放在项目目录下会是一个值得提倡的、应该遵循的约定。
打开你的配置文件(记住是mysite/settings.py)在TEMPLATES 设置中添加一个DIRS 选项:
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', ], }, },]
DIRS 是加载Django模板时检查的一个文件系统目录列表;它是一个搜索路径。
现在,在templates下创建一个名为admin的文件夹,然后从Django安装的原目录下(目录为django/contrib/admin/templates)将模板页面的源文件admin/base_site.html拷贝到这个文件夹里。
Django的源文件在哪里?
如果你找不到Django源文件在你系统上的位置,运行如下命令:
$ python -c "import syssys.path = sys.path[1:]import djangoprint(django.__path__)"
然后,只需编辑该文件并替换{{ site_header|default:_('Djangoadministration') }} (包括花括号)为你认为合适的自己站点的名称。编辑完成后应该类似下面的代码片段:
{% block branding %}Polls Administration
{% endblock %}
我们使用这个例子来教你如何覆盖模板。 在实际项目中,你可能会使用django.contrib.admin.AdminSite.site_header属性来更简单地实现这个自定义功能。
模板文件包含许多类似{% block branding %} 和{{ title }}这样的文本。 {% 和{{ 是Django模板语言的一部分。当Django渲染admin/base_site.html,这些模板语言将被求值以生成最终的HTML文件。如果你被模板给弄愣了不用担心 —— 我们将在教程3深入讲解Django的模板语言。
注意任何Django管理站点的默认模板都可以被覆盖。 想要覆盖一个模板文件,只需要做和覆盖base_site.html相同的操作就行 —— 将它从默认的目录拷贝到你自定义的目录中,然后修改它。
自定义应用的模板
细心的读者将会问:由于DIRS默认是空的,Django是怎么找到默认的管理站点模板的?答案是,由于APP_DIRS设置为True,Django会自动地在每个应用包下面查找一个templates/子目录,留作备用。(别忘了,django.contrib.admin 也是一个应用)。
我们的投票应用并不是太复杂,不需要自定义管理站点模板。 但是如果它变得更加复杂而且为了一些功能需要修改Django的标准管理站点模板,那么与修改项目中的模板相比,修改应用中的模板将是更明智的选择。使用这种方式,你可以在任何新项目中使用投票应用,并且可以确保Django将找到它需要的自定义模板文件。
更多关于Django如何找到它的模板文件的信息,请查看 模板加载的文档。
自定义管理站点的首页面
与上面类似的是,你可能想自定义Django管理站点首页面的外观。
默认情况下,首页面显示所有位于INSTALLED_APPS中且已经使用管理站点应用注册过的应用,这些应用按照字母顺序进行显示。你可能想在布局上做出重大改变。 毕竟,首页面可能是管理站点中最重要的页面,并且它用起来应该很简单。
需要自定义的模板文件是 admin/index.html。 (就像之前对admin/base_site.html做的那样 —— 将它从默认的目录拷贝到你自定义的目录中)。编辑这个文件,你将看到它有一个叫做app_list的变量。这个变量包含安装的所有Django应用。 你可以选择不像默认模板中那样使用它,而是以你认为最好的方式硬编码链接到每个对象自己的管理页面。 再次强调一点,你不理解模板语言也没关系 —— 我们将在教程3中对它进行详细介绍。
当你对管理站点感到满意后,请阅读教程的第3部分开始制作投票应用的对外站点。