Form1 Builder Software

from softSWOT

Form1 Builder allows you to quickly build any web form using the Form1 engine. This provides a single file form and form processor with a hidden delivery email address.

For this software to function correctly your system should include a 5th Generation browser with JavaScript enabled. Microsoft Internet Explorer 5.5 (Windows 98) or later is recommended, Mozilla 1.4 and Netscape Navigator 7.0 or later are also supported.

If this message remains then your current browser does not appear to meet these requirements. This may be due to your browser blocking or disabling JavaScript, in which case please follow your browser help instructions to unblock/enable JavaScript. If required you can download current version browsers free of charge from:

Once you have current browser software with JavaScript enabled you will be able to access all software functions.

Required Variable

Form Delivery Email Address.
This is where you want your form data sent. To send to multiple addresses separate each address with a comma (i.e firstemail@mydomain.com,secondemail@mydomain.com). Alternatively it is possible to include the delivery email address as hidden fields in your form however it is recommended that it be included here.

Then select Optional or Quick Form or Designer Form or Existing Form

Variable Settings


Controls to save and load Required and Optional Variable Settings. Default Variables sets the Required and Optional Variables to default values, these are applied when you start a new Form1 Builder session. Save Variables saves all the current Required and Optional Variables. Load Variables sets all Required and Optional Variables to the previously saved values. Clear All clears all Form1 Builder fields.


Optional Variables

General Variables     Content Required Fields Auto Responder Formating Messages Pre-Defined Fields
Advanced Variables File Attachments Mathematical Functions Data Files Server Settings
General Variables can be applied to all forms. Advanced Variables are applicable only in specific circumstances. Click the Sub Menu item to view and adjust as required.

Content

Deliver Empty Form Fields.
This will send empty form fields in the form delivery email. If unchecked empty form fields will not be delivered.

Deliver First Letter Upper Case Fields Only.
This will only send fields with names that start with an upper case letter in the form delivery email. If unchecked all form fields will be delivered.

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.

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.

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.

Include User Variables.
This will include referrer, server, browser and IP address variables in the delivered form data.

Include User Cookies.
This will include set cookie data for the current domain in the delivered form data.

Required Fields

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). 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.

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.

Auto Responder

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 in Required Fields. Leave empty for no Auto Responder Message.

Formating

Display as HTML before Submission.
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 unchecked the form will be submitted without prior display.

Alphabetically Sort Delivered Data by Form Field Name.
This will sort delivered form field data alphabetically by field name. If unchecked delivered order will be as sent by the browser.

HMTL Email.
This will set the form delivery email to include a multipart html format. If unchecked the form delivery email will be plain text.

Line Break Off.
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.

JavaScript Return.
This will set JavaScript as the default return to form function. If unchecked the return to form will reload the form.

Reason Return.
This will add the reason for a return to form url to the return to form url. It is only applicable if customized message displays are used. If unchecked no reason will be added.

Set Form1 URL.
This URL address (i.e http://www.mydomain.com/form1.php) is used to force the return to form to a fixed URL. It is usually not required. If this is left empty the form url will be determined by the processing code.

Access Password.
This sets a required password to access the form. If this is left empty no access password is required.

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, and forms built using Quick Form and Designer Form functions. If this is left empty default style settings will be applied.

Messages

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 continue link returning to the form.

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.

Check Email URL.
This is the URL address (ie 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.

Form Process Error URL.
This is the URL address (ie http://www.mydomain.com/processerror.html) you want to display if the Form cannot be delivered on submit. If this is left empty a standard form processing error message will be displayed.

Pre-Defined Fields

Defined First Name Form Field.
This is the field name for the pre-defined input First Name. 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.

Defined Last Name Form Field.
This is the field name for the pre-defined input Last Name. 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.

Defined Email Address Form Field.
This is the field name for the pre-defined input Email Address. 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.

Defined Subject Form Field.
This is the field name for the pre-defined input Subject. 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.

Defined Email Copy Form Field.
This is the field name for the pre-defined input Email Copy. 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_Copy) and will be replaced by a space when the field name is displayed. The actual Email Copy field in the form should be a Checkbox. If this is left empty there will be no pre-defined data.

File Attachments

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.

Maximum Size of File Attachment.
This is the maximum allowable size in bytes of file attachments. If this is left empty or set to 0 no file attachments will be processed.

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/pjpeg,image/png,image/x-png,application/zip). If this is left empty no file attachments will be processed.

Mathematical Functions

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). 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.

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). 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.

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). 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.

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). 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.

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 ). Only Defined Plus, Minus, Multiply or Divide field names can be used.

Result Name.
This is the name displayed for the result of executing a mathematical function on form input values. For it to be displayed or sent it must start with an upper case letter. If this is left empty no name will be provided for results.

Data Files

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. If this is left empty no CSV Data File attachment will be sent.

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. If this is left empty no XML Data File attachment will be sent.

