How to use a Custom HTML Entry form in Woobox Campaigns

Last Updated: Apr 18, 2017 03:15PM PDT

Basic HTML Example for Entry Form

<form name="myform" action="">
Enter Email Address: 
<input 	type='text' 
   name='email' 
   rules='required' 
   error='You must enter an email address'/>
<input type='submit' name='submitbutton' value='Submit' />
</form>

The basic form above will collect email addresses from users. Let's take a look at the important elements.

1. The <FORM> tag

Your input form should start with:

<form name="myform" action="">

You'll notice the action parameter is empty. This tells the web browser to submit the form to the current page URL.

2. The <INPUT> tags

You can use whatever HTML input tags you want including SELECT and TEXTAREA. For more details about input tags please see this link. All input types are supported including file uploads. You can also use as many input fields as you like.

<input type='text' name='Email' rules='required' error='You must enter an email address'/>
  • name - name name is required (excepting placeholder fields). This will determine the name that is shown in error messages and in your input export file.
  • rules - rules is an optional parameter. Currently Woobox supports the required rule which allows you to require the submitted field is not empty.
  • error - error is an optional parameter. The message you put in the error parameter will be shown to the user when the rules are not met.

3. Submit button

<input type='submit' name='submitbutton' value='Submit' />

The submit button input type will allow users to submit your form.

4. Close </FORM>

</form>

Don't forget to close your form with a closing form tag.

Accessing User-Submitted Form Data

After you save your entry page form HTML, and the system detects input fields, the standard Woobox form will automatically be replaced with your custom form. All user input into your form will be saved in the export file that you can download for your campaign. The downloadable file is in CSV format and should import easily into your favorite spreadsheet software. You'll notice the top row contains the column names that correspond to your input field names.