接上一篇Django入门-从0开始编写一个投票网站(三)
开始笔记的part7-8。

part 7

• 自定义admin的表单
  在admin.py里注册了Question以后django默认会生成一个表单样式，如果需要自定义这个样式的话，在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)
  

  可以看到结果是这样的：
  customize_admin_01.png

  这个看着不明显，那就这样：

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

  customize_admin_02.png

• 添加关联对象
  现在admin页面没有关联到问题的答案选项，我们关联一下，在polls/admin.py里：

  from django.contrib import admin
  from .models import Choice, Question
  class ChoiceInline(admin.StackedInline):
        model = Choice
        extra = 3
  
  class Question(admin.ModelAdmin):
        fieldsets = [
            (None, {'fields': ['question_text']}),
            ('Date information', {'fields': ['pub_date'], 'classes':['collapse']}),
        ]
        inlines = [ChoiceInline]
  admin.site.register(Question, QuestionAdmin)
  

  上面的代码告诉django：“Choice 对象会在Question的页面被编辑。默认会提供3个choice选项”。运行并尝试添加一个问题：
  add_choice_01.png

  这里有3个默认选项，这3个不能被移除。
  这样有个小问题：占用了很长的屏幕，换一个显示方式：

  class ChoiceInline(admin.TabularInline):
  

add_choice_02.png

简洁了不少。

• 自定义修改列表，在admin.py里：

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

  运行可以看到：
  change_list_01.png
  
  点击每一列titile可以排序。
  你可以给was_published_recently方法添加一点属性

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

  关于更多的方法属性，可以参看这里
  在侧边栏添加一个'filter'来增加根据日期筛选的功能：在QuestionAdmin里添加list_filter

  list_filter = [`pub_date`]
  

  最终结果是这样：
  change_list_02.png
  
  

  再来添加一个搜索框：

  search_fields = ['question_text']
  

  自己看看结果。

• 自定义admin界面的外观。目前admin的界面的左上角的title一直是Django administration，如果需要自定义的话。在settings.py里：

  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',
                ],
            },
      },
  ]
  

  DIRS是在加载django模版时的一个文件检索列表。
  现在在templates文件夹里新建一个admin的文件夹，然后从django源文件的django/contrib/admin/templates里找到admin/base_site.html，拷贝到刚刚创建的admin文件夹里。(如果不知道django源文件在哪，运行python -c "import django; print(django.__path__)")，修改{{ site_header|default:_('Django administration') }}改成你需要的名字，更改完以后长这样：

  {% block branding %}
  <h1 id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a> 
  </h1>
  {% endblock %}
  

  django所有的admin模版都能自定义，做法都跟base_site.html一样：从源文件里拷贝对应的文件到你定义的文件夹里然后修改。

完结撒花，就是这么突然。