Fixed #9147 -- Added `FormPreview.process_preview` customization hook. Thanks, bthomas and thalin. (a9b2ac25) · Commits · Dom Sekotill / django

django/contrib/formtools/preview.py

+8 −0

Original line number	Diff line number	Diff line
		@@ -60,6 +60,7 @@ class FormPreview(object):
		f = self.form(request.POST, auto_id=AUTO_ID)
		context = {'form': f, 'stage_field': self.unused_name('stage'), 'state': self.state}
		if f.is_valid():
		self.process_preview(request, f, context)
		context['hash_field'] = self.unused_name('hash')
		context['hash_value'] = self.security_hash(request, f)
		return render_to_response(self.preview_template, context, context_instance=RequestContext(request))
		@@ -96,6 +97,13 @@ class FormPreview(object):
		"""
		pass

		def process_preview(self, request, form, context):
		"""
		Given a validated form, performs any extra processing before displaying
		the preview page, and saves any extra data in context.
		"""
		pass

		def security_hash(self, request, form):
		"""
		Calculates the security hash for the given HttpRequest and Form instances.

+13 −0

Original line number	Diff line number	Diff line
		@@ -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.

+2 −2

Original line number	Diff line number	Diff line
		@@ -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