Django小项目简单BBS论坛

开发一个简单的BBS论坛

项目需求：

1 整体参考“抽屉新热榜” ＋ “虎嗅网”
2 实现不同论坛版块
3 帖子列表展示
4 帖子评论数、点赞数展示
5 在线用户展示
6 允许登录用户发贴、评论、点赞
7 允许上传文件
8 帖子可被置顶
9 可进行多级评论

知识必备：（注：没有必备下面知识的同学，请返回去看会之后再看下面的内容防止蒙了~~！）

1 Django
2 HTML\CSS\JS
3 BootStrap
4 Jquery

设计表结构

1、表结构重要性

在开发任何项目的时候，设计到数据库，第一个事情要做的是设计表结构。表结构设计不好就不要写代码，表结构是体现了你业务逻辑关系的。你的数据都要往数据库里存，其实表结构你要理清了你的架构也就出来了！

2、设计表

#!/usr/bin/env python
#-*- coding:utf-8 -*-from __future__ import unicode_literals
from django.db import models
from django.contrib.auth.models import User# Create your models here.class Article(models.Model):'''帖子表'''#标题最大长度255,不能重名title = models.CharField(u'文章标题',max_length=255,unique=True)#发布办款-使用外键关联Categorycategory = models.ForeignKey("Category",verbose_name='板块名称')'''这里在admin中,title默认是显示英文的,我们可以在他的最前面加要给字段,在admin中就可以显示中文,他和verbose_name一样,什么时候必须使用verbose_name呢?比如上面的{category = models.ForeignKey("Category",verbose_name='板块名称')} 这个字段第一个字段是关联的类,这里就必须使用verbose_name'''#上传文件head_img = models.ImageField(upload_to="uploads")#文章内容(文章内容可能有很多,所以我们就不用"CharField"来写了,我们用TextField,不用规定他多长了,为可扩展长度)content = models.TextField(u"内容")#文章作者author = models.ForeignKey("UserProfile",verbose_name="作者")#发布日期publish_date = models.DateTimeField(auto_now=True,verbose_name="发布日期")#是否隐藏hidden = models.BooleanField(default=False,verbose_name="是否隐藏")#帖子的优先级priority = models.IntegerField(default=1000,verbose_name="优先级")def __unicode__(self):return "<%s,author:%s>" % (self.title,self.author)class Comment(models.Model):'''评论表'''#评论是基于文章的,并且一条评论只属于一个文章!对多的关系#一个文章可以有多个评论,一个评论只属于一个文章#评论文章article = models.ForeignKey("Article")#评论用户user = models.ForeignKey("UserProfile")#评论内容comment = models.TextField(max_length=1000)#评论时间date = models.DateTimeField(auto_now=True)#多级评论,是不是评论评论的当前的表(自己表),所以就得和自己做一个关联!#这里在关联自己的时候必须设置一个related_name否则会报错冲突#这里parent_comment,必须设置为可以为空,因为如果他是第一评论他是没有父ID的parent_comment = models.ForeignKey("self",related_name='p_comment',blank=True,null=True)'''prent selfNull    11       21       32       4通过上面的这种方法来记录,评论的级别关系!'''def __unicode__(self):return "<user:%s>" %(self.user)
class ThumbUp(models.Model):'''点赞'''#给那个文章点的article = models.ForeignKey('Article')#用户名user = models.ForeignKey('UserProfile')#时间date = models.DateTimeField(auto_now=True)class Category(models.Model):'''板块表'''#板块名称name = models.CharField(max_length=64,unique=True,verbose_name="板块名称")#板块管理员admin = models.ManyToManyField("UserProfile",verbose_name="模块管理员")def __unicode__(self):return self.nameclass UserProfile(models.Model):'''用户表'''#使用Django提供的用户表,直接继承就可以了.在原生的User表里扩展!(原生的User表里就有用户名和密码)#一定要使用OneToOne,如果是正常的ForeignKey的话就表示User中的记录可以对应UserProfile中的多条记录!#并且OneToOne的实现不是在SQL级别实现的而是在代码基本实现的!user = models.OneToOneField(User)#名字name = models.CharField(max_length=32)#属组groups = models.ManyToManyField("UserGroup")def __unicode__(self):return self.nameclass UserGroup(models.Model):'''用户组表'''name = models.CharField(max_length=64,unique=True)def __unicode__(self):return self.name

