Django Web开发【7】 投票与评论

  为了让用户更好的发现和共享bookmark,可以提供投票与评论功能。现在我们的主页还是一个很简单的欢迎页面,我们可以让用户在主页共享自己的bookmark,此外,用户还可以对主页的bookmark进行投票以及评论,最后创建一个页面,显示十条最受欢迎的bookmark。

  在主页分享Bookmarks

  当保存bookmark的时候,让用户选择是否要在主页进行分享,当bookmark被分享之后,用户就可以对它进行投票,此外,我们还将创建一个页面,显示十条最受欢迎的bookmark。

  实现这几个功能的步骤如下:

  • 创建一个数据模型,用来保存分享在主页的bookmark。
  • 修改bookmark提交表单,让用户能够选择是否在主页分享bookmark。
  • 修改主页,给bookmark添加投票按钮。
  • 创建投票的视图函数。

  SharedBookmark数据模型

  当bookmark在主页共享的时候,需要保存一下信息:

  • bookmark被分享的时间
  • bookmark的投票数
  • 投票给bookmark的用户信息。

  创建SharedBookmark数据模型,编辑bookmarks/models.py,添加如下代码:

class SharedBookmark(models.Model):
  bookmark = models.ForeignKey(Bookmark, unique=True)
  date = models.DateTimeField(auto_now_add=True)
  votes = models.IntegerField(default=1)
  users_voted = models.ManyToManyField(User)
  def __str__(self):
    return '%s, %s' % self.bookmark, self.votes

  bookmark字段类型为外键类型,并且具有唯一性,因为同一个bookmark只能被分享一次。date的字段类型为models.DateTimeField,可以用来保存日期时间类型,参数auto_now_add告诉Django将这个字段的值设为当前的日期或时间。vote字段类型为models.IntegerField,默认值为1。user_voted使用多对多字段类型。

  编辑完之后,不要忘记执行下面的命令:

$ python manage.py syncdb

  修改Bookmark提交表单

  在bookmark提交表单中放置一个复选框,如果选中,则分享到主页。编辑bookmarks/forms.py中的BookmarkSaveForm:

class BookmarkSaveForm(forms.Form):
  url = forms.URLField(
    label='URL',
    widget=forms.TextInput(attrs={'size': 64})
  )
  title = forms.CharField(
    label='Title',
    widget=forms.TextInput(attrs={'size': 64})
  )
  tags = forms.CharField(
    label='Tags',
    required=False,
    widget=forms.TextInput(attrs={'size': 64})
  )
  share = forms.BooleanField(
    label='Share on the main page',
    required=False
  )

  给BookmarkForm添加share字段,字段类型为BooleanField,它会被渲染为复选框。

  修改bookmarks/views.py,添加如下高亮部分代码:

def _bookmark_save(request, form):
  # Create or get link.
  link, dummy = Link.objects.get_or_create(
    url=form.cleaned_data['url']
  )
  # Create or get bookmark.
  bookmark, created = Bookmark.objects.get_or_create(
    user=request.user,
    link=link
  )
  # Update bookmark title.
  bookmark.title = form.cleaned_data['title']
  # If the bookmark is being updated, clear old tag list.
  if not created:
    bookmark.tag_set.clear()
  # Create new tag list.
  tag_names = form.cleaned_data['tags'].split()
  for tag_name in tag_names:
    tag, dummy = Tag.objects.get_or_create(name=tag_name)
    bookmark.tag_set.add(tag)
  # Share on the main page if requested.
  if form.cleaned_data['share']:
    shared_bookmark, created = SharedBookmark.objects.get_or_create(
      bookmark=bookmark
    )
    if created:
      shared_bookmark.users_voted.add(request.user)
      shared_bookmark.save()
  # Save bookmark to database and return it.
  bookmark.save()
  return bookmark

  如果用户选择分享bookmark,我们就使用get_or_create来检查这个bookmark是否已经保存到SharedBookmark当中,如果没有,则新建,如果是新建的,就将当前用户保存到给这个bookmark投票的用户列表中。

  查看和投票

  现在我们已经创建了SharedBookmark数据模型,那么获取最受欢迎的bookmark列表也就很简单了。首先编辑bookmarks/views.py中的main_page视图:

def main_page(request):
  shared_bookmarks = SharedBookmark.objects.order_by(
    '-date'
  )[:10]
  variables = RequestContext(request, {
    'shared_bookmarks': shared_bookmarks
  })
  return render_to_response('main_page.html', variables)

  使用order_by方法可以对查询到的结果进行排序。

  接下来需要修改主页模板,以便显示分享的bookmark。我们之前都是使用bookmark_list.html来展示bookmarks,但是分享的bookmark

与普通的bookmark并不同,所以我们需要单独编写一个模板。创建templates/shared_bookmark_list.html。

