How To... Add a Form to a Page
Add a form to your asset library, this can then be deployed to the page in two ways...
1. Make an html form
In an external application, build a conventional html form and copy the code of this form - but NOT the opening form tag.
2. Create a new form asset
Create a new form asset in the Asset library, give it a title, and open the Form Data section.
This section will be pre-populated with a form tag - paste your form code (minus the opening/closing form tag) between the existing code. This form tag has information in it that Pepperio requires to relate the form on the page with the form in the Assets. Removing or changing this tag will result in your form not working. The only exception is the 'action' attribute that you may want to point at your own form handler.
3. Configure the form asset
Configure the rest of the form. This includes...
Form Response - Here you can include a simple message that will be displayed when the form is submitted, alternatively, using javascript you can re-direct the User to success/confirmation page...
<script language="JavaScript">
document.location.href="/thank_you.html";
</script>
User mail - Mail that can be sent back to the submitter, can be used to confirm details submitted.
Backoffice Handler - Email sent to the recipient/site owner containing the details of the form. An invalid email address here will prevent the form from working probably.
Input Data Storage - Checking the box here enables you to save form data to an xml file on the server in addition to submission of an email.
External Data Access - Setting the checkbox in this section will allow access to the saved data through a unique url.
4. The 'Thank You' Page
Style the 'Thank you' page supplied in Pepperio to suit your site's design. This page should be stored where it will not be part of the site navigation, and don't forget to add navigation controls to back into the site.
5. Apply the Form to the page
There are two methods available for inserting a form to a page;
1. It can be added through 'insert form' icon on the menu bar of the component Text Editor. This editor is offered when the snippet behind the content is using a TEXT tag.
2. If you use a FORM tag then the component editor will offer two options; replace and delete. Note that this is the only method that will dynamically link the form in the page to the form in the Assets library. With the first method (using a TEXT tag) any further changes to the form in the Assets library will not be reflected in the form on the page.
