啦啦啦啦~Django1.96---编写第一个Django应用(1)
2016-05-17 00:35
603 查看
自定义管理表单
只需使用admin.site.register(Question)注册Question模型,Django就能构造一个默认的表单表示。
通常,你会想要自定义管理界面中表单的外观和功能。 你可以通过在注册对象的时候告知Django一些你想要的选项来完成。
让我们通过对编辑表单上的字段重新排序来看一下它是如何工作的。
将admin.site.register(Question)行替换成:
polls/admin.py
无论何时,当你需要为一个对象修改管理选项的话
就按照这样的步骤来做:创建一个模型管理对象,然后把该对象作为第二个参数传入admin.site.register()。
上面那特定的更改,使得“Publication date”字段排在“Question”字段前面
当管理有许多字段的表单时,选择一个直观的排序方式是一个重要而实用的细节。
说到有许多字段的表单,你可能想把表单分割成字段集:
polls/admin.py
fieldsets中每个元组的第一个元素是字段集的标题。
一个Question有多个Choices,管理界面中并没有将选项显示出来。
有两种方法来解决这个问题。
第一种是像我们为Question做的一样,在管理站点中注册Choice。这简单:
polls/admin.py
现在,可以在Django管理站点中管理“Choices”。 “Add choice”表单看起来像这样:
在这个表单中,“Question”字段是一个可选的选项框,包含数据库中所有的Question。
Django知道ForeignKey应该在管理界面中显示为一个<select>选框。
另外,注意一下“Question”旁边的“Add Another”链接。 每个与其它对象拥有ForeignKey关系的对象都有一个这种链接。
当你点击“Add Another”,你将看到一个带有“Add question”表单的弹出窗口。
如果你在这个窗口中添加了一个Question并点击“Save”,Django会将保存这个Question到数据库中,
然后动态地将这个对象添加为你正在查看的“Add choice”表单的选择项。
但事实上,这是一种不高效的方式来添加Choice对象到系统中。
第二种:在创建Question对象的同时可以直接添加一组Choice将会更好。让我们实现这个功能。
移除对Choice模型的register()调用。然后将Question的注册代码编辑为:
polls/admin.py
有三个所关联的Choice —— 由extra指定
——
每次你回到已经存在对象的"Change"页面时,都会额外地获得三个空白Choice。
在现有的三个Choice的底部,你会发现一个“Add another Choice”的链接。 如果你点击它,就会增加一个新的空白Choice。
如果你想移除一个新增加的空白Choice,可以点击其右上角的X。
改变一下ChoiceInline 的声明:使用 TabularInline(不是StackedInline),这些相关联的对象显示成紧凑的、基于表格的形式
Django的管理站点是用Django自己制作出来的,它的界面代码使用的是Django自己的模板系统。
在你项目的文件夹内(包含 manage.py的目录)创建一个templates目录。
模板可以放在你的文件系统中Django所能访问到的任何地方。 (运行Web服务器的用户即是运行Django的用户)。
然而,把模板放在项目目录下会是一个值得提倡的、应该遵循的约定。
打开你的配置文件(记住是mysite/settings.py)
在TEMPLATES 设置中添加一个DIRS 选项:
mysite/settings.py
DIRS 是加载Django模板时检查的一个文件系统目录列表;它是一个搜索路径。
现在,在templates下创建一个名为admin的目录
然后从Django源码中管理站点的模板目录(django/contrib/admin/templates)将admin/base_site.html拷贝到这个目录中。
Django源文件在系统上的位置,运行如下命令:
然后,只需编辑该文件并替换{{ site_header|default:_('Django administration') }} (包括花括号)为你认为合适的自己站点的名称。
编辑完成后应该类似下面的代码片段:
在实际项目中,你可能会使用 django.contrib.admin.AdminSite.site_header属性来更简单地实现这个自定义功能。
模板文件包含许多类似{% block branding %} 和{{ title }}这样的文本。 {% 和{{ 是Django模板语言的一部分。当Django渲染admin/base_site.html,这些模板语言将被求值以生成最终的HTML文件。
注意任何Django管理站点的默认模板都可以被覆盖。
想要覆盖一个模板文件,只需要做和覆盖base_site.html相同的操作就行
—— 将它从默认的目录拷贝到你自定义的目录中,然后修改它。
细心的读者将会问:由于DIRS默认是空的,Django是怎么找到默认的管理站点模板的?
答案是,由于APP_DIRS设置为True,Django会自动地在每个应用包下面查找一个templates/子目录,留作备用。
(别忘了,django.contrib.admin 也是一个应用)。
使用这种方式,你可以在任何新项目中使用投票应用,并且可以确保Django将找到它需要的自定义模板文件。
与上面类似的是,你可能想自定义Django管理站点首页面的外观。
默认情况下,首页面显示所有位于INSTALLED_APPS中且已经使用管理站点应用注册过的应用,这些应用按照字母顺序进行显示。你可能想在布局上做出重大改变。 毕竟,首页面可能是管理站点中最重要的页面,并且它用起来应该很简单。
需要自定义的模板文件是 admin/index.html。
(就像之前对admin/base_site.html做的那样
—— 将它从默认的目录拷贝到你自定义的目录中)。
编辑这个文件,你将看到它有一个叫做app_list的变量。
这个变量包含安装的所有Django应用。
你可以选择不像默认模板中那样使用它,而是以你认为最好的方式硬编码链接到每个对象自己的管理页面。
只需使用admin.site.register(Question)注册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()。
上面那特定的更改,使得“Publication date”字段排在“Question”字段前面
当管理有许多字段的表单时,选择一个直观的排序方式是一个重要而实用的细节。
说到有许多字段的表单,你可能想把表单分割成字段集:
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中每个元组的第一个元素是字段集的标题。
添加关联对象
一个Question有多个Choices,管理界面中并没有将选项显示出来。有两种方法来解决这个问题。
第一种是像我们为Question做的一样,在管理站点中注册Choice。这简单:
polls/admin.py
from django.contrib import admin from .models import Choice, Question # ... admin.site.register(Choice)
现在,可以在Django管理站点中管理“Choices”。 “Add choice”表单看起来像这样:
在这个表单中,“Question”字段是一个可选的选项框,包含数据库中所有的Question。
Django知道ForeignKey应该在管理界面中显示为一个<select>选框。
另外,注意一下“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 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)
有三个所关联的Choice —— 由extra指定
——
每次你回到已经存在对象的"Change"页面时,都会额外地获得三个空白Choice。
在现有的三个Choice的底部,你会发现一个“Add another Choice”的链接。 如果你点击它,就会增加一个新的空白Choice。
如果你想移除一个新增加的空白Choice,可以点击其右上角的X。
改变一下ChoiceInline 的声明:使用 TabularInline(不是StackedInline),这些相关联的对象显示成紧凑的、基于表格的形式
自定义管理站点的外观
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源文件在系统上的位置,运行如下命令:
$ python -c " import sys sys.path = sys.path[1:] import django print(django.__path__)"
然后,只需编辑该文件并替换{{ site_header|default:_('Django administration') }} (包括花括号)为你认为合适的自己站点的名称。
编辑完成后应该类似下面的代码片段:
{% 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文件。
注意任何Django管理站点的默认模板都可以被覆盖。
想要覆盖一个模板文件,只需要做和覆盖base_site.html相同的操作就行
—— 将它从默认的目录拷贝到你自定义的目录中,然后修改它。
自定义应用的模板
细心的读者将会问:由于DIRS默认是空的,Django是怎么找到默认的管理站点模板的?答案是,由于APP_DIRS设置为True,Django会自动地在每个应用包下面查找一个templates/子目录,留作备用。
(别忘了,django.contrib.admin 也是一个应用)。
使用这种方式,你可以在任何新项目中使用投票应用,并且可以确保Django将找到它需要的自定义模板文件。
自定义管理站点的首页面
与上面类似的是,你可能想自定义Django管理站点首页面的外观。默认情况下,首页面显示所有位于INSTALLED_APPS中且已经使用管理站点应用注册过的应用,这些应用按照字母顺序进行显示。你可能想在布局上做出重大改变。 毕竟,首页面可能是管理站点中最重要的页面,并且它用起来应该很简单。
需要自定义的模板文件是 admin/index.html。
(就像之前对admin/base_site.html做的那样
—— 将它从默认的目录拷贝到你自定义的目录中)。
编辑这个文件,你将看到它有一个叫做app_list的变量。
这个变量包含安装的所有Django应用。
你可以选择不像默认模板中那样使用它,而是以你认为最好的方式硬编码链接到每个对象自己的管理页面。
相关文章推荐
- go template 循环中使用 外部变量
- 《算法》第四版《Algorithms》4th Edition 学习环境搭建
- 啦啦啦啦~Django1.96---字段查询
- ROS(indigo)_pr2_simulator仿真(gazebo)示例
- ROS(indigo)_pr2_simulator仿真(gazebo)示例
- ROS(indigo)_pr2_simulator仿真(gazebo)示例
- goahead 的跳转问题
- genymotion登陆出现unknown genymotion error;启动出现got no ip address, unable to load virtual engin错误的解决办法
- Django的Model上都有些什么
- Google学术上不去,几个替代网址
- Mongoose
- Google Chrome以root身份启动
- Google Guava官方教程(中文版)
- {题解}[jzoj4489] GDOI2016 Day2_T1 SigemaGo
- Step one:how to search on google efficiently?
- 视频去除水印、台标和logo,并重新在生成新的视频
- Django 外键、多对多插入数据方法
- GoogLeNet
- 百度一下Google,您试过吗?
- 百度一下Google,您试过吗?