配置Django Admin

配置admin注册model,不要忘记创建Django 管理员用户

from django.contrib import admin
import models
# Register your models here.
admin.site.register(models.Article)
admin.site.register(models.Category)
admin.site.register(models.Comment)
admin.site.register(models.ThumbUp)
admin.site.register(models.UserProfile)
admin.site.register(models.UserGroup)

我创建了几个板块，我在板块中查看的时候。只能看到下面简单的信息：

这里我想看到板块中的ID或其他信息怎么办？

#!/usr/bin/env python
#-*- coding:utf-8 -*-from django.contrib import admin
import models
# Register your models here.#给某个表专门的定制的类class CategoryAdmin(admin.ModelAdmin):list_display = ('id','name')class ArticleAdmin(admin.ModelAdmin):list_display = ('id','title','author','hidden','publish_date')admin.site.register(models.Article,ArticleAdmin) #把自定义的类绑定到注册的类中
admin.site.register(models.Category,CategoryAdmin)  #把自定义的类绑定到注册的类中admin.site.register(models.Comment)
admin.site.register(models.ThumbUp)
admin.site.register(models.UserProfile)
admin.site.register(models.UserGroup)

效果如下：

前端页面&URLorViews配置

1、url别名使用

url里配置别名

url(r'^category/(\d+)/$',views.category,name='category'),

html里配置的时候就只认那个别名了

          <li role="presentation"><a href="{% url 'category' 1 %}">欧美专区</a></li><li role="presentation"><a href="{% url 'category' 2 %}">日韩专区</a></li><li role="presentation"><a href="{% url 'category' 3 %}">印度专区</a></li>

别名的好处：如果说那天想修改url里的这个url名称了，是不是所有前端都得修改！并且在有好几层的时候怎么改使用别名就会非常方便了！

2、前端页面写完之后发现图片无法正常显示

出现这个问题的原因：他能找到uploads这个目录吗？他能直接访问这个目录吗？他不能直接访问不了！

一个是在Linux环境下做一个软连接连接过去

如果在settings里加入uploads这个目录，但是这个方法还是有问题！他会去找/static/uploads/uploads目录，看下面的图！

但是通过下面的方式就可以访问（原因就是因为：他去/static/uploads/uploads目录找了）

2.2、我们自己写上传的方法

定义form表单认证

#!/usr/bin/env python
#-*- coding:utf-8 -*-
# Tim Luo  LuoTianShuaifrom django import formsclass ArticleForm(forms.Form):title = forms.CharField(max_length=255,min_length=5)summary = forms.CharField(max_length=255,min_length=5)head_img = forms.ImageField()content = forms.CharField(min_length=10)category_id = forms.IntegerField()

定义上传方法

#!/usr/bin/env python
#-*- coding:utf-8 -*-
# Tim Luo  LuoTianShuaiimport osdef handle_upload_file(f,request):  #f这里获取到文件句柄base_img_upload_path = 'static/Uploads'user_path = "%s/%s" % (base_img_upload_path,request.user.userprofile.id)if not os.path.exists(user_path):os.mkdir(user_path)with open('%s/%s'% (user_path,f.name),'wb+') as destinations:for chunk in f.chunks():destinations.write(chunk)#为了防止用户传送图片进行冲突,我们为每个用户进行创建用户return "/static/Uploads/%s/%s" % (request.user.userprofile.id,f.name)

定义views

