Browse files

Added an example of using a form wizard with different templates; tha…

…nks Lorin Hochstein for the patch.
  • Loading branch information...
1 parent e5f8fe2 commit 553583958d907de09c2b87788ec7454c1bde7d1c @timgraham timgraham committed Sep 15, 2012
Showing with 61 additions and 1 deletion.
  1. +61 −1 docs/ref/contrib/formtools/form-wizard.txt
@@ -155,7 +155,8 @@ or the
method, which are documented in the
:class:`~django.views.generic.base.TemplateResponseMixin` documentation. The
-latter one allows you to use a different template for each form.
+latter one allows you to use a different template for each form (:ref:`see the
+example below <wizard-template-for-each-form>`).
This template expects a ``wizard`` object that has various items attached to
@@ -238,6 +239,65 @@ wizard's :meth:`as_view` method takes a list of your
(r'^contact/$', ContactWizard.as_view([ContactForm1, ContactForm2])),
+.. _wizard-template-for-each-form:
+Using a different template for each form
+As mentioned above, you may specify a different template for each form.
+Consider an example using a form wizard to implement a multi-step checkout
+process for an online store. In the first step, the user specifies a billing
+and shipping address. In the second step, the user chooses payment type. If
+they chose to pay by credit card, they will enter credit card information in
+the next step. In the final step, they will confirm the purchase.
+Here's what the view code might look like::
+ from django.http import HttpResponseRedirect
+ from django.contrib.formtools.wizard.views import SessionWizardView
+ FORMS = [("address", myapp.forms.AddressForm),
+ ("paytype", myapp.forms.PaymentChoiceForm),
+ ("cc", myapp.forms.CreditCardForm),
+ ("confirmation", myapp.forms.OrderForm)]
+ TEMPLATES = {"address": "checkout/billingaddress.html",
+ "paytype": "checkout/paymentmethod.html",
+ "cc": "checkout/creditcard.html",
+ "confirmation": "checkout/confirmation.html"}
+ def pay_by_credit_card(wizard):
+ """Return true if user opts to pay by credit card"""
+ # Get cleaned data from payment step
+ cleaned_data = wizard.get_cleaned_data_for_step('paytype') or {'method': 'none'}
+ # Return true if the user selected credit card
+ return cleaned_data['method'] == 'cc'
+ class OrderWizard(SessionWizardView):
+ def get_template_names(self):
+ return [TEMPLATES[self.steps.current]]
+ def done(self, form_list, **kwargs):
+ do_something_with_the_form_data(form_list)
+ return HttpResponseRedirect('/page-to-redirect-to-when-done/')
+ ...
+The ```` file would contain something like::
+ urlpatterns = patterns('',
+ (r'^checkout/$', OrderWizard.as_view(FORMS, condition_dict={'cc': pay_by_credit_card})),
+ )
+Note that the ``OrderWizard`` object is initialized with a list of pairs.
+The first element in the pair is a string that corresponds to the name of the
+step and the second is the form class.
+In this example, the
+method returns a list containing a single template, which is selected based on
+the name of the current step.
.. _wizardview-advanced-methods:
Advanced ``WizardView`` methods

0 comments on commit 5535839

Please sign in to comment.