django 入门笔记：Admin 管理系统及表单

django 及 rest_framework 笔记链接如下：
django 入门笔记：环境及项目搭建
django 入门笔记：数据模型
django 入门笔记：视图及模版
django 入门笔记：Admin 管理系统及表单
django 入门笔记：通用视图类重构视图
django_rest_framework 入门笔记：Serializer
django_rest_framework 入门笔记：视图函数重构
django_rest_framework 入门笔记：分页，多条件筛选及权限认证设置
django 自带 user 字段扩展及头像上传

django 的强大之处还有自带后台管理系统，真心给力！！
这一部分将介绍 django 自带的后台管理系统，以及如何通过表单提交数据

一. django admin 后台管理系统

1. 在后台管理系统注册创建的模型

   from django.contrib import admin
   from blog.models import Post, Category, Tag
   
   # 在应用目录下的 admin.py 文件中，对创建的模型进行注册，可以一起用列表注册，也可以分开注册
   admin.site.register([Post, Category, Tag])
   

   然后运行项目，python manager.py runserver 192.168.x.xxx:8080
   可以通过 "http://192.168.x.xxx:8080/admin" 打开 admin 管理系统，登录的账号密码就是我们第一部分通过命令行 createsuperuser时所创建的，登陆后我们可以找到站点管理，对模型进行管理操作

   

   admin 登录界面
   
   
   

   admin 主界面

   当然，django 自带的 admin 管理系统不止那么点功能，接着我们通过定义一些参数，来定制 admin 界面

2. 自定义 admin

   # 在使用后台管理的时候，可能需要自己定制 admin 的显示内容，可以通过如下进行定制
   @admin.register(Post)
   class PostAdmin(admin.ModelAdmin)
    list_display = ['title', 'category', 'author'] # 需要展示的字段
    
   # 或者通过以下方式注册，效果是一样的
   class PostAdmin(admin.ModelAdmin)
    list_display = ['title', 'category', 'author'] 
    
   admin.site.register(Post, PostAdmin)
   
   @admin.register(Category)
   class CategoryAdmin(admin.ModelAdmin)
       # 显示的标签字段，字段不能是 ManyToManyField 类型
       list_display = ('title', 'publisher')
       
    # 设置每页显示多少条记录，默认是100条
       list_per_page = 20
       
       # 设置默认可编辑字段
       list_editable = ['title', 'author']
       
       # 排除一些不想被编辑的 fields, 没有在列表的不可被编辑
       fields = ('title', 'author')
       
       # 设置哪些字段可以点击进入编辑界面
       list_display_links = ('tag', 'title')
       
       # 进行数据排序，负号表示降序排序
       ordering = ('-id',)
       
       # 显示过滤器
       list_filter = ('author', 'title')
       
       # 显示搜索框，搜索框大小写敏感
       search_fields = ('title',)
       
       # 详细时间分层筛选
       date_hierarchy = 'create_time'
       
       # 增加多选框 filter_horizaontal 和 filter_vertical 作用相同，只是方向不同，只用于
       # ManyToManyField 类型的字段
       filter_horizontal = ('authors',)
       
   # 修改 admin 页面显示标题
   admin.site.site_header = "Blog Manager System"
   # 修改 admin 页面头部标题
   admin.site.site_title = "Blog Manager"
   

   修改以后，我们的界面可以看到是以下这样的

   
   
   

   修改后 admin 登录界面
   

   admin 管理界面

为了可以和用户进行交流，我们需要获取用户的一些评论之类的，所以我们需要通过表单让用户提交信息，接下来我们将了解下 django 的表单

二. django 表单

存在相应模型（POST 方式）

1. 在应用文件夹下创建 forms.py 文件存放表单

   from django import forms
   from .models import Post
   
   # 表单类必须继承 forms.ModelForm 或者 forms.Form 类，如果有相应的模型，则使用 ModelForm 更方便
   class PostForm(forms.ModelForm):
       class Meta:
           # 表单对应的数据库模型
           model = Post
           # 指定表单需要显示的字段
           fields = ['title', 'body']
   

