Latest

+ Advanced Search

Multi-Step Submission Templates

Multi-Step Submission Templates
By
10:09:2011 (Edited )

Sometimes, you may want to break the long submission page (let's assume "submit listing" for example) into multiple steps. As of version 6.2.6, you can make custom templates for each additional step.

Go to the template editor at Admin Panel -> Themes -> Manage Templates. In the regular submit listing template, find the submit button HTML -- in a multilingual install it'll be

<button type="submit" name="processform" value="1" class="btn btn-lg btn-primary submitbutton">{LANG_GENERAL_SUBMIT}</button>
, in an english-only install the {LANG_GENERAL_SUBMIT} will be replaced with "Submit". Change this button to
<button type="submit" name="step" value="yourstep2" class="submitbutton">Continue to step 2</button>
.

After saving that, find the create a custom template area toward the bottom of the template editor page. There, create a custom template named yourstep2template (or whatever name you put in step 2 button value). Copy the contents of the submit listing template into there and remove all parts you don't want to be on the step 2 page (and remove everything from the submit listing template that you don't want to have on the step 1 page).

You can create a step 3 simply by using
<button type="submit" name="step" value="yourstep3" class="submitbutton">Continue to step 3</button>
as the submit button html of step 2. For the final page, the submit button will be the original code but you'll need to modify the preview button to specify the template of your final submit page... if that's submitstep2.tpl, use
<button type="submit" name="processform" value="1" class="submitbutton">Submit</button>
<button type="submit" name="preview" value="submitstep2" class="previewbutton">Preview</button>


To present a button which when pushed will take the user to a previous step, use
<button type="submit" name="step" value="suggestlink" class="submitbutton">Back to step 1</button>

Replace suggestlink with the appropriate step's template if it's not going back to the first step.

Warning: The CAPTCHA/challenge, WYSIWYG description and any file uploads have to be on the final step of the submission in order to work.

To do this with the field manager system, you can use template conditionals to for example exclude all but one field from the first page and exclude that one field from the second page. You'd put <IF {FIELDNAME} is type> right after <!-- BEGIN SUBMIT FIELD --> and </IF> right before <!-- END SUBMIT FIELD --> to make only the type field show, for example. If you want a field to appear outside of the table, you can use {LINKFIELDINPUTHTML[fieldname]} to call it in, e.g. {LINKFIELDINPUTHTML[type]}.





Description Splitting a submission into several pages of data connection.
Rating
Views 1724 views. Averaging 1724 views per day.
Similar Listings