ezyForm Hosting - Help

ezyForm Hosting accounts are based on the Form1 processing engine developed by softSWOT. By pointing your form action to your ezyForm processing account you can have the form data delivered to your email address and benefit from many of the Form1 processing features. You can open a New Account and give it a test run free for 7 days. Once you have opened your account you can use the Existing Account Sign In to adjust default form processing settings. This allows you to set up your form data delivery exactly as required. It is also possible (although not necessary) to incorporated form processing settings directly into your forms using hidden form fields. Service use signifies acceptance of our Conditions of Use.

To process your forms simply point the form action to your ezyForm Account by making your form action http://www.ezyform.com/host/p.php?a=**** where **** is your ezyForm account number. To do this you can open your form in your html editor or a text editor (ie NotePad), find the form action and set its value so it looks something like:

<form action="http://www.ezyform.com/host/p.php?a=****" method="post">

To access details and instructions for use refer to the applicable section in the ezyForm Hosting Account Help below. For variables applicable only to GoldMine Accounts refer to the GoldMine Variables section, these do not apply to Standard ezyForm Accounts.

Index - ezyForm Hosting Account Help

Account Details and Basic Settings

  1. Account Number
  2. Account Valid to Date
  3. Account Type
  4. Renew Account
  5. Form Delivery Email Address
  6. Account Domain
  7. Form Processing Events - Current Month
  8. Form Processing Events - Last Month
  9. Data Transfer - Current Month
  10. Data Transfer - Last Month
  11. Time of Last Action
  12. Account Password
  13. Show/Hide Optional Variables
  14. Form Action URL
  15. Edit Account Number
  16. Refresh Account Number

Optional Variables

  1. Content
    1. Deliver Empty Form Fields
    2. Deliver First Letter Upper Case Fields Only
    3. Local Time Offset
    4. Verification Subject Code
    5. Verification Body Code
    6. Include User Variables
    7. Include User Cookies
  2. Required Fields
    1. Defined Required Form Fields
    2. Defined As Empty Form Field Values
  3. Auto Responder
    1. Auto Responder Message
  4. Formating
    1. Display as HTML before Submission
    2. Alphabetically Sort Delivered Data by Form Field Name
    3. HMTL Email
    4. Line Break Off
    5. Access Password
    6. CSS (Cascading Style Sheet) File Name
  5. Messages
    1. Thank You URL
    2. Required URL
    3. Check Email URL
    4. Form Process Error URL.
  6. Pre-Defined Fields
    1. Defined First Name Form Field
    2. Defined Last Name Form Field
    3. Defined Email Address Form Field
    4. Defined Subject Form Field
    5. Defined Email Copy Form Field
  7. File Attachments
    1. Defined File Attachment Form Field
    2. Maximum Size of File Attachment
    3. Allowable File Types as Attachment
  8. Mathematical Functions
    1. Defined Plus Form Fields
    2. Defined Minus Form Fields
    3. Defined Multiply Form Fields
    4. Defined Divide Form Fields
    5. Execution Order of Form Fields
    6. Result Name
  9. Data Files
    1. CSV (Comma Separated Value) File Name
    2. XML (Extensible Markup Language) File Name
  10. GoldMine Variables - Applicable only to GoldMine Accounts
    1. Default GoldMine Processing Code
    2. GoldMine Use
    3. Use Content Type
    4. Send GoldMine Email Only
    5. Alternate GoldMine Email Address
    6. Example Web Import Form

Account Details and Basic Settings

Account Details and Basic Settings are displayed when you Sign In to your account. The settings can be modified when you Edit Account Number.

Account Number

This is the unique number that identifies your account. To have a form processed by this account simply point the form action to http://www.ezyform.com/host/p.php?a=**** where **** is the account number. To do this you can open your form in your html editor or a text editor (ie NotePad), find the form action and set its value so it looks something like:

<form action="http://www.ezyform.com/host/p.php?a=****" method="post">

