Pages:Custom Forms - Revision history

Root: /* EXAMPLES */ added fieldValidations example

2010-05-25T14:58:18Z

‎EXAMPLES: added fieldValidations example

2009-04-30T14:56:11Z

‎OPTIONAL HIDDEN FIELDS

2009-04-30T14:55:05Z

‎OPTIONAL HIDDEN FIELDS

2009-04-28T14:53:16Z

2009-04-28T14:52:34Z

addded fieldValidations

2008-10-31T20:42:42Z

2008-10-31T20:40:05Z

2008-10-31T20:34:03Z

2008-10-31T20:27:46Z

2008-10-31T20:26:56Z

@@ Line 133: / Line 133: @@
-Catalog Request Example:
+Catalog Request Example (With field validations):
 <source lang="HTML4strict">
@@ Line 142: / Line 142: @@
 <input type="hidden" name="fa" value="USER.formSubmit">
 <input type="hidden" name="redirect" value="index.php?pageId=456&message=You will receive a copy of our catalog shortly">
 <!-- a shipping form will contain custom fields here -->

@@ Line 13: / Line 13: @@
 ===OPTIONAL HIDDEN FIELDS===
 ;fieldValidations:  Use to require certain fields. Comma delimited list of required fields, commands and messages. Example: "firstName/min:1:Must enter first name,zipCode/min:5:You must enter a 5 digit zip code,emailAddress/email:Must enter a valid email address" sets firstName to require min length 1 character, zipCode to require min length of 5 characters and emailAddress to be a valid email address.
-;;Each field validation should follow the format: /command:attributes:error message. Available validations are:
+::Each field validation should follow the format: /command:attributes:error message. Available validations are:
-;;*min: specified a minimum number of characters. Example "firstName/min:1:You must enter a first name".
+::*min: specified a minimum number of characters. Example "firstName/min:1:You must enter a first name".
-;;*email: validates entry is formatted like an email address: Example "emailAddress/email:You must enter a valid email address".
+::*email: validates entry is formatted like an email address: Example "emailAddress/email:You must enter a valid email address".
 ===CORE FIELDS===

@@ Line 13: / Line 13: @@
 ===OPTIONAL HIDDEN FIELDS===
 ;fieldValidations:  Use to require certain fields. Comma delimited list of required fields, commands and messages. Example: "firstName/min:1:Must enter first name,zipCode/min:5:You must enter a 5 digit zip code,emailAddress/email:Must enter a valid email address" sets firstName to require min length 1 character, zipCode to require min length of 5 characters and emailAddress to be a valid email address.
 ===CORE FIELDS===

@@ Line 10: / Line 10: @@
 ;redirect: The URL where the visitor should be directed to following submission of the form. For each custom form it is recommended you create an accompanying page that will display a thank you or confirmation message. This page should be where the visitor is directed to using the 'redirect' field following form submission.
 ;otherFields: A comma delimited list of custom field names. Leave empty if no custom fields are being used.
 ;fieldValidations:  Use to require certain fields. Comma delimited list of required fields, commands and messages. Example: "firstName/min:1:Must enter first name,zipCode/min:5:You must enter a 5 digit zip code,emailAddress/email:Must enter a valid email address" sets firstName to require min length 1 character, zipCode to require min length of 5 characters and emailAddress to be a valid email address.

@@ Line 10: / Line 10: @@
 ;redirect: The URL where the visitor should be directed to following submission of the form. For each custom form it is recommended you create an accompanying page that will display a thank you or confirmation message. This page should be where the visitor is directed to using the 'redirect' field following form submission.
 ;otherFields: A comma delimited list of custom field names. Leave empty if no custom fields are being used.
 ===CORE FIELDS===
@@ Line 17: / Line 18: @@
 ;emailAddress: A text field with a maxlength of 255
 ;subscribe: A checkbox with a value of 1 (if checked, this will pass and trigger the newsletter registration process for the entered emailAddress)
 ===CUSTOM FIELDS===

@@ Line 136: / Line 136: @@
 <input type="hidden" name="redirect" value="index.php?pageId=456&message=You will receive a copy of our catalog shortly">
-<input type="hidden" name="otherFields" value="street1,street2,city,state,zip" />
+<!-- a shipping form will contain custom fields here -->
 <h1>Order a Catalog</h1>
@@ Line 145: / Line 146: @@
 <br>I would like to receive occassional emails about specials and what-not: <input type="checkbox" name="subscribe" value="1">
 <br>
 <br>Address: <input type="text" name="street1" size=50>
 <br>Address Line 2: <input type="text" name="street2" size=50>
@@ Line 153: / Line 156: @@
 <option>... more states here ...</option>
 </select>
-<br>Zip: <input type="text" name="zipCode"
+<br>Zip: <input type="text" name="zipCode" size=10>
-<br /><input type="submit" value="SUBSCRIBE!" />
+<br /><input type="submit" value="ORDER!" />
 </form>
 </source>

@@ Line 136: / Line 136: @@
 <input type="hidden" name="redirect" value="index.php?pageId=456&message=You will receive a copy of our catalog shortly">
-<input type="hidden" name="otherFields" value="" />
+<input type="hidden" name="otherFields" value="street1,street2,city,state,zip" />
-<h1>Register for our newsletter!</h1>
+<h1>Order a Catalog</h1>
 <br>First Name: <input type="text" name="firstName" size=25 maxlength=50>
 <br>Last Name: <input type="text" name="lastName" size=25 maxlength=50>
 <br>Email Address: <input type="text" name="emailAddress" size=50 maxlength=255>
+<br>I would like to receive occassional emails about specials and what-not: <input type="checkbox" name="subscribe" value="1">
-<!-- notice the subscribe field is hidden here,
+<br>
-since it is assumed they want to subscribe
+<br>Address: <input type="text" name="street1" size=50>
-otherwise they would not be submitting this form -->
+<br>Address Line 2: <input type="text" name="street2" size=50>
-<input type="hidden" name="subscribe" value="1">
+<br>City: <input type="text" name="city" size=50>
 <br /><input type="submit" value="SUBSCRIBE!" />

@@ Line 23: / Line 23: @@
 ===EXAMPLES===
 <source lang="HTML4strict">
 <!-- start our form -->
@@ Line 48: / Line 47: @@
 <!-- the redirect field tells the website where to put the visitor after the form has been procesed -->
 <input type="hidden" name="redirect" value="index.php?pageId=123&message=Thank you for filling our our form">
 <!--------------------->
@@ Line 83: / Line 86: @@
 NO<input type="radio" name="likeItalian" value="0" />
-<!-- the following otherFields field is REQUIRED if you have ANY custom fields
+<!-- be sure all your custom field names are entered into the "otherFields" field
-enter a comman delim list of the field names -->
+see above REQUIRED HIDDEN FIELDS for details -->
-<input type="hidden" name="otherFields" value="source,color,likeItalian" />
 <!--- DONE WITH CUSTOM FIELDS ---->
@@ Line 92: / Line 94: @@
 <!-- close out the form -->
 </form>
 </source>