def new_article(request):category_list = models.Category.objects.all()if request.method == 'POST':form = ArticleForm(request.POST,request.FILES)if form.is_valid():form_data = form.cleaned_dataform_data['author_id'] = request.user.userprofile.id#自定义图片上传new_img_path = handle_upload_file(request.FILES['head_img'],request)#但是在views也保存了一份,我们给他改掉改成我们自己的就行了form_data['head_img'] = new_img_path#create只能返回成功失败,我想在创建完成之后返回文章的ID,直接下面那么写就可以print form_datanew_article_obj = models.Article(**form_data)new_article_obj.save()#这个对象就直接返回了return render(request,'new_article.html',{'new_article_obj':new_article_obj}) #如果没有这个变量说明是创建新文章呢else:print form.errorsreturn render(request,'new_article.html',{'category_list':category_list})

多级评论实现

用户可以直接对贴子进行评论，其它用户也可以对别的用户的评论再进行评论，也就是所谓的垒楼，如下图：

所有的评论都存在一张表中，评论与评论之前又有从属关系，如何在前端页面上把这种层级关系体现出来？

首先咱们在存储数据的时候是怎么来实现记录层级关系的呢？（下面的图是经过简化的把其他列隐藏了）

我们在上面创建数据库表结构的时候，就定义了一个外键为他们自己（parent_comment_id），如果他没有父级别的ID说明他们是第一层，如果有说明他包含在一个评论之内！（仔细看上面的表结构）

先把评论简化成一个这样的模型：

data = [(None,'A'),('A','A1'),('A','A1-1'),('A1','A2'),('A1-1','A2-3'),('A2-3','A3-4'),('A1','A2-2'),('A2','A3'),('A2-2','A3-3'),('A3','A4'),(None,'B'),('B','B1'),('B1','B2'),('B1','B2-2'),('B2','B3'),(None,'C'),('C','C1'),]

转换为字典之后：

data_dic = {'A': {'A1': {'A2':{'A3':{'A4':{}}},'A2-2':{'A3-3':{}}}},'B':{'B1':{'B2':{'B3':{}},'B2-2':{}}},'C':{'C1':{}}}

看上面的字典，我们能通过for循来获取他有多少层吗？当然不行，我们不知道他有多少层就没有办法进行找，或者通过while循环，最好是用递归进行一层一层的查找！

我们在前端展示的时候需要知道，那条数据是那一层的，不可能是垒下去的！因为他们是有层级关系的！

我们用后端来实现：咱们给前端返回一个字典这样是不行的，咱们在后端把层级关系建立起来~返回的时候直接返回一个完整的HTML

转换为字典之后就有层级关系了我们可以通过递归来实现了！上面再没有转换为字典的时候层级关系就不是很明确了！

在循环的过程中不断的创建字典，先建立最顶级的，然后在一层一层的建立

先通过一个简单的例子看下：

#!/usr/bin/env python
#-*- coding:utf-8 -*-
# Tim Luo  LuoTianShuaidata = [(None,'A'),('A','A1'),('A','A1-1'),('A1','A2'),('A1-1','A2-3'),('A2-3','A3-4'),('A1','A2-2'),('A2','A3'),('A2-2','A3-3'),('A3','A4'),(None,'B'),('B','B1'),('B1','B2'),('B1','B2-2'),('B2','B3'),(None,'C'),('C','C1'),]def tree_search(d_dic,parent,son):#一层一层找,先拨第一层,一层一层往下找for k,v in d_dic.items():#举例来说我先遇到A,我就把A来个深度查询,A没有了在找Bif k == parent:#如果等于就找到了parent,就吧son加入到他下面d_dic[k][son] = {} #son下面可能还有儿子#这里找到就直接return了,你找到就直接退出就行了returnelse:#如果没有找到,有可能还有更深的地方,的需要剥掉一层            tree_search(d_dic[k],parent,son)data_dic = {}for item in data:# 每一个item代表两个值一个父亲一个儿子parent,son = item#先判断parent是否为空,如果为空他就是顶级的,直接吧他加到data_dicif parent is None:data_dic[son] = {}  #这里如果为空,那么key就是他自己,他儿子就是一个空字典else:'''如果不为空他是谁的儿子呢?举例来说A3他是A2的儿子,但是你能直接判断A3的父亲是A2你能直接判断他是否在A里面吗?你只能到第一层.key所以咱们就得一层一层的找,我们知道A3他爹肯定在字典里了,所以就得一层一层的找,但是不能循环找,因为你不知道他有多少层,所以通过递归去找直到找到位置'''tree_search(data_dic,parent,son) #因为你要一层一层找,你的把data_dic传进去,还的把parent和son传进去for k,v in data_dic.items():print(k,v)