By default all forms processed by an account will use the default settings of the account. The account settings can be modified when you Edit Account Number. If required you can override the default settings by using hidden fields in the form. You can point multiple forms to the same account.

Index

Account Valid to Date

This is the date and time that the account is valid until. To maintain the account beyond this date the account must be renewed. Only valid accounts will process form data. All dates and times are based on GMT/UTC (Greenwich Mean Time / Universal Time Constant) and are displayed as YYYY-MM-DD HH:MM:SS.

Index

Account Type

This the type of account. Account types may be Standard or GoldMine. Standard accounts deliver form data by standard email. GoldMine accounts are special accounts for use with a GoldMine Database and deliver form data in a special WebImport format for importing into the GoldMine Database. The number in the account type indicates the monthly maximum data transfer in kilobytes for the account and the monthly maximum number of form processing events for the account. A form processing event occurs whenever a user clicks a form or message button/link to submit or resubmit a form. If a user previews the form submission or receives a message prompt there will be more than 1 form processing action per form delivery. If an account exceeds either it's maximum monthly data transfer or it's maximum monthly form processing events form processing will be suspended for the remainder of the month.

Example: Account Type Standard 1000. The monthly maximum data transfer for this account is 1000 kilobytes (1 Megabyte) and the monthly maximum form processing events is 1000.

Index

Renew Account

This the link to Renew your Account. When you click Renew Account .... you are directed to a secure transaction processor to process your transaction.

Index

Form Delivery and Account Email Address

This is where you want your form data sent. It is also your account sign in email. It should be a single valid email address, all form data processed by this account will be sent to this email address. If there is no Defined Email Address Form Field set the form data email will also have a from email address set as your Form Delivery Email Address. To receive the form delivery it must not be blocked by email filters.

When you Edit Account you can adjust this setting. This variable cannot be set using hidden fields. This prevents email harvesting and ensures that form delivery cannot be redirected.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Index

Account Domain

This is the domain on which your forms will run. It should be a single domain name. Set this as the base domain ie mydomain.com this allows any forms on the base domain or any sub domains to be processed but blocks attempts to process forms from other domains.

When you Edit Account you can adjust this setting.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Index

Form Processing Events - Current Month

This is the number of Form Processing Events for the current month. The number in the account type indicates the monthly maximum number of form processing events for the account.

Index

Form Processing Events - Last Month

This is the number of Form Processing Events for the previous month.

Index

Data Transfer - Current Month

This is the Data Transfer in kilobytes (1000 bytes) for the current month. The number in the account type indicates the monthly maximum data transfer for the account.

Index

Data Transfer - Last Month

This is the Data Transfer in kilobytes (1000 bytes) for the previous month.

Index

Time of Last Action

This is the date and time of the last account action. Account actions include any form processing event and account Save or Refresh action. All dates and times are based on GMT/UTC (Greenwich Mean Time / Universal Time Constant) and are displayed as YYYY-MM-DD HH:MM:SS.

Index

Account Password

This is the password used for your account, it has a maximum of 10 characters.

When you Edit Account Number you can adjust this setting.

Index

Show/Hide Optional Variables

When clicked this displays or hides optional variables. For details refer to the to Optional Variables section.

Index

Form Action URL

This is the URL that should be used for your form action. To have a form processed by this account simply point the form action to the Form Action URL value. To do this you can open your form in your html editor or a text editor (ie NotePad), find the form action and set its value so it looks something like:

<form action="http://www.ezyform.com/host/p.php?a=****" method="post">

Index

Edit Account Number

When clicked this allows you to edit account settings and variables.

Index

Refresh Account Number

When clicked this updates the Form Processing, Data Transfer and Time of Last Action values.

Index

Optional Variables

Optional Variables can be access from your account using the Show/Hide Optional Variables link. If desired they can be used to add additional features and functionality to your forms.

Content

Variables related to the content of the form delivery email.

Deliver Empty Form Fields

When true this will send empty form fields in the form delivery email. If false only form fields with input will be sent in the form delivery email.

