Django后台管理界面

之前的几篇记录了模板视图、模型等页面展示的相关内容，这篇主要写一下后台admin管理界面的内容。

激活管理界面

Django管理站点完全是可选择的，之前我们是把这些功能给屏蔽掉了。记得上篇中Django模型模型安装小结中，我们把settings.py中的部分内容屏蔽了，并添加了一个app，如下

 INSTALLED_APPS = (
 ##    'django.contrib.admin',
 ##    'django.contrib.auth',
 ##    'django.contrib.contenttypes',
 ##    'django.contrib.sessions',
 ##    'django.contrib.messages',
 ##    'django.contrib.staticfiles',
     'mysite.books',
 )

 MIDDLEWARE_CLASSES = (
 ##    'django.contrib.sessions.middleware.SessionMiddleware',
 ##    'django.middleware.common.CommonMiddleware',
 ##    'django.middleware.csrf.CsrfViewMiddleware',
 ##    'django.contrib.auth.middleware.AuthenticationMiddleware',
 ##    'django.contrib.messages.middleware.MessageMiddleware',
 ##    'django.middleware.clickjacking.XFrameOptionsMiddleware',
 )

django.contrib.admin等这些就是支持后台admin管理界面的app，我们将上边这些注释全部去掉，即可增加对后台管理界面的支持。

运行 python manage.py syncdb 。这一步将生成管理界面使用的额外数据库表。 当你把'django.contrib.auth'加进INSTALLED_APPS后，第一次运行syncdb命令时, 系统会请你创建一个超级用户。 如果你不这么作，你需要运行python manage.py createsuperuser来另外创建一个admin的用户帐号，否则你将不能登入admin (提醒一句: 只有当INSTALLED_APPS包含'django.contrib.auth'时，python manage.py createsuperuser这个命令才可用.)

到这里，我们就把后台管理基本配置好了。但是想想，我们还差什么没做？

时刻记得，去urls.py进行配置哦，下图是新建的project初始时候的URLConf，在Django建立helloworld自定义页面里我们删除掉的内容

 from django.conf.urls import patterns, include, url

 from django.contrib import admin

 admin.autodiscover()

 urlpatterns = patterns('',
     # Examples:
     # url(r'^$', 'testsite.views.home', name='home'),
     # url(r'^blog/', include('blog.urls')),

     url(r'^admin/', include(admin.site.urls)),

 )

现在，我们要访问admin了，添加回来这几句吧

from django.contrib import admin
admin.autodiscover()

url(r'^admin/', include(admin.site.urls)),

好，我们运行起来看看吧。效果如下：

输入之前你添加的管理员账户和密码，登陆网站后台看看吧

如果你的母语不是英语，你可以做一个快速更改来观察Django管理工具是否被翻译成你想要的语言。 仅需添加 ‘django.middleware.locale.LocaleMiddleware’ 到 MIDDLEWARE_CLASSES 设置中，并确保它在’django.contrib.sessions.middleware.SessionMiddleware’后边（其实先后是没关系的）。如下我放在了第一个位置。

 MIDDLEWARE_CLASSES = (
     'django.middleware.locale.LocaleMiddleware',
     'django.contrib.sessions.middleware.SessionMiddleware',
     'django.middleware.common.CommonMiddleware',
     'django.middleware.csrf.CsrfViewMiddleware',
     'django.contrib.auth.middleware.AuthenticationMiddleware',
     'django.contrib.messages.middleware.MessageMiddleware',
     'django.middleware.clickjacking.XFrameOptionsMiddleware',
 )

刷新一个刚才的页面，看看效果。

具体的使用，无非就是增删改查了，自己去点吧。

将自定义的Models加入到Admin管理中

上一篇Django模型-数据库操作，我们定义了三个模块：Publisher 、 Author 和 Book 。 让我们将自己的模块加入管理工具中，这样我们就能够通过这个后台管理界面添加、修改和删除数据库中的对象了。

还记得新建的books app初始化的几个文件吗？