执行结果：（完美）

('A', {'A1': {'A2': {'A3': {'A4': {}}}, 'A2-2': {'A3-3': {}}}, 'A1-1': {'A2-3': {'A3-4': {}}}})
('C', {'C1': {}})
('B', {'B1': {'B2-2': {}, 'B2': {'B3': {}}}})

2、前端返回

当咱们把这个字典往前端返回的时候，前端模板里是没有一个语法递归的功能的，虽然咱们的层级关系已经出来了！所以咱们需要自定义一个模板语言然后拼成一个html然后返回给前端展示！

2.1、配置前端吧数据传给simple_tag

{% load custom_tags %}{% build_comment_tree article_obj.comment_set.select_related %}

2.2、simple_tag获取数据然后把用户穿过来的数据进行转换为字典

#!/usr/bin/env python
# -*- coding:utf-8 -*-from django import template
from django.utils.safestring import mark_saferegister = template.Library()def tree_search(d_dic,comment_obj):#这里不用传附近和儿子了因为他是一个对象,可以直接找到父亲和儿子for k,v_dic in d_dic.items():if k == comment_obj.parent_comment:#如果找到了d_dic[k][comment_obj] = {} #如果找到父亲了,你的把自己存放在父亲下面,并把自己当做key,value为一个空字典returnelse:#如果找不到递归查找            tree_search(d_dic[k],comment_obj)@register.simple_tag
def build_comment_tree(comment_list):'''把评论传过来只是一个列表格式(如下),要把列别转换为字典,在把字典拼接为html[<Comment: <A,user:罗天帅>>, <Comment: <A2-1,user:罗天帅>>, <Comment: <A3-1,user:罗天帅>>, <Comment: <A2-2,user:罗天帅>>,<Comment: <A4-1,user:罗天帅>>, <Comment: <A4-2,user:罗天帅>>, <Comment: <A5-1,user:罗天帅>>, <Comment: <A3-2,user:罗天帅>>,<Comment: <B2,user:罗天帅>>, <Comment: <B2-1,user:罗天帅>>]:param comment_list::return:'''comment_dic = {}#print(comment_list)for comment_obj in comment_list: #每一个元素都是一个对象if comment_obj.parent_comment is None: #如果没有父亲comment_dic[comment_obj] = {}else:#通过递归找            tree_search(comment_dic,comment_obj)# #测试:# for k,v in comment_dic.items():#     print(k,v)# 上面完成之后开始递归拼接字符串

2、3生成html标签