Alternatively this variable can be set using a hidden field in your form. For example:
<input type="hidden" name="showempty" value="true" />
Variables set in the form overwrite variables set in the processing account.

Index

Deliver First Letter Upper Case Fields Only

When true this will only send fields with names that start with an upper case letter in the form delivery email. If false all named fields in the form will be sent in the form delivery email.

Alternatively this variable can be set using a hidden field in your form. For example:
<input type="hidden" name="firstupper" value="true" />
Variables set in the form overwrite variables set in the processing account.

Index

Local Time Offset

This is the local time offset in hours from GMT/UTC and is used to define the form processed time. If set as 0 or left empty GMT/UTC will be recorded. You can use http://www.worldtimeserver.com to find your local time offset.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="timeoffset" value="-4" />
Variables set in the form overwrite variables set in the processing account.

Index

Verification Subject Code

This appends the Verification Subject Code to the form delivery email subject and can be used with an email filter to ensure the email originates from the form. If this is left empty no Verification Subject Code will be appended.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="verifysubject" value="W4r6hsL9" />
Variables set in the form overwrite variables set in the processing account.

Index

Verification Body Code

This adds the Verification Body Code to the form delivery email body and can be used with an email filter to ensure the email originates from the form. If this is left empty no Verification Body Code will be added.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="verifybody" value="W4r6hsL9" />
Variables set in the form overwrite variables set in the processing account.

Index

Include User Variables

When true this will include referrer, server, browser and IP address variables in the delivered form data. If false no User Variables will be added to the form data.

Variables -
User Browser (HTTP_USER_AGENT): Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.4) Gecko/20030624
User IP Address (REMOTE_ADDR): 202.45.107.1
Form1 PHP Server IP (SERVER_ADDR): 64.176.242.139
Form1 PHP Server Name (SERVER_NAME): www.softswot.com
Form1 PHP Script (PHP_SELF): /Form1Try.php
Form1 URL Domain: softswot.com
Form1 URL (HTTP_REFERER): http://www.softswot.com/Form1Try.php

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="usehttpvars" value="true" />
Variables set in the form overwrite variables set in the processing account.

Index

Include User Cookies - Not Available in a Hosted Account

Index

Required Fields

Variables to set and manage the fields identified as required.

Defined Required Form Fields

This is the form field names that are defined as Required (must be completed). Required field names should be input separated by a comma (ie First_Name,Last_Name). If Deliver First Letter Upper Case Fields Only is true all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator and will be replaced by a space when the field name is displayed. If this is left empty no form fields will be set as required. For Select field types that require multiple selections the field name in the form; not in Defined Required Form Fields; must end with [] and the Select start tag should include <select multiple='multiple'>. All field names set as Required must be included in your form.

Example: To define the field names First_Name and Last_Name as required the variable in the processing account is set as First_Name,Last_Name.

The maximum number of characters for this variable when set in your ezyForm Account is 500.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="defrequired" value="First_Name,Last_Name" />
Variables set in the form overwrite variables set in the processing account.

Index

Defined As Empty Form Field Values

This is the form field values that are defined as Empty (not provided). As Empty field values should be input separated by a comma (ie Please make a selection,Input your email address here). If this is left empty no form field values will be defined as empty.

Example: This is commonly used with Select fields so any default value is not treated as user input. For a Required Select field with the first option Please make a selection the selection of the first option will be treated as empty when this variable is set as Please make a selection. In the processing account this appears as Please make a selection.

The maximum number of characters for this variable when set in your ezyForm Account is 500.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="asempty" value="Please make a selection" />
Variables set in the form overwrite variables set in the processing account.

Index

Auto Responder

Variables to set an Auto Responder Message.

Auto Responder Message

This message will be sent to the input value of the Defined Email Address Form Field on form submission. The form should include an input email address field and it should be set as Required in the Defined Required Form Fields.