Server Settings

SMTP Mailserver Setting.
This will adjust the smtp mailserver setting to the value provided, this should be your domain smtp (ie mail.mydomain.com or smtp.mydomain.com). When this is set the server send_mail from is set as the delivery email. For some servers the send_mail from must be a valid email address on the domain mailserver. Setting this value will also cause the email from address to be set as the first delivery email address. In most cases this is not required but it is a requirement to send emails on some servers (usually windows based servers). If this is left empty no Server changes are made.

Once all desired Optional Variables have been set select Quick Form or Designer Form or Existing Form


Quick Form


Click Build Form to build a standard Quick Form. This will create the Form Code.


Designer Form

Add Pre-defined and Additional fields to the Form Fields Table, adjust variables as required and then click Build Form. The fields on the form will be in the order you add them to the Form Fields Table.

Add Pre-defined Fields

First Name - Last Name - Email Address - Subject - Email Copy
Click a pre-defined field description above to add it to the Form Fields Table.

Additional Fields

or   Form Fields
Input the required number of fields to Add or Remove from the bottom of the Form Fields Table.

Form Fields Table

Field Text to DisplayField TypeField NameDefault ValueRequired Field

These are the added Form Fields, adjust as required except shaded the variables of Pre-defined Fields. Once complete click Build Form to generate Form Code.

If Deliver First Letter Upper Case Fields Only is selected (which it is by default) the field names must start with an upper case letter to be delivered.


Existing Form

When using an existing file there should be no code (including previously added Form1 processing code) above the first html tag and all html code must be valid.

If Deliver First Letter Upper Case Fields Only is selected (which it is by default) the field names must start with an upper case letter to be delivered.

Local Files

Select Existing Web Form Page.


To use an existing form file as the base for your new form click Browse, select the html file from your local system and then click Build Form. The file used must include a valid html form with a submit button. Form1 Builder must be running on the local system (ie saved on your computer) not via the internet to use this function. If you wish to use an internet file you can save it to your computer and then select it as a local file. You can also View Source Code of local or internet based files.

Internet URL

URL Address of Existing Web Form Page.


To View Source Code of an internet based file input the URL Address ie http://www.mydomain.com/form.html. You can then save the displayed code to your local system and use it as a local file. Alternatively you can paste the source code directly into the Form Page Layout Code Only text area and Re-Build Using Form Page Layout Code to generate Form Code.

Copy and Paste Code

You can also easily add Form1 Processing Code to any valid web page form using a simple copy and paste.

Details are provided under Copy and Paste Code in the Help file.

Form Action Method

As an alternative to adding Form1 Processing Code to a form you can simply upload the Form Processing Code Only and then point the form action of an existing form to the uploaded processing code.

Details are provided under Form Action Method in the Help file.


Form Code

The text areas contain your form code. For a single file form use the Form Code Complete.

Form Code Complete


This is the complete layout and processing code for your form.

Simply copy the code in this text area to a text editor, then save it as a file with the php extension ie form1.php and upload the saved file to your server.

Alternatively you can use Upload. View Form layout displays the form in a new window.

If required you can access Individual Form Code Components below. These are only required for multi page forms or advanced form modification.

Form Processing Code Only


This is the form processing code only.

You can Copy and Paste Code to the top of existing forms or set the form action of existing forms to point to it once uploaded to your server. To upload simply copy the code in this text area to a text editor, then save it as a file with the php extension ie form1process.php and upload the saved file to your server.

Alternatively you can use Upload.

Form Page Layout Code Only




This is the form page code only.

You can paste existing form code into this text area, or modify code and Re-Build Using Form Page Layout Code. If you want to use a separate form processing script set the form action to point to the script, copy the code in this text area to a text editor, then save it as a html file ie form.html and upload the saved file to your server.

Alternatively you can use Upload. View Form Layout displays the form in a new window.


Upload

The Upload function is only available when Form1 Builder is running on your server, the server supports php, and ftp functions are enabled in the php server configuration. Any files uploaded will be placed in the same directory as the Form1 Builder and will overwrite any existing file of the same name. To use this function you must upload and run all Form1 Builder files on your server.

Alternatively simply follow the instructions in the Form Code section to place your form file on your server.

Upload will only work when ftp functions are enabled in the php server configuration. You can View Server php Configuration in a new window. Any files uploaded will be placed in the same directory as the Form1 Builder and will overwrite any existing file of the same name, take care!

If your server does not support the Upload function simply follow the instructions in the Form Code section to place your form file on your server.

Server Name.
This is the domain of your web site (i.e mydomain.com). It should be the domain only, no http or www.

User Name.
This is the user name to ftp access your web site.

User Password.
This is the password to ftp access your web site.

Save As File Name.
The name of the file to be saved.


This will upload the contents of the Form Code Complete text area.


This will upload the contents of the Form Processing Code Only text area.


This will upload the contents of the Form Page Layout Code Only text area.