打开admin.py，添加内容如下

 from django.contrib import admin

 # Register your models here.
 from mysite.books.models import Publisher, Author, Book

 admin.site.register(Publisher)
 admin.site.register(Author)
 admin.site.register(Book)

这些代码通知管理工具为这些模块逐一提供界面。你可能需要先停止，然后再启动服务(runserver)，才能使其生效。

 点开新加的三个模块，点开Books，外键publisher用一个选择框显示，多对多字段author用一个多选框显示，日期字段也是datepicker样式的选择，有没有很强大。

Admin是如何工作的

当服务启动时，Django从urls.py引导URLconf，然后执行admin.autodiscover()语句。 这个函数遍历INSTALLED_APPS配置，并且寻找相关的 admin.py文件。 如果在指定的app目录下找到admin.py，它就执行其中的代码。

在books应用程序目录下的admin.py文件中，每次调用admin.site.register()都将那个模块注册到管理工具中。 管理工具只为那些明确注册了的模块显示一个编辑/修改的界面。

应用程序django.contrib.auth包含自身的admin.py，所以Users和Groups能在管理工具中自动显示。

字段设置

我们尝试添加一个作者信息，发现一些现象，每个字段都是必填项，Email也有专门的格式验证。如果我们不想要这些限制，该怎么做呢？

修改我们的models.py如下

 class Author(models.Model):
     first_name = models.CharField(max_length=30)
     last_name = models.CharField(max_length=40)
     email = models.EmailField(blank=True)

     def __unicode__(self):
         return u'%s %s' % (self.first_name,self.last_name)

标红部分是新添加的属性，这些代码告诉Django，作者的邮箱地址允许输入一个空值。

所有字段都默认blank=False，这使得它们不允许输入空值。

刷新页面，将会发现Email的标签不再是粗体，这意味它不是一个必填字段。

针对日期和数字的设置

Django生成CREATE TABLE语句自动为每个字段显式加上NOT NULL，在大多数情况下，这种默认的行为对你的应用程序来说是最佳的（消除NULL和空字符串的数据不一致）。

但是，其它数据类型有例外：日期型、时间型和数字型字段不接受空字符串。 如果你尝试将一个空字符串插入日期型或整数型字段，你可能会得到数据库返回的错误，这取决于那个数据库的类型。 （PostgreSQL比较严禁，会抛出一个异常；MySQL可能会也可能不会接受，这取决于你使用的版本和运气了。）在这种情况下，NULL是唯一指定空值的方法。 在Django模块中，你可以通过添加null=True来指定一个字段允许为NULL。

如果你想允许一个日期型（DateField、TimeField、DateTimeField）或数字型（IntegerField、DecimalField、FloatField）字段为空，你需要使用null=True  和 blank=True。

添加null=True比添加blank=True复杂。因为null=True改变了数据的语义，即改变了CREATE TABLE语句，把publication_date字段上的NOT NULL删除了。 要完成这些改动，我们还需要更新数据库。然而Django不会尝试自动更新数据库结构，所以你必须执行ALTER TABLE语句将模块的改动更新至数据库。

使用manage.py dbshell进入数据库服务环境，执行命令

ALTER TABLE books_book ALTER COLUMN publication_date DROP NOT NULL;

现在回到管理工具，添加book的编辑页面就允许输入一个空的publication date。

 日期和数字的设置这部分，由于我本地环境问题，manage.py dbshell总有问题，所以该部分内容，我没进行相应操作。

 我本地的搜索路径如下，是不是缺少Sqlite3的命令路径？有大牛知道的，请告知，谢谢！ 

自定义字段标签

在编辑页面中，每个字段的标签都是从模块的字段名称生成的。规则很简答：用空格替换下划线；首字母大写。比如上边新增作者的那个截图：first_name变成了First name。

有些情况下，我们想展示自定的标签名。为做到这个，我们只需要在models的模块定义中指定verbose_name即可。

比如我们要将Author.email的标签改成e-mail，中间有个横线，可以这样做

 class Author(models.Model):
     first_name = models.CharField(max_length=30)
     last_name = models.CharField(max_length=40)
     email = models.EmailField(blank=True,verbose_name='e-mail')

