Django自动管理工具是django.contrib的一部分。django.contrib是一套庞大的功能集，它是Django基本代码的组成部分，Django框架就是由众多包含附加组件(add-on)的基本代码构成的。管理工具是讲述django.contrib的第一个部分。从技术层面上讲，它被称作django.contrib.admin。django.contrib中其它可用的特性，如用户鉴别系统(django.contrib.auth)、支持匿名会话(django.contrib.sessioins)以及用户评注系统(django.contrib.comments)。第十六章详细讨论。Django自带很多优秀的附加组件，它们都存在于django.contrib包里。

Admin是如何工作的

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

在`` books`` 应用程序目录下的`` admin.py`` 文件中，每次调用`` admin.site.register()`` 都将那个模块注册到管理工具中。 管理工具只为那些明确注册了的模块显示一个编辑/修改的界面。应用程序`` django.contrib.auth`` 包含自身的`` admin.py`` ，所以Users和Groups能在管理工具中自动显示。 其它的django.contrib应用程序，从网上下的第三方Django应用程序一样，都会自行添加到管理工具。综上所述，管理工具其实就是一个Django应用程序，包含自己的模块、模板、视图和URLpatterns。 你要像添加自己的视图一样，把它添加到URLconf里面。 你可以在Django基本代码中的django/contrib/admin 目录下，检查它的模板、视图和URLpatterns，但你不要尝试直接修改其中的任何代码，因为里面有很多地方可以让你自定义管理工具的工作方式。

激活管理界面

Django管理站点完全是可选择的，因为仅仅某些特殊类型的站点才需要这些功能。

修改settings文件

1. 将'django.contrib.admin'加入setting的INSTALLED_APPS配置中 （INSTALLED_APPS中的配置顺序是没有关系的）
2. 保证INSTALLED_APPS中包含'django.contrib.auth'，'django.contrib.contenttypes'和'django.contrib.sessions'，Django的管理工具需要这3个包。确保MIDDLEWARE_CLASSES 包含'django.middleware.common.CommonMiddleware' 、'django.contrib.sessions.middleware.SessionMiddleware' 和'django.contrib.auth.middleware.AuthenticationMiddleware' 。

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

Note:只有当INSTALLED_APPS包含'django.contrib.auth'时，pythonmanage.py createsuperuser这个命令才可用。

4. 将admin访问配置在URLconf(urls.py). 默认情况下，命令django-admin.pystartproject生成的文件urls.py是将Django admin的路径注释掉的， 取消注释。

# Include these import statements...
from django.contrib import admin
admin.autodiscover()# And include this URLpattern...
urlpatterns = patterns('',# ...(r'^admin/', include(admin.site.urls)),# ...
)

使用管理工具

运行Django管理工具

启动开发服务器(python manage.py runserver)，然后在浏览器中访问：http://127.0.0.1:8000/admin/

管理界面的设计是针对非技术人员的，所以它应该是自我解释的。
登录管理界面

使用你原来设置的超级用户的用户名和密码。

Note:

1. 如果无法登录，请运行`` python manage.py createsuperuser`` ，确保你已经创建了一个超级用户。

2. 如果看到如下所示的错误页面报告：ImportError at /admin/cannot import name patterns...很可能使用的 Django 版本不符合,可以切换到对应的旧版本教程去或者更新到较新的 Django 版本。

管理页面

Note:
1. 这个页面列出了管理工具中可编辑的所有数据类型。 它仅有两个默认的管理-编辑模块：用户组(Groups)和用户(Users)。
2. 界面上并没有显示之前创建的数据表，因为我们的这个表没有在admin.py中注册，也就是admin后台并不知道。后面会讲怎么添加/注册 -- 将Models加入到Admin管理。

3. 在Django管理页面中，每一种数据类型都有一个* change list* 和* editform* 。前者显示数据库中所有的可用对象；后者可让你添加、更改和删除数据库中的某条记录。

配置Django管理工具语言

