本文共 5861 字，大约阅读时间需要 19 分钟。
站点管理也称之为后台，比如说博客的后台你可以发布文章，修改文章，修改频道等信息。
Django使用极少的代码为你做了一切，在Django中创建管理界面已经不是问题，它读取你模式中的元数据，然后提供给你一个强大而且可以使用的界面，网站管理者可以用它立即工作。
Django自动管理工具是django.contrib的一部分。django.contrib是一套庞大的功能集，它是Django基本代码的组成部分，Django框架就是由众多包含附加组件(add-on)的基本代码构成的。你可以把django.contrib看作是可选的Python标准库或普遍模式的实际实现。它们与Django捆绑在一起，这样你在开发中就不用重复发明轮子了。
Django管理站点完全是可选择的，如果你要开其它，请根据下面的步骤来操作：
打开settings.py文件，找到INSTALLED_APPS段；
django1.10默认已经为你开启了
| 1 2 3 4 5 6 7 8 9 | INSTALLED_APPS = [ 'django.contrib.admin' , 'django.contrib.auth' , 'django.contrib.contenttypes' , 'django.contrib.sessions' , 'django.contrib.messages' , 'django.contrib.staticfiles' , 'darker' , ] |
生成数据库
| 1 2 3 | E:\DarkerProjects>python manage.py check E:\DarkerProjects>python manage.py makemigrations E:\DarkerProjects>python manage.py migrate |
将admin配置URLconf(urls.py文件)到中
| 1 2 3 4 | urlpatterns = [ # 默认已经开启 url(r '^admin/' , admin.site.urls), ] |
运行Django
| 1 2 3 4 5 6 7 8 | E:\DarkerProjects>python manage.py runserver Performing system checks... System check identified no issues ( 0 silenced). August 09 , 2016 - 15 : 44 : 06 Django version 1.10 , using settings 'DarkerProjects.settings' Starting development server at http: / / 127.0 . 0.1 : 8000 / Quit the server with CTRL - BREAK. |
访问管理界面
打开浏览器访问http://127.0.0.1:8000/admin
如果配置没有问题你将会看到如下界面：
不知你是否已经发现并没有登陆的用户名和密码？如果没有请通过如下命令创建：
| 1 2 3 4 5 6 7 8 | E:\DarkerProjects>python manage.py createsuperuser Username (leave blank to use 'administrator' ): ansheng Email address: anshengme.com@gmail.com # helloword Password: # helloword Password (again): Superuser created successfully. |
设置完成之后重新打开http://127.0.0.1:8000/admin页面，输入我们刚刚用户名和密码，绝壁的会登陆成功。
登陆成功之后，默认情况下她仅有两个默认的管理-编辑模块：用户组(Groups)和用户(Users)。
打开settings.py文件，找到MIDDLEWARE配置项：
| 1 2 3 4 5 6 7 8 9 10 | MIDDLEWARE = [ 'django.middleware.security.SecurityMiddleware' , '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.middleware.locale.LocaleMiddleware' , # 这是新添加的内容，请确保此项在'django.middleware.clickjacking.XFrameOptionsMiddleware'后面 ] |
更改完成之后你不需要重新启动django也可以看到生效页面，如下图：
上篇文章中我们定义了三个模块student、course和score
打开darkerapp目录下面的admin.py，内容修改为：
| 1 2 3 4 5 6 7 8 | from django.contrib import admin from darker.models import student, course, score # Register your models here. admin.site.register(student) admin.site.register(course) admin.site.register(score) |
完成后，打开页面http://127.0.0.1:8000/admin，你会看到一个DARKER区域，其中包含Courses、Scores和Students,如下图：
当服务启动时，Django从url.py引导URLconf，然后执行admin.autodiscover()语句。这个函数遍历INSTALLED_APPS配置，并且寻找相关的admin.py文件,如果在指定的app目录下找到admin.py，它就执行其中的代码。
在darker应用程序目录下的admin.py文件中，每次调用admin.site.register()都将那个模块注册到管理工具中,管理工具只为那些明确注册了的模块显示一个编辑/修改的界面。
应用程序django.contrib.auth包含自身的admin.py ，所以Users和Groups能在管理工具中自动显示，其它的django.contrib应用程序，如django.contrib.redirects，其它从网上下在的第三方Django应用程序一样，都会自行添加到管理工具.
综上所述，管理工具其实就是一个Django应用程序，包含自己的模块、模板、视图和URLpatterns，你要像添加自己的视图一样，把它添加到URLconf里面，你可以在Django基本代码中的django/contrib/admin目录下，检查它的模板、视图和URLpatterns，但你不要尝试直接修改其中的任何代码，因为里面有很多地方可以让你自定义管理工具的工作方式。
只需要在列内增加如下字段，例如：
| 1 | gender = models.CharField(max_length = 2 ,blank = True ) |
以上代码表示性别是可选的，如果你设置一个日期类型为空那么请设置成如下：
| 1 | date = models.DateField( * * blank = True , null = True * * ) |
在编辑页面中，每个字段的标签都是从模块的字段名称生成的。规则：用空格替换下划线；首字母大写。
如果你需要自定义标签，请设置如下：
| 1 2 3 4 5 6 | class student(models.Model): id = models.AutoField sname = models.CharField(max_length = 12 , verbose_name = "姓名" ) sname = models.CharField( "姓名" , max_length = 12 ) gender = models.CharField(max_length = 2 , blank = True , verbose_name = "性别" ) # gender = models.CharField("性别", max_length=2, blank=True) |
然后再次通过管理页面进行添加数据的时候将会得到如下界面：
请先把admin.py文件回滚到最初的状态并且修改models.py文件内容为：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 | from django.db import models # Create your models here. class UserInfo(models.Model): id = models.AutoField name = models.CharField(max_length = 12 , verbose_name = "姓名" ) gender = models.CharField(max_length = 2 , blank = True , verbose_name = "性别" ) email = models.EmailField( "邮箱" ) date = models.DateField(verbose_name = "创建日期" ) def __str__( self ): return '%s %s %s %s %s' % ( self . id , self .name, self .gender, self .email, self .date) |
然后创建数据表：
| 1 2 3 | E:\DarkerProjects>python manage.py check E:\DarkerProjects>python manage.py makemigrations E:\DarkerProjects>python manage.py migrate |
修改admin.py文件内容为：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | from django.contrib import admin from darker.models import UserInfo # Register your models here. class AuthorAdmin(admin.ModelAdmin): # 列表显示的名称 list_display = ( "id" , "name" , "gender" , "email" , "date" ,) # 快速查询栏 search_fields = ( 'id' , 'name' ,) # 时间的过滤，它包含：今天、过往七天、当月和今年 list_filter = ( 'date' ,) # 同上 date_hierarchy = 'date' # 排序的时候倒序，根据ID ordering = ( '-id' ,) admin.site.register(UserInfo, AuthorAdmin) |
因为数据库被重新初始化了，你又可以需要重置管理员密码，不过这并不重要，执行python manage.py runserver，登陆之后在UserInfo表中插入几条数据，然后就会得到如下界面：
在admin.py文件中的AuthorAdmin类添加一行代码：
fields = ("name", "email", "date",)# filter_horizontal = ('authors',) 多选，filter_horizontal和filter_vertical选项只能用在多对多字段上 表示是再添加数据的实现显示的选项，如下图：
三个布尔型标记
活动标志，它用来控制用户是否已经激活，如果一个用户帐号的这个标记是关闭状态，而用户又尝试用它登录时，即使密码正确，他也无法登录系统。
成员标志，它用来控制这个用户是否可以登录管理界面（即：这个用户是不是你们组织里的成员）由于用户系统可以被用于控制公众页面（即：非管理页面）的访问权限（详见第十四章），这个标志可用来区分公众用户和管理用户。
超级用户标志，它赋予用户在管理界面中添加、修改和删除任何项目的权限，如果一个用户帐号有这个标志，那么所有权限设置（即使没有）都会被忽略。
当你创建一个用户时，它没有任何权限，该有什么权限是由你决定的，这些权限是定义在模块级别上，而不是对象级别上的。
权限管理系统也控制编辑用户和权限，如果你给某人编辑用户的权限，他可以编辑自己的权限，这种能力可能不是你希望的。 赋予一个用户修改用户的权限，本质上说就是把他变成一个超级用户。
你也可以给组中分配用户，一个组简化了给组中所有成员应用一套许可的动作，组在给大量用户特定权限的时候很有用。