Django系列教程：八、Django中的管理工具Admin
注明：python版本为3.3.1、Django版本为1.5.1，操作系统为Windows7，其他版本有一些不同的地方读者可以自行探讨。
上一章我们讲到的模型需要通过一定的实践才能逐步掌握熟练，这一章我们来讲讲Django中的管理工具Admin。
我们先来解决几个问题，再来学习。
1、什么是Admin？
Admin是django.contrib包中的第一个部分，说白了就是django.contrib.admin，而contrib是一套庞大的功能集，它是Django基本代码的组成部分，Django框架就是由众多包含附加组件(add-on)的基本代码构成的。 你可以把django.contrib看作是可选的Python标准库或普遍模式的实际实现。 它的存在简化了很多重复性的操作，让开发更加迅速方便。
2、为什么要用Admin？
对于某一类网站，管理界面是基础设施中非常重要的一部分。 这是以网页和有限的可信任管理者为基础的界面，它可以让你添加，编辑和删除网站内容。 一些常见的例子： 你可以用这个界面发布博客，后台的网站管理者用它来润色读者提交的内容，你的客户用你给他们建立的界面工具更新新闻并发布在网站上，这些都是使用管理界面的例子。但是管理界面有一问题： 创建它太繁琐。 当你开发对公众的功能时，网页开发是有趣的，但是创建管理界面通常是千篇一律的。 你必须认证用户，显示并管理表格，验证输入的有效性诸如此类。 这很繁琐而且是重复劳动。
所以我们选择使用Django自带的admin管理界面。至于以后还可以使用contrib中的其他诸如auth等等功能，在以后的教程中将会有所涉及。
3、开始使用
好了，在了解了上述几个问题后咱们开始一步一步的配置好一个Admin管理界面，我们从头开始吧。
1.创建Project为testadmin
django-admin.py startproject testadmin
文档结构如下：
D:\DJCODE\TESTADMIN | manage.py | \---testadmin settings.py urls.py wsgi.py __init__.py
2.配置数据库（在postgreSQL中用pgAdmin新建了一个数据库django）
DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql_psycopg2', # Add 'postgresql_psycopg2', 'mysql', 'sqlite3' or 'oracle'. 'NAME': 'django', # Or path to database file if using sqlite3. # The following settings are not used with sqlite3: 'USER': 'postgres', 'PASSWORD': '911027', 'HOST': '', # Empty for localhost through domain sockets or '127.0.0.1' for localhost through TCP. 'PORT': '', # Set to empty string for default. } }
至于如何验证是否配置成功，请参见第六章模型。
3.创建一个应用为book
python manage.py startapp book
在book文件夹中找到models.py文件，将其代码修改为第六、七章中的代码即可，文件中代码如下：
from django.db import models class Publisher(models.Model): name = models.CharField(max_length=30) address = models.CharField(max_length=50) city = models.CharField(max_length=60) state_province = models.CharField(max_length=30) country = models.CharField(max_length=50) website = models.URLField() class Author(models.Model): first_name = models.CharField(max_length=30) last_name = models.CharField(max_length=40) email = models.EmailField()
然后配置app，将其添加到settings.py文件相应的地方，如：
INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'django.contrib.messages', 'django.contrib.staticfiles', 'book',#添加这一项，和前面那章不同，前面的是books，注意别搞错了 # Uncomment the next line to enable the admin: # 'django.contrib.admin', # Uncomment the next line to enable admin documentation: # 'django.contrib.admindocs', )
最后验证模型并且执行代码。
D:\Djcode\testadmin>python manage.py validate
0 errors found
D:\Djcode\testadmin>python manage.py syncdb Creating tables ... Creating table auth_permission Creating table auth_group_permissions Creating table auth_group Creating table auth_user_groups Creating table auth_user_user_permissions Creating table auth_user Creating table django_content_type Creating table django_session Creating table django_site Creating table book_publisher Creating table book_author You just installed Django's auth system, which means you don't have any superuse rs defined. Would you like to create one now? (yes/no):
然后再按照下图操作即可。
创建后的auth的用户名为：django 密码为：911027
说明：为什么直接跳到Auth的创建过程了呢？因为在settings.py中INSTALLED_APP里面并没有注释掉：
'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'django.contrib.messages', 'django.contrib.staticfiles',
只要在其前面加上#号即可。
4.配置admin和url
将settings.py中的INSTALLED_APP中的admin选项前面的#好去掉。
# Uncomment the next line to enable the admin: 'django.contrib.admin', # Uncomment the next line to enable admin documentation: 'django.contrib.admindocs',
更改urls.py文件代码如下：
from django.conf.urls import patterns, include, url # Uncomment the next two lines to enable the admin: from django.contrib import admin#将注释取消 admin.autodiscover()#将注释取消 urlpatterns = patterns('', # Examples: # url(r'^$', 'testadmin.views.home', name='home'), # url(r'^testadmin/', include('testadmin.foo.urls')), # Uncomment the admin/doc line below to enable admin documentation: url(r'^admin/doc/', include('django.contrib.admindocs.urls')),#将注释取消 # Uncomment the next line to enable the admin: url(r'^admin/', include(admin.site.urls)),#将注释取消 )
输入：http://127.0.0.1:8000/admin/ 访问后看到如下界面。
输入用户名django和密码911027即可登陆。
当然如果你的母语不是英语，而你不想用它来配置你的浏览器，你可以做一个快速更改来观察Django管理工具是否被翻译成你想要的语言。 仅需添加django.middleware.locale.LocaleMiddleware 到settings.py文件中MIDDLEWARE_CLASSES设置中，并确保它在django.contrib.sessions.middleware.SessionMiddleware之后。
5.将Models添加到Admin管理界面中
在上一步进入到Admin管理界面后，你只能看到几项简单的操作，其实我们最重要的是对book这个app进行操作，比如添加相关的信息等，那么我们就需要将其注册到Admin管理界面中来。具体如下：
在book目录下创建admin.py文件，其代码如下：
from django.contrib import admin from book.models import Publisher, Author #这里需要特别注意，此处是book而不要因为看到别的书写成mysite.book admin.site.register(Publisher) admin.site.register(Author)
完成后重启web服务，在登陆：http://127.0.0.1:8000/admin/ 界面，你会注意到多了点什么呢？如下图：
好了，现在可以在这里添加些数据了，你再去数据库看看是不是加上了呢！至于Admin的工作原理和一些使用方法，大家百度百度，自己动手吧。下一章我们讲解一下表单的创建和一些简单的处理吧。
本人既是python的初学者也是Django的初学者，写这一系列教程的目的就是为了加深自己的理解，希望大家多多包涵和指教，有什么问题请留言，谢谢。