{% if shared_bookmarks %}
  <ul class="bookmarks">
  {% for shared_bookmark in shared_bookmarks %}
    <li>
      <a href="{{ shared_bookmark.bookmark.link.url }}" class="title">
      {{ shared_bookmark.bookmark.title|escape }}</a>
      <br />
      Posted By:
      <a href="/user/{{ shared_bookmark.bookmark.user.username }}/" class="username">
      {{ shared_bookmark.bookmark.user.username }}</a> |
      <span class="vote-count">Votes:
      {{ shared_bookmark.votes }}</span>
    </li>
  {% endfor %}
  </ul>
{% else %}
  <p>No bookmarks found.</p>
{% endif %}

  创建完shared_bookmark_list.html,再在main_page.html中包含这个模板:

{% extends "base.html" %}
{% block title %}Welcome to Django Bookmarks{% endblock %}
{% block head %}Welcome to Django Bookmarks{% endblock %}
{% block content %}
  {% if user.username %}
    <p>Welcome {{ user.username }}!
    Here you can store and share bookmarks!</p>
  {% else %}
    <p>Welcome anonymous user!
    You need to <a href="/login/">login</a>
    before you can store and share bookmarks.</p>
  {% endif %}
  <h2>Bookmarks Shared by Users</h2>
  {% include 'shared_bookmark_list.html' %}
{% endblock %}

  修改完之后,就可以看到新的主页视图了,但是投票功能还不可用。

  接下来编辑urls.py,添加下面的url:

urlpatterns = patterns('',
  # Account management
  (r'^save/$', bookmark_save_page),
  (r'^vote/$', bookmark_vote_page),
)

  然后编辑bookmarks/views.py,添加如下代码:

@login_required
def bookmark_vote_page(request):
  if request.GET.has_key('id'):
    try:
      id = request.GET['id']
      shared_bookmark = SharedBookmark.objects.get(id=id)
      user_voted = shared_bookmark.users_voted.filter(
        username=request.user.username
      )
      if not user_voted:
        shared_bookmark.votes += 1
        shared_bookmark.users_voted.add(request.user)
        shared_bookmark.save()
    except ObjectDoesNotExist:
      raise Http404('Bookmark not found.')
  if request.META.has_key('HTTP_REFERER'):
    return HttpResponseRedirect(request.META['HTTP_REFERER'])
  return HttpResponseRedirect('/')

  给视图函数添加@login_required修饰器,因为只有已登录用户才可以进行投票。

  如果顺序执行,最后将重定向至用户投票之前显示的页面,这是通过HTTP头部HTTP_REFERER来实现的。当用户单击链接时,会发送当前页面的URL到服务器。HTTP头部都保存在request.META中。有些浏览器不支持这个头部,所以先检查是否含有这个头部,如果没有则返回主页。

  现在投票的视图函数已经实现了,只需要在主页中添加投票链接就可以了。编辑shared_bookmark_list.html:

{% if shared_bookmarks %}
  <ul class="bookmarks">
    {% for shared_bookmark in shared_bookmarks %}
      <li>
        <a href="/vote/?id={{ shared_bookmark.id }}" class="vote">[+]</a>
        <a href="{{ shared_bookmark.bookmark.link.url }}" class="title">
        {{ shared_bookmark.bookmark.title|escape }}</a>
        <br />
        Posted By:
        <a href="/user/{{ shared_bookmark.bookmark.user.username }}/" class="username">
        {{ shared_bookmark.bookmark.user.username }}</a> |
        <span class="vote-count">Votes:
        {{ shared_bookmark.votes }}</span>
      </li>
    {% endfor %}
  </ul>
{% else %}
  <p>No bookmarks found.</p>
{% endif %}

  这样,整个功能就完成了。

  统计页面

  实现一个统计页面,显示十条最受欢迎的bookmarks。通过投票数进行排序,但是只显示最后一天最受欢迎的bookmark。

  首先创建视图函数popular_page,编辑bookmarks/views.py:

from datetime import datetime, timedelta
def popular_page(request):
  today = datetime.today()
  yesterday = today - timedelta(1)
  shared_bookmarks = SharedBookmark.objects.filter(
    date__gt=yesterday
  )
  shared_bookmarks = shared_bookmarks.order_by(
    '-votes'
  )[:10]
  variables = RequestContext(request, {
    'shared_bookmarks': shared_bookmarks
  })
  return render_to_response('popular_page.html', variables)

  这个视图比main_page更加复杂。timedelta对象代表两个时间之间的时间差。

  创建templates/popular_page.html:

{% extends "base.html" %}
{% block title %}Popular Bookmarks{% endblock %}
{% block head %}Popular Bookmarks{% endblock %}
{% block content %}
{% include 'shared_bookmark_list.html' %}
{% endblock %}

  这个模板相当简单直接。接着再添加一个url:

urlpatterns = patterns('',
  # Browsing
  (r'^$', main_page),
  (r'^popular/$', popular_page),
  (r'^user/(\w+)/$', user_page),
  (r'^tag/([^\s]+)/$', tag_page),
  (r'^tag/$', tag_cloud_page),
  (r'^search/$', search_page),
)

  最后给导航菜单中添加popular导航链接:

[...]
<div id="nav">
  <a href="/">home</a> |
  <a href="/popular/">popular</a> |
  {% if user.is_authenticated %}
    <a href="/save/">submit</a> |
    <a href="/search/">search</a> |
    <a href="/user/{{ user.username }}/">
      {{ user.username }}</a> |
    <a href="/logout/">logout</a>
  {% else %}
    <a href="/login/">login</a> |
    <a href="/register/">register</a>
  {% endif %}
</div>
[...]

  现在用户就可以查看最受欢迎的bookmarks了。

  对bookmarks进行评论

  实现评论功能包含以下步骤:

  • 安装comments应用,然后创建相应数据表
  • 使用comments库提供的模板标签展示评论信息
  • 创建评论提交表单以及成功页面。

  安装comments库

  Django自身提供了评论功能,它包含在django.contrib.comments中,激活它需要进行下面操作,编辑settings.py:

INSTALLED_APPS = (
  'django.contrib.auth',
  'django.contrib.contenttypes',
  'django.contrib.sessions',
  'django.contrib.sites',
  'django.contrib.comments',
  'django_bookmarks.bookmarks'
)

  然后执行下面命令创建数据表:

$ python manage.py syncdb

  接着在url.py中添加相应url:

urlpatterns = patterns('',
  # Comments
  (r'^comments/', include('django.contrib.comments.urls.comments')),
)

  这里使用include将comments库中的URL定义包含进来。

  为评论创建视图函数

  这个视图函数使用分享的bookmark ID作为参数,然后展示分享的bookmark,它的评论以及提交新评论的表单。首先添加url,编辑urls.py:

urlpatterns = patterns('',
  # Browsing
  (r'^$', main_page),
  (r'^popular/$', popular_page),
  (r'^user/(\w+)/$', user_page),
  (r'^tag/([^\s]+)/$', tag_page),
  (r'^tag/$', tag_cloud_page),
  (r'^search/$', search_page),
  (r'^bookmark/(\d+)/$', bookmark_page),
)

  接着编辑bookmarks/views.py:

def bookmark_page(request, bookmark_id):
  shared_bookmark = get_object_or_404(
    SharedBookmark,
    id=bookmark_id
  )
  variables = RequestContext(request, {
    'shared_bookmark': shared_bookmark
  })
  return render_to_response('bookmark_page.html', variables)

  然后创建bookmark_page.html模板:

{% extends "base.html" %}
{% block title %}Bookmark:
  {{ shared_bookmark.bookmark.title|escape }}{% endblock %}
{% block head %}
  <a href="/vote/?id={{ shared_bookmark.id }}" class="vote">[+]</a>
  <a href="{{ shared_bookmark.bookmark.link.url }}" class="title">
  {{ shared_bookmark.bookmark.title|escape }}</a>
{% endblock %}
{% block content %}
  Posted By:
  <a href="/user/{{ shared_bookmark.bookmark.user.username }}/"
  class="username">
  {{ shared_bookmark.bookmark.user.username }}</a> |
  <span class="vote-count">Votes: {{ shared_bookmark.votes }}</span>
{% endblock %}

  展示评论详情与评论提交表单

  Django提供的comments是实现评论功能异常简单。comments提供了三个模板标签:

  • get_comments_count 返回当前页面中评论的数目
  • get_comment_list 返回当前页面中评论的列表
  • comment_form 评论提交表单

  默认情况下模板是不支持这些标签的,要激活它们,必须先使用下面这个标签:

{% load comments %}

  load标签通常用于激活自定义的模板标签。

  上面三个标签都需要提供以下参数:

  • 接受评论的对象类型,格式如下:application.model(全部小写)。
  • 接受评论的对象ID。

  所以如果你想获取指定分享的bookmark的评论数,需要使用下面的代码:

{% get_comment_count for bookmarks.sharedbookmark shared_bookmark.id as comment_count %}

  现在模板变量comment_count的值就是当前分享的bookmark所具有的评论数。

  同样的,为了获取当前bookmark的评论数,需要使用以下代码:

{% get_comment_list for bookmarks.sharedbookmark shared_bookmark.id as comment_list %}

  现在模板变量comment_list包含了当前页面中所有评论组成的列表,每个评论具有以下属性:

  • user 进行评论的用户对象
  • submit_date 提交评论的日期
  • comment 评论内容
  • ip_address 提交评论的IP地址

  最后,展示评论提交表单:

{% comment_form for bookmarks.sharedbookmark shared_bookmark.id %}

  将上面的代码应用到templates/bookmark_page.html中:

{% extends "base.html" %}
{% load comments %}
{% block title %}Bookmark:
  {{ shared_bookmark.bookmark.title|escape }}{% endblock %}
{% block head %}
  <a href="/vote/?id={{ shared_bookmark.id }}" class="vote">[+]</a>
  <a href="{{ shared_bookmark.bookmark.link.url }}" class="title">
  {{ shared_bookmark.bookmark.title|escape }}</a>
{% endblock %}
{% block content %}
  Posted By:
  <a href="/user/{{ shared_bookmark.bookmark.user.username }}/" class="username">
  {{ shared_bookmark.bookmark.user.username }}</a> |
  <span class="vote-count">Votes: {{ shared_bookmark.votes }}</span>
  <h2>Comments</h2>
  {% get_comment_count for bookmarks.sharedbookmark shared_bookmark.id as comment_count %}
  {% get_comment_list for bookmarks.sharedbookmark shared_bookmark.id as comment_list %}
  {% for comment in comment_list %}
    <div class="comment">
      <p><b>{{ comment.user.username }}</b> said:</p>
      {{ comment.comment|escape|urlizetrunc:40|linebreaks }}
    </div>
  {% endfor %}
  <p>Number of comments: {{ comment_count }}</p>
  {% comment_form for bookmarks.sharedbookmark shared_bookmark.id %}
{% endblock %}

  上面使用了一些新的过滤器:

  • escape 转义,将HTML标签转义成HTML实体。
  • urlizetrunc 将URL转换成链接
  • linebreaks 将行转换成<p>与<br/>

  创建评论模板

  django的模板库要求我们提供两个模板,一个是评论提交表单,另一个是成功提交之后的页面。这些模板应该位于templates/comments/中。

  首先创建评论提交表单,在templates/comments/中创建form.html:

{% if user.is_authenticated %}
  <form action="/comments/post/" method="post">
    <p><label>Post a comment:</label><br />
    <textarea name="comment" rows="10" cols="60"></textarea></p>
    <input type="hidden" name="options" value="{{ options }}" />
    <input type="hidden" name="target" value="{{ target }}" />
    <input type="hidden" name="gonzo" value="{{ hash }}" />
    <input type="submit" name="post" value="submit comment" />
  </form>
{% else %}
  <p>Please <a href="/login/">log in</a> to post comments.</p>
{% endif %}

  如果用户已经登录,则展示评论提交评论,如果没登录,则显示登录链接。表单中action以及字段的值都是从comments库的文档中获取的。

  接下来,创建成功评论之后显示的模板,这个模板中包含一个object对象,指代接受评论的对象,最好是在页面中提供返回分享的bookmark页面,所以在templates/comments/中创建posted.html。

{% extends "base.html" %}
{% block title %}Comment Posted Successfully{% endblock %}
{% block head %}Comment Posted Successfully{% endblock %}
{% block content %}
  <p>Thank you for contributing.</p>
  {% if object %}
    <p><a href="/bookmark/{{ object.id }}/">
    View your comment</a></p>
  {% endif %}
{% endblock %}

  现在,我们就实现了评论功能,但是还需要给评论页面添加链接,编辑templates/shared_bookmark_list.html:

{% if shared_bookmarks %}
  <ul class="bookmarks">
    {% for shared_bookmark in shared_bookmarks %}
      <li>
      <a href="/vote/?id={{ shared_bookmark.id }}" class="vote">[+]</a>
      <a href="{{ shared_bookmark.bookmark.link.url }}" class="title">
      {{ shared_bookmark.bookmark.title|escape }}</a>
      <br />
      Posted By:
      <a href="/user/{{ shared_bookmark.bookmark.user.username }}/" class="username">
      {{ shared_bookmark.bookmark.user.username }}</a> |
      <span class="vote-count">Votes:
      {{ shared_bookmark.votes }}</span> |
      <a href="/bookmark/{{ shared_bookmark.id}}/">Comments</a>
      </li>
    {% endfor %}
  </ul>
{% else %}
  <p>No bookmarks found.</p>
{% endif %}

  最后,给评论添加样式,编辑/static/style.css:

.comment {
  margin: 1em;
  padding: 5px;
  border: 1px solid #000;
}

  现在就可以查看我们刚刚实现的评论功能了。

  

上一篇:Luogu P2455 [SDOI2006]线性方程组 真•高斯消元板子


下一篇:centos 7.1系统更改Mariadb数据存储位置步骤分享