The Auto Responder Message is sent as a plain text email. All non-Alphanumeric characters should be avoided. Leave empty for no Auto Responder Message. In the processing account this appears as Thank you for your request, it is currently being processed. For further details on our products and services please visit www.softswot.com..

The maximum number of characters for this variable when set in your ezyForm Account is 500.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="autoresponse" value="Thank you for your request, it is currently being processed. For further details on our products and services please visit www.softswot.com." />
Variables set in the form overwrite variables set in the processing script.

Index

Formating

Variables related to the formatting of the form submission and delivery email.

Display as HTML before Submission

When true this will display the form input as a html web page prior to form submission. This should not be used if your form includes a file upload. If false the form will be submitted without prior display.

Alternatively this variable can be set using a hidden field in your form. For example:
<input type="hidden" name="htmldisplay" value="true" />
Variables set in the form overwrite variables set in the processing account.

Index

Alphabetically Sort Delivered Data by Form Field Name

When true this will sort delivered form field data alphabetically by field name. If false the delivered order will be as sent by the browser.

Alternatively this variable can be set using a hidden field in your form. For example:
<input type="hidden" name="alphasort" value="true" />
Variables set in the form overwrite variables set in the processing account.

Index

HMTL Email

When true this will set the form delivery email to include a multipart html format. If false the form delivery email will be plain text.

Alternatively this variable can be set using a hidden field in your form. For example:
<input type="hidden" name="htmlemail" value="true" />
Variables set in the form overwrite variables set in the processing account.

Index

Line Break Off

When true this will remove the default line break between field Names and Values in the delivered form data. This is only applicable when the form delivery email is plain text with HMTL Email set as false.

Alternatively this variable can be set using a hidden field in your form. For example:
<input type="hidden" name="breakoff" value="true" />
Variables set in the form overwrite variables set in the processing account.

Turning the line break off results in the delivered form data format:

Email Address: user@theirdomain.com

Maintaining the line break results in the delivered form data format:

Email Address:
user@theirdomain.com

Index

Access Password - Not Available in a Hosted Account

Index

CSS (Cascading Style Sheet) File Name