#!/usr/bin/env python
# -*- coding:utf-8 -*-from django import template
from django.utils.safestring import mark_saferegister = template.Library()def tree_search(d_dic,comment_obj):#这里不用传附近和儿子了因为他是一个对象,可以直接找到父亲和儿子for k,v_dic in d_dic.items():if k == comment_obj.parent_comment:#如果找到了d_dic[k][comment_obj] = {} #如果找到父亲了,你的把自己存放在父亲下面,并把自己当做key,value为一个空字典returnelse:#如果找不到递归查找            tree_search(d_dic[k],comment_obj)def generate_comment_html(sub_comment_dic):#先创建一个html默认为空html = ""for k,v_dic in sub_comment_dic.items():#循环穿过来的字典html += "<div  class='comment-node'>"  + k.comment + "</div>"#上面的只是把第一层加了他可能还有儿子,所以通过递归继续加if v_dic:html += generate_comment_html(v_dic)return html@register.simple_tag
def build_comment_tree(comment_list):'''把评论传过来只是一个列表格式(如下),要把列别转换为字典,在把字典拼接为html[<Comment: <A,user:罗天帅>>, <Comment: <A2-1,user:罗天帅>>, <Comment: <A3-1,user:罗天帅>>, <Comment: <A2-2,user:罗天帅>>,<Comment: <A4-1,user:罗天帅>>, <Comment: <A4-2,user:罗天帅>>, <Comment: <A5-1,user:罗天帅>>, <Comment: <A3-2,user:罗天帅>>,<Comment: <B2,user:罗天帅>>, <Comment: <B2-1,user:罗天帅>>]:param comment_list::return:'''comment_dic = {}#print(comment_list)for comment_obj in comment_list: #每一个元素都是一个对象if comment_obj.parent_comment is None: #如果没有父亲comment_dic[comment_obj] = {}else:#通过递归找            tree_search(comment_dic,comment_obj)# #测试:# for k,v in comment_dic.items():#     print(k,v)# 上面完成之后开始递归拼接字符串#div框架html = "<div class='comment-box'>"margin_left = 0for k,v in comment_dic.items():#第一层的htmlhtml += "<div class='comment-node'>" + k.comment + "</div>"#通过递归把他儿子加上html += generate_comment_html(v)html += "</div>"return mark_safe(html)

效果如下：

2.4、上面的看起来不是很好看怎么办？给他增加一个margin-left让他来显示层级效果，每次进行递归的时候给他加一个值！

#!/usr/bin/env python
# -*- coding:utf-8 -*-from django import template
from django.utils.safestring import mark_saferegister = template.Library()def tree_search(d_dic,comment_obj):#这里不用传附近和儿子了因为他是一个对象,可以直接找到父亲和儿子for k,v_dic in d_dic.items():if k == comment_obj.parent_comment:#如果找到了d_dic[k][comment_obj] = {} #如果找到父亲了,你的把自己存放在父亲下面,并把自己当做key,value为一个空字典returnelse:#如果找不到递归查找            tree_search(d_dic[k],comment_obj)def generate_comment_html(sub_comment_dic,margin_left_val):#先创建一个html默认为空html = ""for k,v_dic in sub_comment_dic.items():#循环穿过来的字典html += "<div style='margin-left:%spx'  class='comment-node'>" % margin_left_val + k.comment + "</div>"#上面的只是把第一层加了他可能还有儿子,所以通过递归继续加if v_dic:html += generate_comment_html(v_dic,margin_left_val+15)return html@register.simple_tag
def build_comment_tree(comment_list):'''把评论传过来只是一个列表格式(如下),要把列别转换为字典,在把字典拼接为html[<Comment: <A,user:罗天帅>>, <Comment: <A2-1,user:罗天帅>>, <Comment: <A3-1,user:罗天帅>>, <Comment: <A2-2,user:罗天帅>>,<Comment: <A4-1,user:罗天帅>>, <Comment: <A4-2,user:罗天帅>>, <Comment: <A5-1,user:罗天帅>>, <Comment: <A3-2,user:罗天帅>>,<Comment: <B2,user:罗天帅>>, <Comment: <B2-1,user:罗天帅>>]:param comment_list::return:'''comment_dic = {}#print(comment_list)for comment_obj in comment_list: #每一个元素都是一个对象if comment_obj.parent_comment is None: #如果没有父亲comment_dic[comment_obj] = {}else:#通过递归找            tree_search(comment_dic,comment_obj)# #测试:# for k,v in comment_dic.items():#     print(k,v)# 上面完成之后开始递归拼接字符串#div框架html = "<div class='comment-box'>"margin_left = 0for k,v in comment_dic.items():#第一层的htmlhtml += "<div class='comment-node'>" + k.comment + "</div>"#通过递归把他儿子加上html += generate_comment_html(v,margin_left+15)html += "</div>"return mark_safe(html)