重新启动服务，刷新页面，效果如下

最后还需注意的是，为了使语法简洁，你可以把它当作固定位置的参数传递。 这个例子与上面那个的效果相同。

 class Author(models.Model):
     first_name = models.CharField(max_length=30)
     last_name = models.CharField(max_length=40)
     email = models.EmailField('e-mail',  blank=True)

但这不适用于ManyToManyField 和ForeignKey字段，因为它们第一个参数必须是模块类。 那种情形，必须显式使用verbose_name这个参数名称。

自定义ModelAdmin类

我们做的blank=True、null=True和verbose_name修改其实是模块级别，而不是管理级别的。 也就是说，这些修改实质上是构成模块的一部分，并且正好被管理工具使用，而不是专门针对管理工具的。除了这些，Django还提供了大量选项让你针对特别的模块自定义管理工具。 这些选项都在ModelAdmin classes里面，这些类包含了管理工具中针对特别模块的配置。

自定义列表

让我们更深一步：自定义Author模块的列表中的显示字段。 列表默认地显示查询结果中对象的__unicode__()。

 class Author(models.Model):
     first_name = models.CharField(max_length=30)
     last_name = models.CharField(max_length=40)
     email = models.EmailField(blank=True,verbose_name='e-mail')

     def __unicode__(self):
         return u'%s %s' % (self.first_name,self.last_name)

我们可以在这基础上改进，添加其它字段，从而改变列表的显示。 这个页面应该提供便利，比如说：在这个列表中可以看到作者的邮箱地址。如果能按照姓氏或名字来排序，那就更好了。

为了达到这个目的，我们将为Author模块定义一个ModelAdmin类。 这个类是自定义管理工具的关键，其中最基本的一件事情是允许你指定列表中的字段。 打开admin.py并修改：

 from django.contrib import admin
 from models import *

 # Register your models here.

 class AuthorAdmin(admin.ModelAdmin):
     list_display = ('first_name', 'last_name', 'email')

 admin.site.register(Publisher)
 admin.site.register(Author,AuthorAdmin)
 admin.site.register(Book)

我们新建了一个类AuthorAdmin，它是从django.contrib.admin.ModelAdmin派生出来的子类，保存着一个类的自定义配置，以供管理工具使用。 我们只自定义了一项：list_display， 它是一个字段名称的元组，用于列表显示。 当然，这些字段名称必须是模块中有的。

我们修改了admin.site.register()调用，在Author后面添加了AuthorAdmin。你可以这样理解： 用AuthorAdmin选项注册Author模块。

admin.site.register()函数接受一个ModelAdmin子类作为第二个参数。 如果你忽略第二个参数，Django将使用默认的选项。Publisher和Book的注册就属于这种情况。

 

刷新author列表页面，你会看到列表中有三列：姓氏、名字和邮箱地址。 另外，点击每个列的列头可以对那列进行排序。

 

让我们再添加一个快速查询栏。 向AuthorAdmin追加search_fields，如：

 class AuthorAdmin(admin.ModelAdmin):
     list_display = ('first_name', 'last_name', 'email')
     search_fields = ('first_name', 'last_name')

刷新页面，效果如下

 

接下来，为Book列表页添加一些过滤器，如下

 from django.contrib import admin
 from models import *

 # Register your models here.

 class AuthorAdmin(admin.ModelAdmin):
     list_display = ('first_name', 'last_name', 'email')
     search_fields = ('first_name', 'last_name')

 class BookAdmin(admin.ModelAdmin):
     list_display=('title','publisher','publication_date')
     list_filter=('publication_date',)

 admin.site.register(Publisher)
 admin.site.register(Author,AuthorAdmin)
 admin.site.register(Book,BookAdmin)

刷新效果如下：

用list_filter这个字段元组创建过滤器，它位于列表页面的右边。 Django为日期型字段提供了快捷过滤方式，它包含：今天、过往七天、当月和今年。

