Fixed #9147 -- Added `FormPreview.process_preview` customization hook. Thanks, bthomas and thalin.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@12486 bcc190cf-cafb-0310-a4f2-bffc1f526a37

2 files changed, 15 insertions, 2 deletions

diff --git a/docs/ref/contrib/formtools/form-preview.txt b/docs/ref/contrib/formtools/form-preview.txt
index f786b74305..ece69067ee 100644
--- a/docs/ref/contrib/formtools/form-preview.txt
+++ b/docs/ref/contrib/formtools/form-preview.txt
@@ -108,3 +108,16 @@ These values can be overridden for a particular form preview by setting
 :attr:`~django.contrib.formtools.FormPreview.form_template` attributes on the
 FormPreview subclass. See :file:`django/contrib/formtools/templates` for the
 default templates.
+
+Advanced ``FormPreview`` methods
+================================
+
+.. versionadded:: 1.2
+
+.. method:: FormPreview.process_preview
+
+    Given a validated form, performs any extra processing before displaying the
+    preview page, and saves any extra data in context.
+
+    By default, this method is empty.  It is called after the form is validated,
+    but before the context is modified with hash information and rendered.
diff --git a/docs/ref/contrib/formtools/form-wizard.txt b/docs/ref/contrib/formtools/form-wizard.txt
index 0449bb9cd0..5ef862ce3d 100644
--- a/docs/ref/contrib/formtools/form-wizard.txt
+++ b/docs/ref/contrib/formtools/form-wizard.txt
@@ -199,8 +199,8 @@ wizard takes a list of your :class:`~django.forms.Form` objects as arguments::
         (r'^contact/$', ContactWizard([ContactForm1, ContactForm2])),
     )
 
-Advanced FormWizard methods
-===========================
+Advanced ``FormWizard`` methods
+===============================
 
 .. class:: FormWizard