[1.0.X] Fixed #9268: pass the "next" param through in the comment pre…

…view/post view. Also updated the docs to make this a bit clearer. Backport of r10418 from trunk.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.0.X@10419 bcc190cf-cafb-0310-a4f2-bffc1f526a37

django/contrib/comments/templates/comments/form.html

@@ -1,5 +1,6 @@
 {% load comments i18n %}
 <form action="{% comment_form_target %}" method="post">
+  {% if next %}<input type="hidden" name="next" value="{{ next }}" />{% endif %}
   {% for field in form %}
     {% if field.is_hidden %}
       {{ field }}

django/contrib/comments/templates/comments/preview.html

@@ -6,6 +6,7 @@
 {% block content %}
   {% load comments %}
   <form action="{% comment_form_target %}" method="post">
+    {% if next %}<input type="hidden" name="next" value="{{ next }}" />{% endif %}
     {% if form.errors %}
     <h1>{% blocktrans count form.errors|length as counter %}Please correct the error below{% plural %}Please correct the errors below{% endblocktrans %}</h1>
     {% else %}

django/contrib/comments/views/comments.py

@@ -80,6 +80,7 @@ def post_comment(request, next=None):
             template_list, {
                 "comment" : form.data.get("comment", ""),
                 "form" : form,
+                "next": next,
             },
             RequestContext(request, {})
         )

docs/ref/contrib/comments/index.txt

@@ -42,7 +42,7 @@ To get started using the ``comments`` app, follow these steps:
     #. Use the `comment template tags`_ below to embed comments in your
        templates.
 
-You might also want to examine the :ref:`ref-contrib-comments-settings`
+You might also want to examine :ref:`ref-contrib-comments-settings`.
 
 Comment template tags
 =====================
@@ -166,7 +166,7 @@ A complete form might look like::
     </form>
 
 Be sure to read the `notes on the comment form`_, below, for some special
-considerations you'll need to make if you're using this aproach.
+considerations you'll need to make if you're using this approach.
 
 .. templatetag:: comment_form_target
 
@@ -180,6 +180,16 @@ you'll always want to use it like above::
 
     <form action="{% comment_form_target %}" method="POST">
 
+Redirecting after the comment post
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To specify the URL you want to redirect to after the comment has been posted,
+you can include a hidden form input called ``next`` in your comment form. For example::
+
+    <input type="hidden" name="next" value="{% url my_comment_was_posted %}" />
+
+.. _notes-on-the-comment-form:
+
 Notes on the comment form
 -------------------------