Django入门笔记【二】

入门笔记翻译整理自：https://docs.djangoproject.com/en/1.8/

*该笔记将使用一个关于投票网络应用（poll application）的例子来阐述Django的用法。

1. 创建管理员（admin user）

运行代码

$ python manage.py createsuperuser

Username: admin
Email address: admin@example.com

Password: *********
Password(again): *********
Superuser created successfully.

2. 启动开发服务器（development server）

启动服务器

$ python manage.py runserver

打开本地域名，比如http://127.0.0.1:8000/admin/，浏览器将显示管理员登陆页面。

3. 进入管理员页面（admin site）

输入用户名和密码

4. 使投票应用可以被管理员更改

投票应用显示在管理员页面

#polls/admin.py

from django.contrib import admin

from .models import Question

admin.site.register(Question)

5. 探索管理员功能

略

6. 自定义管理员表单（admin form）

对admin.site.register(Question)进行替换

#polls/admin.py

from django.contrib import admin

from .models import Question

class QuestionAdmin(admin.ModelAdmin):
    fields = ['pub_date', 'question_text']

admin.site.register(Question, QuestionAdmin)

基本的思路是：创建一个ModelAdmin对象，然后将它作为第二个参数传递到register()方法中

再比如，

#polls/admin.py

from django.contrib import admin

from .models import Question

class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,                    {'fields': ['question_text']}),
        ('Date information', {'fields': ['pub_date'], 'classes':['collapse']}), 
    ]

admin.site.register(Question, QuestionAdmin)

7. 添加关联对象（related objects）

在投票应用中，Question有关联对象Choice。有两种方式添加关联对象

#polls/admin.py

from django.contrib import admin

from .models import Choice, Question
# ...
admin.site.register(Choice)

还可以

#polls/admin.py

from django.contrib import admin

from .models import Choice, Question

class ChoiceInline(admin.StackedInline):
    model = Choice
    extra = 3

class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,                   {'fields': ['question_text']}),
        ('Date information',{'fields': ['pub_date'], 'classes': ['collapse']}),
    ]
    inlines = [ChoiceInline]

admin.site.register(Question, QuestionAdmin)

 此外，以下代码可以让界面简洁

# polls/admin.py

class ChoiceInline(admin.TabularInline):
    # ...

8. 自定义更改列表（the admin change list）

运行代码

# polls/admin.py

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ('question_text', 'pub_date', 'was_published_recently')

对于自定义方法was_published_recently，排序在默认状态下不能实现，且列表名称为方法名称，可以通过以下方式改进

# polls/models.py

class Question(models.Model):
    # ...
    def was_published_recently(self):
        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
    was_published_recently.admin_order_field = 'pub_date'
    was_published_recently.boolean = True
    was_published_recently.short_description = 'Published recently?'

可以向QuestionAdmin对象添加过滤器和搜索功能

# polls/admin.py

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_filter = ['pub_date']
    search_fields = ['question_text']

 9. 自定义管理页面外观（admin look and feel）

在manage.py所在目录下，创建templates子目录。添加DIRS到设置文件（mysite/settings.py，牢记）中的TEMPLATES设置：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

在templates目录中，建立admin子目录，并复制django/contrib/admin/templates中的模板admin/base_site.html。然后对base_site.html进行修改。

10. 自定义应用模板(application's templates)及管理索引页面(admin index page)

步骤和9类似

--The End--