另外一种过滤日期的方式是使用date_hierarchy选项，如：

 class BookAdmin(admin.ModelAdmin):
     list_display=('title','publisher','publication_date')
     list_filter=('publication_date',)
     date_hierarchy = 'publication_date'

修改好后，页面中的列表顶端会有一个逐层深入的导航条，效果如图 6-11. 它从可用的年份开始，然后逐层细分到月乃至日。

查看结果如下

请注意，date_hierarchy接受的是* 字符串* ，而不是元组。因为只能对一个日期型字段进行层次划分。

 

最后，让我们改变默认的排序方式，按publication date降序排列。 列表页面默认按照模块class Meta中的ordering所指的列排序。详细请看Django模型-数据库操作。该实例中没有指定ordering，所以排序是没定义的。

 class BookAdmin(admin.ModelAdmin):
     list_display=('title','publisher','publication_date')
     list_filter=('publication_date',)
     date_hierarchy = 'publication_date'
     ordering = ('-publication_date',)

这个ordering选项基本像模块中class Meta的ordering那样工作。效果是Publication date列头现在有一个小箭头显示排序。

自定义编辑表单

首先，我们先自定义字段顺序。 默认地，表单中的字段顺序是与模块中定义是一致的。 我们可以通过使用ModelAdmin子类中的fields选项来改变它：

 class BookAdmin(admin.ModelAdmin):
     list_display=('title','publisher','publication_date')
     list_filter=('publication_date',)
     date_hierarchy = 'publication_date'
     ordering = ('-publication_date',)
     fields = ('authors', 'title', 'publisher')

顺序是我们自定义的，可编辑的字段也是我们可选择的。效果如下：

此时新增记录，Django会简单地将publication_date设置为None，以确保这个字段满足null=True的条件。

因为之前我说的，本地的Python manage.py dbshell 失败，导致我无法修改数据库结构，

publication_date = models.DateField(blank=True,null=True)

这段代码是失效的，所以我在这里提交代码会出错，如下：

如果你本地的命令没问题，并且根据之前的说明修改了对应数据库字段可空（NULL和空字符串），则不会出错。

另一个常用的编辑页面自定义是针对多对多字段的。 真如我们在book编辑页面看到的那样， '多对多字段' 被展现成多选框。虽然多选框在逻辑上是最适合的HTML控件，但它却不那么好用。 如果你想选择多项，你必须还要按下Ctrl键。 虽然管理工具添加了注释（help_text），但是当它有几百个选项时，它依然显得笨拙。

更好的办法是使用filter_horizontal。让我们把它添加到BookAdmin中，然后看看它的效果。

 class BookAdmin(admin.ModelAdmin):
     list_display=('title','publisher','publication_date')
     list_filter=('publication_date',)
     date_hierarchy = 'publication_date'
     ordering = ('-publication_date',)
     #fields = ('authors', 'title', 'publisher')
     filter_horizontal = ('authors',)

效果如下

ModelAdmin类还支持filter_vertical选项。 它像filter_horizontal那样工作，除了控件都是垂直排列，而不是水平排列的。

filter_horizontal和filter_vertical选项只能用在多对多字段 上, 而不能用于 ForeignKey字段。 默认地，管理工具使用'下拉框' 来展现 外键 字段。下拉框选择就会将所有值加载到下拉列表，选中某个或许需要拖滚动条好久才能找到。

Django提供了raw_id_fields 选项，它是一个包含外键字段名称的元组，它包含的字段将被展现成’ 文本框‘和检索按钮的形式。

 class BookAdmin(admin.ModelAdmin):
     list_display=('title','publisher','publication_date')
     list_filter=('publication_date',)
     date_hierarchy = 'publication_date'
     ordering = ('-publication_date',)
     #fields = ('authors', 'title', 'publisher')
     filter_vertical = ('authors',)
     raw_id_fields = ('publisher',)

这个文框内可输入的值是publisher的id，通过检索弹框选择即可。

小结

这篇篇幅较长，内容不少。还有一部分关于权限的东西，这里不多说了，后台里多点点就能理解。