如果你的母语不是英语，而你不想用它来配置你的浏览器，你可以做一个快速更改来观察Django管理工具是否被翻译成你想要的语言。

仅需添加`` ‘django.middleware.locale.LocaleMiddleware’`` 到`` MIDDLEWARE_CLASSES`` 设置中，并确保它在’django.contrib.sessions.middleware.SessionMiddleware’* 之后* 。

完成后，请刷新页面。 如果你设置的语言可用，一系列的链接文字将被显示成这种语言。这些文字包括页面顶端的Changepassword和Log out，页面中部的Groups和Users。 Django自带了多种语言的翻译。[Django更多的国际化特性]
更改列表
点击Uers行中的Change链接。这个页面显示了数据库中所有的用户。可以将它看作是一个漂亮的网页版查询：`` SELECT * FROM auth_user;`` ，你会发现页面中还有过滤器、排序和查询框。 过滤器在右边；排序功能可通过点击列头查看；查询框在页面顶部，它允许你通过用户名查询。
点击其中一个用户名，你会看见关于这个用户的编辑窗口。


Note:
1. 这个页面允许你修改用户的属性，如姓名和权限。 （如果要更改用户密码，你必须点击密码字段下的change the password using this form）

2. 不同类型的字段会用不同的窗口控件显示。例如，日期/时间型用日历控件，布尔型用复选框，字符型用简单文本框显示。

3. 你可以通过点击编辑页面下方的删除按钮来删除一条记录。 你会见到一个确认页面。有时候，它会显示有哪些关联的对象将会一并被删除。 （例如，如果你要删除一个出版社，它下面所有的图书也将被删除。）

4. 你可以通过点击管理主页面中某个对象的Add来添加一条新记录。 一个空白记录的页面将被打开，等待你填充。

5. 你还能看到管理界面也控制着你输入的有效性。 你可以试试不填必需的栏目或者在时间栏里填错误的时间，你会发现当你要保存时会出现错误信息。

6. 当你编辑已有的对像时，你在窗口的右上角可以看到一个历史按钮。 通过管理界面做的每一个改变都留有记录，你可以按历史键来检查这个记录。
将Models加入到Admin管理

将自己的模块加入管理工具中，这样我们就能够通过这个漂亮的界面添加、修改和删除数据库中的对象了。之前我们定义了三个模块：Publisher 、Author 和Book 。

在mysite/books/创建admin.py，输入以下代码，通知管理工具为这些模块逐一提供界面。

from django.contrib import admin
from VoteSite.books.models import Publisher, Author, Book# Register your models here.
admin.site.register(Publisher)
admin.site.register(Author)
admin.site.register(Book)

完成后，打开页面`` http://127.0.0.1:8000/admin/`` ，你会看到一个Books区域，其中包含Authors、Books和Publishers。  （你可能需要重启runserver）
Note:这里有个神奇的bug:修改后Django服务器会报错，但python文件中不报错，把fromVoteSite.books.modelsimportPublisher, Author, Book修改为frombooks.modelsimportPublisher, Author, Book后Django服务器不报错，但python文件中会显示错误，只是这个错误没影响- -，runserver成功！
修正方法：pycharm > settings > languages & framworks > Django > pythonworkspace > Enable Django Support: Django project root:E:\mine\python_workspace\VoteSite settings: VoteSite\settings.py > OK。这样做是为了告诉python这是一个Django项目。(跳跳乱说，不能解决)

管理工具处理外键和多对多关系的方法

`` Book`` 模块的例子：

class Book(models.Model):title = models.CharField(max_length=100)authors = models.ManyToManyField(Author)publisher = models.ForeignKey(Publisher)publication_date = models.DateField()

在Add book页面中（`` http://127.0.0.1:8000/admin/books/book/add/`` ），`` 外键`` publisher用一个选择框显示，`` 多对多`` 字段author用一个多选框显示。 点击两个字段后面的绿色加号，可以让你添加相关的记录。