This is the URL address (i.e http://www.mydomain.com/style.css) of the Cascading Style Sheet (CSS) file you want to apply to the default html notification pages. If this is left empty default style settings will be applied.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="cssfile" value="http://www.mydomain.com/style.css" />
Variables set in the form overwrite variables set in the processing account.

Index

Messages

Variables related to message and notification display.

Thank You URL

This is the URL address (i.e http://www.mydomain.com/thankyou.html) you want to display after form submission. If this is left empty a standard thank you message will be displayed with a button to return to the form. The standard message will apply the CSS (Cascading Style Sheet) File Name if set.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="thankurl" value="http://www.mydomain.com/thankyou.html" />
Variables set in the form overwrite variables set in the processing account.

When you include this setting the Form file name i.e form1.php is also passed to the Thank You URL as the value of a variable $reason. If you add the code:
<?php if(!isset($_GET)){$_GET=$HTTP_GET_VARS;}if(isset($_GET["reason"])){echo $_GET["reason"];} ?>
to your web page code the form file name will be displayed when the page is run on a server supporting php and viewed in a browser. Some servers require files to have the extension .php before they will execute php code.

Index

Required URL

This is the URL address (i.e http://www.mydomain.com/required.html) you want to display if any Required fields are not completed. If this is left empty a standard required message will be displayed with a button to return to the form. The standard message will apply the CSS (Cascading Style Sheet) File Name if set. Required fields are set as Required in the Defined Required Form Fields variable.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="requrl" value="http://www.mydomain.com/required.html" />
Variables set in the form overwrite variables set in the processing account.

When you include this setting the missing Required Form Field Name i.e Email is also passed to the Required URL as the value of a variable $reason. If you and you add the code:
<?php if(!isset($_GET)){$_GET=$HTTP_GET_VARS;}if(isset($_GET["reason"])){echo $_GET["reason"];} ?>
to your web page code the form file name will be displayed when the page is run on a server supporting php and viewed in a browser. Some servers require files to have the extension .php before they will execute php code.

Index

Check Email URL

This is the URL address (i.e http://www.mydomain.com/checkemail.html) you want to display if the Email Address submitted is not valid. If this is left empty a standard check email message will be displayed with a button to return to the form. The standard message will apply the CSS (Cascading Style Sheet) File Name if set. The email address is identified as the input of the form field that has the name of the Defined Email Field Name, by default this is Email_Address for standard account and contact for GoldMine accounts.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="ckurl" value="http://www.mydomain.com/checkemail.html" />
Variables set in the form overwrite variables set in the processing account.

When you include this setting the email form field input is also passed to the Check Email URL as the value of a variable $reason. If you add the code:
<?php if(!isset($_GET)){$_GET=$HTTP_GET_VARS;}if(isset($_GET["reason"])){echo $_GET["reason"];} ?>
to your web page code the form file name will be displayed when the page is run on a server supporting php and viewed in a browser. Some servers require files to have the extension .php before they will execute php code.

Index

Form Process Error URL

This is the URL address (i.e http://www.mydomain.com/processerror.html) you want to display if the form cannot be delivered on submission. If this is left empty a standard processing error message will be displayed with a button to return to the form. The standard message will apply the CSS (Cascading Style Sheet) File Name if set.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="errurl" value="http://www.mydomain.com/processerror.html" />
Variables set in the form overwrite variables set in the processing account.

Index

Pre-Defined Fields

Variables related to the handling of specific fields, when included will be applied in a defined manner.

Defined First Name Form Field

This is the field name for the pre-defined input First Name. The input value is treated as a name provided by the form user. If provided it is combined with the input from the Defined Last Name Form Field as "First_Name Last_Name" and applied in the From address of the delivered form data email. For standard accounts the default value is First_Name, for GoldMine accounts the default value is contact, this can be changed by providing a different field name. If Deliver First Letter Upper Case Fields Only is selected all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator (ie First_Name) and will be replaced by a space when the field name is displayed. If this is left empty there will be no pre-defined data for this variable.

Example: Variable set as First_Name. In the processing account this appears as First_Name.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="deffirstname" value="First_Name" />
Variables set in the form overwrite variables set in the processing account.

Index

Defined Last Name Form Field

This is the field name for the pre-defined input Last Name. The input value is treated as a name provided by the form user. If provided it is combined with the input from the Defined First Name Form Field as "First_Name Last_Name" and applied in the From address of the delivered form data email. For standard accounts the default value is Last_Name, for GoldMine accounts the default value is empty and the Defined First Name Form Field is used for both first and last names,this can be changed by providing a different field name. If Deliver First Letter Upper Case Fields Only is selected all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator (ie Last_Name) and will be replaced by a space when the field name is displayed. If this is left empty there will be no pre-defined data for this variable.

Example: Variable set as Last_Name. In the processing account this appears as Last_Name.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="deflastname" value="Last_Name" />
Variables set in the form overwrite variables set in the processing account.

Index

Defined Email Address Form Field

This is the field name for the pre-defined input Email Address. The input value is treated as an email address provided by the form user and checked for validity. It is applied in the From address of the delivered form data email. For standard accounts the default value is Email_Address, for GoldMine accounts the default value is email, this can be changed by providing a different field name. If Deliver First Letter Upper Case Fields Only is selected all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator (ie Email_Address) and will be replaced by a space when the field name is displayed. If this is left empty there will be no pre-defined data and the delivery email address will be used as the From address.

Example: Variable set as Email_Address. In the processing account this appears as Email_Address.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="defemail" value="Email_Address" />
Variables set in the form overwrite variables set in the processing account.

Index

Defined Subject Form Field

This is the field name for the pre-defined input Subject. The input value is applied as the subject of the delivered email. It can be set up as a text field for user input or as a hidden filed with a pre set value. The default value is Subject, this can be changed by providing a different field name. If Deliver First Letter Upper Case Fields Only is selected all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator and will be replaced by a space when the field name is displayed. If this is left empty there will be no pre-defined data and the default subject Form Submission will be used.

Example: Variable set as Subject. In the processing account this appears as Subject.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="defsubject" value="Subject" />
Variables set in the form overwrite variables set in the processing account.

Index

Defined Email Copy Form Field

This is the field name for the pre-defined input Email Copy. This field is usually a check box and when selected (checked) by the user a Carbon Copy (CC) of the form data email is sent to the From email address as determined by the Defined Email Address Field. This should only be used in conjunction with a Defined Email Address Field that is set as Required in the Defined Required Form Fields to ensure a user email address is provided otherwise it may result in two emails being delivered to the form delivery email address. The default value is Email_Copy, this can be changed by providing a different field name. If Deliver First Letter Upper Case Fields Only is true all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator and will be replaced by a space when the field name is displayed. If this is left empty there will be no pre-defined data.

Example: Variable set as Email_Copy. In the processing account this appears as Email_Copy.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="defemailcopy" value="Email_Copy" />
Variables set in the form overwrite variables set in the processing account.

Index

File Attachments

Variables related to handling file attachments with form delivery. To use File Attachments Display as HTML before Submission must not be selected.

Defined File Attachment Form Field

This is the field name for the pre-defined input File Attachment. This field must be of the input type="file" and the form start tag must include enctype="multipart/form-data" to enable file attachments. Spaces should not be used in field names, an underscore _ can be used as a separator (ie Attach_File) and will be replaced by a space when the field name is displayed. If this is left empty no file attachments will be processed.

Example: Variable set as Attach_File. In the processing account this appears as Attach_File.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="deffileatt" value="Attach_File" />
Variables set in the form overwrite variables set in the processing account.

Index

Maximum Size of File Attachment

This is the maximum allowable size in bytes of file attachments. The maximum upload size is also be limited by the server settings. If this is left empty or set to 0 no file attachments will be processed.

Example: To limit attached file sizes to around 50 kb (50 kilobytes) set this variable as 50000. In the processing account this appears as 50000.

The maximum allowable file size is 2000000 bytes.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="filemaxsize" value="50000" />
Variables set in the form overwrite variables set in the processing account.

Index

Allowable File Types as Attachment

This is the allowable file types (MIME) for file attachments. Allowable file types should be input separated by a comma (ie image/gif, image/jpeg, image/png, image/x-png, application/zip). Information on MIME types is available at W3Schools. Some file types have more than one MIME ie image/jpeg and image/pjpeg both refer to jpeg images. When a File Type Not Allowed Message is displayed it includes the not allowed file type. To enable processing of this file type add it to this variable. If this is left empty no file attachments will be processed.

Example: To allow attachments of gif, jpeg and png images as well as zip files set this variable as image/gif, image/jpeg, image/png, image/x-png, application/zip. In the processing account this appears as image/gif, image/jpeg, image/png, image/x-png, application/zip.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="fileallow" value="image/gif, image/jpeg, image/png, image/x-png, application/zip" />
Variables set in the form overwrite variables set in the processing account.

Index

Mathematical Functions

Variables related to handling mathematical functions in the form.

Defined Plus Form Fields

These are the field names defined as Plus fields for Mathematical Functions. Field names should be input separated by a comma (ie Item_1,Item_2). The order of calculation is determined by the variable Execution Order of Form Fields. If Deliver First Letter Upper Case Fields Only is selected all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator and will be replaced by a space when the field name is displayed.

Example: To set the input for the fields named Item_1 and Item_2 as plus fields set this variable as Item_1,Item_2. In the processing account this appears as Item_1,Item_2.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="defplus" value="Item_1,Item_2" />
Variables set in the form overwrite variables set in the processing account.

Index

Defined Minus Form Fields

These are the field names defined as Minus fields for Mathematical Functions. Field names should be input separated by a comma (ie Item_3,Item_4). The order of calculation is determined by the variable Execution Order of Form Fields. If Deliver First Letter Upper Case Fields Only is selected all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator and will be replaced by a space when the field name is displayed.

Example: To set the input for the fields named Item_3 and Item_4 as minus fields set this variable as Item_3,Item_4. In the processing account this appears as Item_3,Item_4.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="defminus" value="Item_3,Item_4" />
Variables set in the form overwrite variables set in the processing account.

Index

Defined Multiply Form Fields

These are the field names defined as Multiply fields for Mathematical Functions. Field names should be input separated by a comma (ie Item_5,Item_6). The order of calculation is determined by the variable Execution Order of Form Fields. If Deliver First Letter Upper Case Fields Only is selected all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator and will be replaced by a space when the field name is displayed.

Example: To set the input for the fields named Item_5 and Item_6 as multiply fields set this variable as Item_5,Item_6. In the processing account this appears as Item_5,Item_6.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="defmultiply" value="Item_5,Item_6" />
Variables set in the form overwrite variables set in the processing account.

Index

Defined Divide Form Fields

These are the field names defined as Divide fields for Mathematical Functions. Field names should be input separated by a comma (ie Item_7,Item_8). The order of calculation is determined by the variable Execution Order of Form Fields. If Deliver First Letter Upper Case Fields Only is selected all form field names to be delivered must start with an upper case letter. Spaces should not be used in field names, an underscore _ can be used as a separator and will be replaced by a space when the field name is displayed.

Example: To set the input for the fields named Item_7 and Item_8 as multiply fields set this variable as Item_7,Item_8. In the processing account this appears as Item_7,Item_8.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="defdivide" value="Item_7,Item_8" />
Variables set in the form overwrite variables set in the processing account.

Index

Execution Order of Form Fields

This is the field order of execution for the Mathematical Functions. Field names should be input separated by a comma (ie Item_1,Item_5,Item_3,Item_7 which based on the above example is Item_1 * Item_5 - Item_3 / Item_7 ). If the input for Item_1=10, Item_5=20, Item_3=10 and Item_7=2 the calculation would be 20 * 10 - 10 / 2. The result is 95 and this will be displayed with the Result Name. The calculation order is not influenced by the operator (ie plus, minus, multiply, divide) and is strictly as defined by this variable. Only Defined Plus, Minus, Multiply or Divide field names can be used.

Example: To set the Execution Order to Item_1 then Item_5 then Item_3 then Item_7 set this variable as Item_1,Item_5,Item_3,Item_7. In the processing account this appears as Item_1,Item_5,Item_3,Item_7.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="execorder" value="Item_1,Item_5,Item_3,Item_7" />
Variables set in the form overwrite variables set in the processing account.

Index

Result Name

This is the name displayed for the result of executing a mathematical function on form input values. If Deliver First Letter Upper Case Fields Only is selected it must start with an upper case letter to be displayed or sent. The result is calculated when the form is submitted and if Display as HTML before Submission is set the result will be displayed to the user when the form submit button is clicked and before the form is sent. If this is left empty there will be no result calculated.

Example: Variable set as Order_Total. In the processing account this appears as Order_Total.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
Order_Total
Variables set in the form overwrite variables set in the processing account.

Index

Data Files

Variables to send form data as a data file attachment.

CSV (Comma Separated Value) File Name

This is the CSV Data File name (ie data.csv) and when set form data will also be delivered as a CSV Data File attachment to the form delivery email. Additional detail on CSV is available at Creativyst. If this is left empty no CSV Data File attachment will be sent.

Example: Variable set as data.csv. In the processing account this appears as data.csv.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="csvfile" value="data.csv" />
Variables set in the form overwrite variables set in the processing account.

The CSV file sent is structured with form data value for each field included as:
"Value",

The processed time is:
"Time",

When Include User Variables is set the CSV file also has user variables included:
"User Browser",
"User IP Address",
"Form1 PHP Server",
"Form1 PHP Server Name",
"Form1 PHP Script",
"Form1 URL Domain",
"Form1 URL",

Index

XML (Extensible Markup Language) File Name

This is the XML Data File name (ie data.xml) and when set form data will also be delivered as a XML Data File attachment to the form delivery email. Additional detail on XML is available from the W3Schools. If this is left empty no XML Data File attachment will be sent.

Example: Variable set as data.xml. In the processing account this appears as data.xml.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Alternatively: This variable can be set using a hidden field in your form as
<input type="hidden" name="xmlfile" value="data.xml" />
Variables set in the form overwrite variables set in the processing account.

The XML file sent is structured as:
<?xml version="1.0" ?>
<Form1_XML>

Form data for each field is included as:
<FormFieldName>Value</FormFieldName>

The processed time is:
<Processed>Time</Processed>

When Include User Variables is set the XML file also has a Variables tag with user variables included:
<Variables>
<HTTP_USER_AGENT>User Browser</HTTP_USER_AGENT>
<REMOTE_ADDR>User IP Address</REMOTE_ADDR>
<SERVER_ADDR>Form1 PHP Server IP</SERVER_ADDR>
<SERVER_NAME>Form1 PHP Server Name</SERVER_NAME>
<PHP_SELF>Form1 PHP Script</PHP_SELF>
<Domain>Form1 URL Domain</Domain>
<HTTP_REFERER>Form1 URL</HTTP_REFERER>
</Variables>

The XML file is closed with:
</Form1_XML>

GoldMine Variables - Applicable only to GoldMine Accounts

Set up your form so that form data is automatically imported into your GoldMine database using GoldMine's WebImport feature.

If you wish to include Instructions for your Web Import data in your form you can add them as hidden fields at the top of your form (before any data fields). Then you need to include a marker hidden field with the name DataStart, no value is required for this field. Below this field you can include your normal form data fields. For Example:
Instruction Field -
<input type="hidden" name="OnNewAttachTrack" value="Required Track">
Then Marker Field -
<input type="hidden" name="DataStart">
Then Data Field -
<input name="Contact">

GoldMine Use

When true this sets form processing to add GoldMine WebImport formatting to the form data and send it by email in GoldMine WebImport format. If a delivery error occurs the the subject of the form delivery email is modified to start with Error GoldMine. If false form delivery will be the same as a Standard Account.

Alternatively this variable can be set using a hidden field in your form. For example:
<input type="hidden" name="gmuse" value="true" />
Variables set in the form overwrite variables set in the processing account.

Use Content Type

When true this changes the process marker for the GoldMine WebImport email to "Content-Type: application/x-gm-impdata\r\n". If false the default process marker "{$GM-WEBIMPORT$}" in the email To: field will be used. In most cases this will not be required however if GoldMine is not importing your data try setting this variable.

Alternatively this variable can be set using a hidden field in your form. For example:
<input type="hidden" name="gmusecontenttype" value="true" />
Variables set in the form overwrite variables set in the processing account.

Index

Send GoldMine Email Only

When true this sets form processing to only send form data in GoldMine WebImport format, no standard form delivery email is sent. If false two emails will be sent, one in GoldMine WebImport format, and one standard form delivery email.

Alternatively this variable can be set using a hidden field in your form. For example:
<input type="hidden" name="gmsendonly" value="true" />
Variables set in the form overwrite variables set in the processing account.

Index

Alternate GoldMine Email Address

To send the GoldMine WebImport email to an email address different from the standard Form Delivery Email Address input the alternative email address here. If this field is left empty the GoldMine WebImport email is sent to the standard Form Delivery Email Address.

This variable cannot be set using hidden fields. It must be set in the processing account.

The maximum number of characters for this variable when set in your ezyForm Account is 75.

Index

Valid XHTML 1.0! Valid CSS!

Copyright ©

ezyForm is a member of the Bizpep Group


ezyForm Hosting
Existing Account Sign In
New Account
Help
Pricing
Contact Us