入门笔记翻译整理自：https://docs.djangoproject.com/en/1.8/
*该笔记将使用一个关于投票网络应用（poll application）的例子来阐述Django的用法。
1. 创建管理员（admin user）
运行代码
1 $ python manage.py createsuperuser 2 3 Username: admin 4 Email address: admin@example.com 5 6 Password: ********* 7 Password(again): ********* 8 Superuser created successfully.
2. 启动开发服务器（development server）
启动服务器
1 $ python manage.py runserver
打开本地域名，比如http://127.0.0.1:8000/admin/，浏览器将显示管理员登陆页面。
3. 进入管理员页面（admin site）
输入用户名和密码
4. 使投票应用可以被管理员更改
投票应用显示在管理员页面
1 #polls/admin.py 2 3 from django.contrib import admin 4 5 from .models import Question 6 7 admin.site.register(Question)
5. 探索管理员功能
略
6. 自定义管理员表单（admin form）
对admin.site.register(Question)进行替换
1 #polls/admin.py 2 3 from django.contrib import admin 4 5 from .models import Question 6 7 class QuestionAdmin(admin.ModelAdmin): 8 fields = ['pub_date', 'question_text'] 9 10 admin.site.register(Question, QuestionAdmin)
基本的思路是：创建一个ModelAdmin对象，然后将它作为第二个参数传递到register()方法中
再比如，
1 #polls/admin.py 2 3 from django.contrib import admin 4 5 from .models import Question 6 7 class QuestionAdmin(admin.ModelAdmin): 8 fieldsets = [ 9 (None, {'fields': ['question_text']}), 10 ('Date information', {'fields': ['pub_date'], 'classes':['collapse']}), 11 ] 12 13 admin.site.register(Question, QuestionAdmin)
7. 添加关联对象（related objects）
在投票应用中，Question有关联对象Choice。有两种方式添加关联对象
1 #polls/admin.py 2 3 from django.contrib import admin 4 5 from .models import Choice, Question 6 # ... 7 admin.site.register(Choice)
还可以
1 #polls/admin.py 2 3 from django.contrib import admin 4 5 from .models import Choice, Question 6 7 class ChoiceInline(admin.StackedInline): 8 model = Choice 9 extra = 3 10 11 class QuestionAdmin(admin.ModelAdmin): 12 fieldsets = [ 13 (None, {'fields': ['question_text']}), 14 ('Date information',{'fields': ['pub_date'], 'classes': ['collapse']}), 15 ] 16 inlines = [ChoiceInline] 17 18 admin.site.register(Question, QuestionAdmin)
此外，以下代码可以让界面简洁
1 # polls/admin.py 2 3 class ChoiceInline(admin.TabularInline): 4 # ...
8. 自定义更改列表（the admin change list）
运行代码
1 # polls/admin.py 2 3 class QuestionAdmin(admin.ModelAdmin): 4 # ... 5 list_display = ('question_text', 'pub_date', 'was_published_recently')
对于自定义方法was_published_recently，排序在默认状态下不能实现，且列表名称为方法名称，可以通过以下方式改进
1 # polls/models.py 2 3 class Question(models.Model): 4 # ... 5 def was_published_recently(self): 6 return self.pub_date >= timezone.now() - datetime.timedelta(days=1) 7 was_published_recently.admin_order_field = 'pub_date' 8 was_published_recently.boolean = True 9 was_published_recently.short_description = 'Published recently?'
可以向QuestionAdmin对象添加过滤器和搜索功能
1 # polls/admin.py 2 3 class QuestionAdmin(admin.ModelAdmin): 4 # ... 5 list_filter = ['pub_date'] 6 search_fields = ['question_text']
9. 自定义管理页面外观（admin look and feel）
在manage.py所在目录下，创建templates子目录。添加DIRS到设置文件（mysite/settings.py，牢记）中的TEMPLATES设置：
1 TEMPLATES = [ 2 { 3 'BACKEND': 'django.template.backends.django.DjangoTemplates', 4 'DIRS': [os.path.join(BASE_DIR, 'templates')], 5 'APP_DIRS': True, 6 'OPTIONS': { 7 'context_processors': [ 8 'django.template.context_processors.debug', 9 'django.template.context_processors.request', 10 'django.contrib.auth.context_processors.auth', 11 'django.contrib.messages.context_processors.messages', 12 ], 13 }, 14 }, 15 ]
在templates目录中，建立admin子目录，并复制django/contrib/admin/templates中的模板admin/base_site.html。然后对base_site.html进行修改。
10. 自定义应用模板(application's templates)及管理索引页面(admin index page)
步骤和9类似
--The End--