举个例子，如果你点击Publisher后面的加号，你将会得到一个弹出窗口来添加一个publisher。 当你在那个窗口中成功创建了一个publisher后，Add book表单会自动把它更新到字段上去.

http://blog.csdn.net/pipisorry/article/details/45079751

自定义管理工具-自定义模块

Note:记住这三步来实现模型的变更(否则在日期型和数字型字段设置时保存信息到数据库会成功，但会显示错误)[Django项目实践3 - Django模型]

• 修改你的模型（在models.py中）。
• 运行python manage.py makemigrations命令为这些改动创建迁移文件。
• 运行python manage.py migrate命令将这些改动应用到数据库中。

设置字段可选

管理工具有个限制：编辑表单需要你填写每一个字段，然而在有些情况下，你想要某些字段是可选的，即允许不填，允许输入空值。

为了指定email字段为可选，你只要编辑Book模块，在email字段上加上blank=True。代码如下：

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

这些代码告诉Django，作者的邮箱地址允许输入一个空值。 所有字段都默认blank=False，这使得它们不。

当你添加blank=True以后，刷新页面Add author edit form(http://127.0.0.1:8000/admin/books/author/add/ )，将会发现Email的标签不再是粗体了。

Note:blank=True就是说默认值是‘’，而不是NULL，因为从下面可知，Django生成CREATETABLE语句自动为每个字段显式加上NOT NULL。

设置日期型和数字型字段可选(还有ImageField等)

CREATE TABLE "books_author" ("id" serial NOT NULL PRIMARY KEY,"first_name" varchar(30) NOT NULL,"last_name" varchar(40) NOT NULL,"email" varchar(75) NOT NULL
);

class Book(models.Model):
    '''
    书籍有书名和出版日期
    '''
    title = models.CharField(max_length=100)authors = models.ManyToManyField(Author)publisher = models.ForeignKey(Publisher)
    publication_date = models.DateField(blank=True, null=True)def __str__(self):
        return self.title

ALTER TABLE books_book ALTER COLUMN publication_date DROP NOT NULL;

在编辑页面中，每个字段的标签都是从模块的字段名称生成的。 规则很简单： 用空格替换下划线；首字母大写。例如：Book模块中publication_date的标签是Publication date。

自定义一个标签。 你只需在模块中指定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')

修改后重启服务器，你会在author编辑页面中看到这个新标签。

Note:不必把verbose_name的首字母大写，Django会自动适时将首字母大写，并且在其它不需要大写的地方使用verbose_name的精确值。

django后台设置可动态增删的add字段

{实现如工作经历随时增删}

class WorkExp(models.Model):
    work_experience = models.TextField(verbose_name='工作经历')

class People(models.Model):
    name = models.CharField(max_length=150, verbose_name='姓名')#...

    work_experiences = models.ManyToManyField(WorkExp, blank=True, null=True, verbose_name='工作经历')

这样就可以在后台随时点击add，在弹出框中增加工作经历

Note:在表WorkExp未建立前，后面的+符号是没有的，所以要确保表WorkExp已建立。

自定义ModelAdmin类-自定义管理工具

我们做的blank=True、null=True和verbose_name修改其实是模块级别，而不是管理级别的。 也就是说，这些修改实质上是构成模块的一部分，并且正好被管理工具使用，而不是专门针对管理工具的。

自定义管理工具选项都在ModelAdmin classes里面，这些类包含了管理工具中针对特别模块的配置。

自定义显示字段

class Author(models.Model):
    '''
    作者有姓，有名及email地址
    '''
    first_name = models.CharField(max_length=30)last_name = models.CharField(max_length=40)email = models.EmailField(blank=True, verbose_name='e-mail')
def __str__(self):
        return u'%s %s' % (self.first_name, self.last_name)

from django.contrib import admin
from books.models import Publisher, Author, Bookclass AuthorAdmin(admin.ModelAdmin):list_display = ('first_name', 'last_name', 'email')# Register your models here.
admin.site.register(Publisher)
# admin.site.register(Author)
admin.site.register(Author, AuthorAdmin)
admin.site.register(Book)

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

from django.contrib import admin
from books.models import Publisher, Author, Bookclass 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 = ('publisher_date',)# Register your models here.
admin.site.register(Publisher)
# admin.site.register(Author)
admin.site.register(Author, AuthorAdmin)
admin.site.register(Book, BookAdmin)

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

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

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

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

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

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

class Professor(People):job_title = models.CharField(max_length=150, blank=True, verbose_name='职称')class ResDir(models.Model):
    research_direction = models.TextField(blank=True, verbose_name='研究方向')professor = models.ForeignKey(Professor)# postgraduate = models.ForeignKey(Postgraduate)

class inlineBase(admin.TabularInline):
    extra = 1

class ResDirInline(inlineBase):  # 要重启runserver
    model = ResDirclass ProfessorAdmin(admin.ModelAdmin):
    inlines = [ResDirInline, ]

INSTALLED_APPS = (
...
'nested_inline'
)

# 实验室相关信息
class Lab(models.Model):
    introduction = models.TextField(null=True)achievement = models.TextField(null=True)class Directions(models.Model):
    research_direction = models.TextField(blank=True, verbose_name='研究方向')lab = models.ForeignKey(Lab)

class Images(models.Model):
    images = models.ImageField(blank=True, verbose_name='图片')directions = models.ForeignKey(Directions)

class ImagesInline(NestedInlineBase):
    model = Images

class DirectionsInline(NestedInlineBase):
    model = Directionsinlines = [ImagesInline]class LabAdmin(NestedModelAdmin):
    inlines = [DirectionsInline]
admin.site.register(Lab, LabAdmin)

因为你是用超级用户登录的，你可以创建，编辑和删除任何对像。

管理工具有一个用户权限系统，通过它你可以根据用户的需要来指定他们的权限，从而达到部分访问系统的目的。用户帐号应该是通用的、独立于管理界面以外仍可以使用。但我们现在把它看作是管理界面的一部分。 [如何把用户帐号与你的网站（不仅仅是管理工具）集成在一起]

你通过管理界面编辑用户及其许可就像你编辑别的对象一样。  如你所想，用户对象有标准的用户名、密码、邮箱地址和真实姓名，同时它还有关于使用管理界面的权限定义。
首先，这有一组三个布尔型标记：

• 活动标志，它用来控制用户是否已经激活。 如果一个用户帐号的这个标记是关闭状态，而用户又尝试用它登录时，即使密码正确，他也无法登录系统。

• 成员标志，它用来控制这个用户是否可以登录管理界面（即：这个用户是不是你们组织里的成员） 由于用户系统可以被用于控制公众页面（即：非管理页面）的访问权限，这个标志可用来区分公众用户和管理用户。

• 超级用户标志，它赋予用户在管理界面中添加、修改和删除任何项目的权限。 如果一个用户帐号有这个标志，那么所有权限设置（即使没有）都会被忽略。

普通的活跃、非超级用户的管理用户可以根据一套设定好的许可进入。

管理界面中每种可编辑的对象（如：books）都有三种权限：创建 许可，编辑 许可和删除 许可。 给一个用户授权许可也就表明该用户可以进行许可描述的操作。

当你创建一个用户时，它没有任何权限，该有什么权限是由你决定的。 例如，你可以给一个用户添加和修改publishers的权限，而不给他删除的权限。 请注意，这些权限是定义在模块级别上，而不是对象级别上的。这种基于对象级别的权限设置比较复杂，可以在Django documentation中寻找答案。

Note：权限管理系统也控制编辑用户和权限。 如果你给某人编辑用户的权限，他可以编辑自己的权限，这种能力可能不是你希望的。 赋予一个用户修改用户的权限，本质上说就是把他变成一个超级用户。

你也可以给组中分配用户。 一个 组 简化了给组中所有成员应用一套许可的动作。 组在给大量用户特定权限的时候很有用。

何时、为什么使用管理界面？