zoukankan      html  css  js  c++  java
  • 第二部分:管理站点

    Django会根据你写的模型文件完全自动地生成管理界面

    0x01 创建管理员

    python manage.py createsuperuser
    

     接下来根据提示,输入用户名、邮箱、密码

    在服务器启动后,访问http://127.0.0.1:8000/admin/

    如果在这里,你看到的不是登录界面,而是出现有如下内容的错误页面。

    ImportError at /admin/
    cannot import name patterns
    ...
    

    你可能使用的版本和本教程的不一致。你需要换一个合适的Django版本

    0x02 进入管理站点

    让APP poll应用在管理站点中可编辑,但我们的poll应用在哪儿? 它没有显示在管理站点的首页面上。

    只需要做一件事:我们需要告诉管理站点Question 对象要有一个管理界面。 要做这件事,需要打开polls/admin.py文件,把它编辑成这样:

    from django.contrib import admin
    from .models import Question
    
    admin.site.register(Question)
    

     现在,我们已经在管理站点中注册了Question对象,Django应该把它显示在管理站点的首页面上:

    点击“Questions”。 现在,你会进入Question的“变更列表”。 这个界面显示了数据库中的所有question,你可以选择一个来更改它。 那里有我们在教程第1部分创建的“What’s up?” question:

     

    如果“Date published”的值和你在教程1中创建这个Question对象时的时间不相符,可能是因为你忘记将TIME_ZONE设置为正确的值

    0x03 自定义管理表单

    只需使用admin.site.register(Question)注册Question模型,Django就能构造一个默认的表单表示。通常,你会想要自定义管理界面中表单的外观和功能。 你可以通过在注册对象的时候告知Django一些你想要的选项来完成。

    创建一个模型管理对象,然后将其作为第二个参数传递给admin.site.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)
    

     classes字段为该字段集指定HTML样式类

    0x04 关联对象

    我们已经有自己的Question管理界面。 但是一个Question有多个Choices,管理界面中并没有将选项显示出来

    有两种方法来解决这个问题。 第一种是像我们为Question做的一样,在管理站点中注册Choice这很简单:

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

     

    在这个表单中,“Question”字段是一个可选的选项框,包含数据库中所有的Question。 Django知道ForeignKey应该在管理界面中显示为一个<select>选框

    但事实上,这不是一种添加Choice对象到系统中的高效方式,在创建Question对象的同时可以直接添加一组Choice将会更好

    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)
    

     这告诉Django:Choice对象在Question的管理界面中编辑。默认提供足够3个Choice的空间。

    它这样工作:有三个所关联的Choice  —— 由extra指定 —— 每次你回到已经存在对象的"Change"页面时,都会额外地获得三个空白Choice

     还有个小问题。 显示所有关联的Choice 对象的字段占用大量的屏幕空间。 为了解决这个问题,Django提供了一种以表格的形式显示内嵌的相关联对象的方法; 你只需改变一下ChoiceInline 的声明:

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

     使用 TabularInline(不是StackedInline),这些相关联的对象显示成紧凑的、基于表格的形式:

    0x05 自定义管理界面中的变更列表

    Question管理界面看起来已经很好了,让我们再来稍微调整一下“变更列表”界面 —— 该界面显示系统中所有的Question

    Django显示每个对象的str()返回的内容。但有时如果我们能显示个别的字段将很有帮助。 我们使用list_display 选项来实现这个功能

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

     再次编辑你的polls/admin.py文件来改进Question变更列表页面:使用list_filter来添加过滤器。将下面这行添加进QuestionAdmin

    list_filter = ['pub_date']
    

     这行代码添加一个“Filter”侧边栏,可以使人们通过pub_date字段对变更列表进行过滤:

    显示的过滤器类型取决于你所使用的字段类型。 由于pub_dateDateTimeField类型,所以Django将根据该类型给出相应的选项:“Any date”、“Today”、“Past 7 days”、“This month”、“This year”。

    这样看起来有些像我们想要的样子了。让我们再来添加一些搜索功能:

    search_fields = ['question_text']
    

     这行代码在变更列表的顶部添加了一个搜索框。 当有人将搜索的内容输入搜索框,Django将在question_text字段中进行搜索。

    0x06 自定义管理外观

    每个管理页面的顶部都有“Django administration”不太合适。它仅仅起到了占位符的作用

    自定义项目模版:

    在你项目的文件夹内(包含 manage.py的目录)创建一个templates目录。Templates可以放在你的文件系统中Django所能访问到的任何地方。

    打开你的配置文件(记住是mysite/settings.py)在TEMPLATES 设置中添加一个DIRS 选项

    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拷贝到这个文件夹里

     只需编辑该文件并替换{{ site_header|default:_('Django administration') }} (包括花括号)为你认为合适的自己站点的名称。编辑完成后应该类似下面的代码片段:

    {% block branding %}
    <h1 id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></h1>
    {% endblock %}
    
  • 相关阅读:
    【JVM】模板解释器--如何根据字节码生成汇编码?
    你会swap吗,按值传递还是按引用?
    你了解实时计算吗?
    Hadoop的Server及其线程模型分析
    机会
    storm如何分配任务和负载均衡?
    storm基础框架分析
    storm如何保证at least once语义?
    学习笔记:The Log(我所读过的最好的一篇分布式技术文章)
    学习笔记:Twitter核心数据类库团队的Hadoop优化经验
  • 原文地址:https://www.cnblogs.com/honey-badger/p/8531325.html
Copyright © 2011-2022 走看看