| Both sides previous revisionPrevious revisionNext revision | Previous revision | 
| doc:dev:form:form_to_email_cgi [2014/06/20 12:08]  –  vikki | doc:dev:form:form_to_email_cgi [2015/01/16 15:24] (current)  – external edit 127.0.0.1 | 
|---|
 |  | 
| ^Field Name	^Detail^ | ^Field Name	^Detail^ | 
| |_formFrom	|{{:doc:dev:form:formfrom.png?nolink|}} |Show in the FROM: section of the email|  | |_formFrom	|Show in the FROM: section of the email|  | 
| |_formSubject	|{{:doc:dev:form:formsubject.png?nolink|}}|Subject of email: The date & time stamp [datetime] will be replaced with the form submission date and time. [formRef] is a unique number genereted for the email, good for tracking use|  | |_formSubject	|Subject of email: The date & time stamp [datetime] will be replaced with the form submission date and time.\\ [formRef] is a unique number genereted for the email, good for tracking use|  | 
| |_formTo	|{{:doc:dev:form:formto.png?nolink|}}|Email for this form to send to. You can turn this to hidden field if you are sending this form to a permanent address. Separate each email with ","|  | |_formTo	|Email for this form to send to.\\ You can turn this to hidden field if you are sending this form to a permanent address.\\ Separate each email with ","|  | 
| |_formOutputTemplate (new)|{{:doc:dev:form:formoutputtemplate.png?nolink|}}|The field/value format in email. By default, this is set to:\\ [<field>]<br><value><br><br>\\ You can change the format easily to:\\ <field>: <value><br><br>\\ If you would like to have the field name and value stay in one line.\\ Note that only 3 keywords are supported: <field>, <value> and <br>|  | |_formOutputTemplate (new)|The field/value format in email. By default, this is set to:\\ [<field>]<br><value><br><br>\\ You can change the format easily to:\\ <field>: <value><br><br>\\ If you would like to have the field name and value stay in one line.\\ Note that only 3 keywords are supported: <field>, <value> and <br>|  | 
| |_formOutputTemplate_header (new)	|{{:doc:dev:form:formoutputtemplate_header.png?nolink|}}|The text to insert at the beginning of the email|  | |_formOutputTemplate_header (new)	|The text to insert at the beginning of the email|  | 
| |_formOutputTemplate_footer (new)	|{{:doc:dev:form:formoutputtemplate_footer.png?nolink|}}|The text to insert at the end of the email|  | |_formOutputTemplate_footer (new)	|The text to insert at the end of the email|  | 
| |_form_contenttype (new)	|{{:doc:dev:form:form_contenttype.png?nolink|}}|The MIME email content type. "text" or "html" allow, default "text". Good to set it to "html" if you have formated the form format to html|  | |_form_contenttype (new)	|The MIME email content type. "text" or "html" allow, default "text".\\ Good to set it to "html" if you have formated the form format to html|  | 
| |_formNext	|{{:doc:dev:form:emptytextbox.png?nolink|}}|Where do you want to go after this form submitted.\\ After a successful post, where do you want to bring the user to next? Specify the URL here (eg: http://www.mysite.com)\\ Skip this if you wish to use the default|  | |_formNext	|Where do you want to go after this form submitted.\\ After a successful post, where do you want to bring the user to next?\\ Specify the URL here (eg: http://www.mysite.com)\\ Skip this if you wish to use the default|  | 
| |_formErr	|{{:doc:dev:form:emptytextbox.png?nolink|}}|What do you want to show if this form has some incomplete entry (eg: http://www.mysite.com/error.htm)\\ Skip this if you wish to use internal error handling|  | |_formErr	|What do you want to show if this form has some incomplete entry (eg: http://www.mysite.com/error.htm)\\ Skip this if you wish to use internal error handling|  | 
| |_formCleanFieldName (new)|{{:doc:dev:form:checkbox-true.png?nolink|}}|Use in pair with mandatory field name. Don't show the tilt "~" in mandatory field name if checked. Eg: ~name will become name in email|  | |_formCleanFieldName (new)|Use in pair with mandatory field name.\\ Don't show the tilt "~" in mandatory field name if checked. Eg: ~name will become name in email|  | 
| |_formVoidNum (new)	|{{:doc:dev:form:checkbox-false.png?nolink|}}|{{:doc:dev:form:checkbox-true.png?nolink|}}|Don't show the number prefix in field name if checked, eg: 1,name will be shown as name in email| | |_formVoidNum (new)	|Don't show the number prefix in field name if checked, eg: 1,name will be shown as name in email| | 
| |_formAllField	|All field wanted; checked if you want the user to fill-up all the fields| | |_formAllField	|All field wanted; checked if you want the user to fill-up all the fields| | 
| |_form_custom_header (new)	|{{:doc:dev:form:emptytextbox.png?nolink|}}|The additional MIME header to insert into the email. Usually not require. Format in Key: Data (eg: To: online@domain.tld)|  | |_form_custom_header (new)	|The additional MIME header to insert into the email. Usually not require. Format in Key: Data (eg: To: online@domain.tld)|  | 
| |_formDateFormat (new)	|{{:doc:dev:form:emptytextbox.png?nolink|}}|The custom date format. Available: YYYY (4 digits year), YY (2 digits year), MM (2 digits month), M (single digit month), DD and D. All date format in upper case. Time format as hh, h, mm, m, s, ss (lower case). Eg: YYYY/MM/DD hh:mm:ss returns 2010/03/30 13:22:00|  | |_formDateFormat (new)	|The custom date format. Available: YYYY (4 digits year), YY (2 digits year), MM (2 digits month), M (single digit month), DD and D. All date format in upper case. Time format as hh, h, mm, m, s, ss (lower case). Eg: YYYY/MM/DD hh:mm:ss returns 2010/03/30 13:22:00|  | 
| |Mandatory field	|{{:doc:dev:form:mandatory_field.png?nolink|}}|User must fill in this field - or error warning will be given after submit. All mandatory fields start with a tilt "~". Set the _formCleanFieldName to checked if you would like the field name to be shown without the "~" in the email|  | |Mandatory field	|User must fill in this field - or error warning will be given after submit. All mandatory fields start with a tilt "~". Set the _formCleanFieldName to checked if you would like the field name to be shown without the "~" in the email|  | 
| |Custom field: prefix number order|{{:doc:dev:form:emptytextbox.png?nolink|}}\\ {{:doc:dev:form:emptytextbox.png?nolink|}}|Any field name starts with a number, seperates by a comma (",") from the rest of the field name (eg: 1,name or 20,address). Use these fields naming method to organize the sequence of the output. Smaller number always appear first in the email. Good to use this with _formVoidNum set to checked, where you can hide the number portion|  | |Custom field: prefix number order|Any field name starts with a number, seperates by a comma (",") from the rest of the field name (eg: 1,name or 20,address). Use these fields naming method to organize the sequence of the output. Smaller number always appear first in the email. Good to use this with _formVoidNum set to checked, where you can hide the number portion|  | 
| |Custom field	|{{:doc:dev:form:emptytextbox.png?nolink|}}|Any field you want|  | |Custom field	|Any field you want|  | 
| |Custom field: POP-up	|{{:doc:dev:form:pop-up.png?nolink|}}|Any pop-up field|  | |Custom field: POP-up	|Any pop-up field|  | 
| |Custom field: Multiple selections	|{{:doc:dev:form:multiple_selections.png?nolink|}}|Let user select multiple choice|  | |Custom field: Multiple selections	|Let user select multiple choice|  | 
| |Custom control: Radio buttons	|{{:doc:dev:form:radio_buttons.png?nolink|}}|Radio buttons|  | |Custom control: Radio buttons	|Radio buttons|  | 
| |Custom control: Check boxes	|{{:doc:dev:form:check_boxes.png?nolink|}}|Check boxes|  | |Custom control: Check boxes	|Check boxes|  | 
| |Custom field: Large text|{{:doc:dev:form:large_text.png?nolink|}}|Store more text|  | |Custom field: Large text|Store more text|  | 
| |Custom field: hidden||There are 2 hidden fields in the sample. Values for these fields will also submit as data into the mail|  | |Custom field: hidden|There are 2 hidden fields in the sample. Values for these fields will also submit as data into the mail|  | 
| |Submit button	|{{:doc:dev:form:submit.png?nolink|}}|You may change the label to anything| | |Submit button	|You may change the label to anything| | 
 |  | 
|   | View PDF version: {{:doc:dev:form:form_to_email_cgi.pdf|}} | 
 |  | 
| Jan. 2000\\ | Jan. 2000\\ |