2. 创建表单视图

   from django.shortcuts import render, redict
   from blog.models import Post
   from blog.forms import PostForm
   
   def new_post(request):
       # Http 请求包括 POST 和 GET 两种，一般提交数据都是用 POST 请求
       # 因此当 request.method 为 POST 的时候才需要处理表单数据
       if request.method = 'POST':
           # 用户提交的信息存在 request.POST 中，相当于一个字典取值
           form = PostForm(request.POST)
           # 判断表单是否有效，django 自动校验表单数据是否合理，根据模型的字段类型来判断
           if form.is_valid():
               # commit=False 表示只生成模型类的实例，不马上保存到数据库
               post = form.save(commit=Flase)
               # 将作者和文章进行关联
               post.author = request.user
               # 通过调用 save() 方法将数据存入数据库
               post.save()
               # return render('post_detail', pk=post.pk)
               # 如果模型类中定义了 get_absolute_url 方法，可以用以下方式跳转
               # 会直接跳转 get_absolute_url 方法所指向的地址
               return redirect(post)
    else:
           # 如果不是 POST 重定向到空白的新建页面
           form = PostForm()
    return render(request, 'blog/post_new.html', locals())
   

3. 绑定 URL

   urlpatterns = [url(r'^post/new/$', views.new_post, name='new_post'),]
   

4. 通过模版进行表单的前端渲染

   
       {# 防止被攻击，使表单更加安全 #}
       {% csrf_token %}
       
   
           
   
               标题：
               {# 根据模型的字段类型自动渲染成表单 #}
               {{ form.title }}
               {# 渲染表单对应的错误 #}
               {{ form.title.errors }}
           
           
           
   
               标题：
               {{ form.body }}
               {{ form.body.errors }}
           
           
           
   
               发表：
           
       
   
   

   我们打开界面可以看到新加文章的表单界面，当提交的信息发生错误的时候，就会显示错误让用户改正

   
   
   

   提交表单
   

   提交表单错误

不存在对应模型（POST 方式）

1. 在 forms.py 中创建表单

   # 假设有个信息反馈的表单
   class ContractForm(forms.Form):
       subject = forms.CharField(max_length=100)
       email = forms.EmailField(required=False, label='Your Email')
       message = forms.CharField(widget=forms.Textarea(attrs={'clos': 80, 'rows': 20}))
       
       # 自定义校验规则，以 clean 开头，字段名结尾，校验时候自动调用方法
       # 例如过滤信息长度小于 4 个字的信息，提示用户修改
    def clean_message(self):
           message = self.cleaned_data['message']
           num_word = len(self.message.split())
           if num_word < 4:
               raise forms.ValidationError('Not Enough words')
           return message
   

2. 创建表单视图

   def post_contract(request):
    if request.method = 'POST':
           form = ContractForm(request.POST)
           if form.is_valid():
               # 只打印查看提交的结果是否正确
               cd = form.cleaned_data
               print(cd)
               # 提交成功后跳转 home 页面，通过 spacename 和 name 值指定页面
               return redict('blog:home')
       else:
           # 不是 POST 方式则重定向到空白页面
           form = ContractForm()
    return render(request, 'blog/contact_post.html', locals())
   

3. 绑定 URL

   urlpatterns = [url(r'^contract/$', 'contract_us.html', name='contract_us'),]
   

4. 通过模版进行表单的前端渲染

   
   
   
       
       
   
   
   
   Contact Us
       
   {% if form.errors %}
       
   
           Please correct the error{{ form.errors|pluralize }} below.
       
   {% endif %}
   
   
       {% csrf_token %}
       
           {{ form.as_table }}
       
       
   
   
   
   

打开反馈界面我们可以看到

提交反馈

提交反馈错误

类似搜索的表单（GET）

1. 创建表单视图

   def search(request):
       # 获取到用户提交的搜索关键词，字典的键值同模版中的 name 属性值
       q = request.GET.get('q')
       error_message = ''
    # 根据 q 的值是否空设置相关信息
       if not q:
           error_message = 'Input Keyword'
           return render(request, 'blog/home.html', locals())
   
       # Q 对象用于包装查询表达式，其作用是为了提供复杂的查询逻辑
       post_list = Post.objects.filter(Q(title__icontains=q) | Q(body__icontains=q))
       return render(request, 'blog/home.html', locals())
   

2. 绑定 URL

   urlpatterns = [url(r'^search/$', views.search, name='search'),]
   

3. 通过模版进行表单的前端渲染

   {# ...... #}
   
    
   
        
        
    
   
   {# ...... #}
   

   我们可以看到搜索框
   

   搜索表单

最后附上整个项目的地址：blog_project