Version 11 - The latest version is always available from www.softSWOT.com
Copyright © softSWOT 2003
Software is available as shareware with a free 7 day evaluation period. If you find this software useful or maintain it beyond the evaluation period payment is required to Register Form1 Builder.
Form1 Builder runs in your web browser and allows you to easily build any web form. It applies the base Form1 structure to provide a single file form with a hidden email delivery address and an extensive range of benefits and options.
Form1 Builder software provides:
All Form Code generated includes the extensive benefits and options provided by Form1 processing including:
Form1 (the generated form code) runs on your web server. To run Form1 your server must support the php scripting language. Most commercial web servers support php. For information on php and how to check if it is available on your server goto What is php?
Download Form1 Builder software and Install it on your system. Then open Form1Builder.html in your web browser (javascript must be enabled). At the top of the page is the control Menu.
Initially it is recommended that you build a Quick Form, and give it a test run on you server. To do this:
Once you have seen Form1 in action on your server you can explore the range of features offered by Form1 Builder and generate single file forms to suit all your requirements. Use the controls Menu at the top or the progressive control links at the bottom of each section to develop forms.
Click Build Form to generate base Quick Form code. This includes basic predefined form fields to demonstrate Form1 features and functionality.
The generated code is placed in the Form Code text area.
When you Build Form the form layout is displayed in a new window and can be viewed using View Form Layout. This window only includes the form layout, no processing code is included.
Allows you design a form to your specifications by adding Pre-defined and Additional fields to the Form Fields Table.
Pre-defined Fields - Click to add to the Form Fields Table. Refer to Form Pre-Defined Fields for details on how predefined fields are handled.
Additional Fields - Input the required number of fields to Add or Remove from the bottom of the Form Fields Table.
Form Fields Table - You can adjust the variables of added fields as required. Pre-defined Field shaded variables should not be changed.
Once a field is added to the Form Fields Table you can adjust the variables. Pre-defined Field shaded variables should not be changed. The fields will be displayed on the form in the order they appear in the Form Fields Table.
Once you have the the form fields set up click Build Form to generate form code.
The generated code is placed in the Form Code text area.
When you Build Form the form layout is displayed in a new window and can be viewed using View Form Layout. This window only includes the form layout, no processing code is included.
Form1 Builder must be running on the local system (ie saved on your computer, not on the internet) to use this function.
To use an existing form structure or style as the base for your new form click browse to select the file from your local system then click Build Form. The file used must include a valid html form and a submit button.
Select existing Web Form Page - This is the existing web form you wish to use.
Copy the code in the text area to a text editor, then save it as a file with the php extension i.e Form1.php and upload the saved file to your server.
Select All - Highlights all the text code in the Form Code text area for copying it.
View Form Layout - Displays the built form in a new window. This is only the form layout and does not include the processing code.
Clear Form Code - Clears the contents of the Form Code text area.
Reset All Configuration Variables - Clears all Form1 Builder variables and the Form Code text area.
Open the Help file (this file) in a new window.
Access registration and support details.
Open Form1 Builder developer web site, www.softswot.com.
The following details relate specifically to the generated Form1 code. Once you have generated code with the Form1 Builder you can undertake further modification by directly editing the form code in the Form Code text area or a text editor.
At the top of the form is the php form processing code. This includes the following User Configuration Settings below the line #### Start User Configuration Settings:
Using a text editor or the Form code text area you can adjust these settings. Only the contents between the " " 's in the User Configuration Settings should be changed in the top php code section. Any other changes could corrupt Form1 functionality. A description and example is provided below for each setting. A Form Delivery Email Address must be provided, all other settings or optional.
This is where you want your form data sent. For example:
To send to multiple addresses separate each address with a comma (i.e firstemail@mysite.com,secondemail@mysite.com).
This is the URL address the user is redirected to on successful form submission. For example:
If this is left empty a standard thank you message will be displayed with a continue link returning to the form.
When you include a $thankurl 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 echo $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.
This is the URL address you want to display if any Required fields are not completed. For example:
If this is left empty a standard required message will be displayed:
In this message the variable $Name is replaced by the Required field name.
Required fields are identified by their form field name. When this name is all Upper Case the processing code checks to see that an input has been provided for the field. In the example form the email form field is identified as required because the field name is EMAIL (all upper case). To set a form field as Required simply make its name all upper case in your html form.
When you include a $requiredurl setting the form field name i.e EMAIL is also passed to the Required URL as the value of a variable $reason. If you add the code <?php echo $reason; ?> to your web page code the form field 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.
This is the URL address you want to display if the Email Address submitted is not valid. The email address is identified as the form field named "Email". For example:
If this is left empty a standard check email message will be displayed:
In this message the variable $email is replaced by the user input for the email field.
When you include a $ckurl 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 echo $reason; ?> to your web page code the form field 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.
This is the URL address you want to display if the Form cannot be delivered on submit. For example:
If this is left empty a standard form processing error message will be displayed:
When set to "true" this will include referrer, server, browser and IP address variables in the delivered form data. For example:
If this is empty or set to "false" no User Variables will be added to the form data.
User Variables included in the form data are formatted variable name : variable value as in the following example:
Variables -
User File (HTTP_REFERER) :
http://www.softswot.com/Form1Try.php
User Browser (HTTP_USER_AGENT) : Mozilla/4.0 (compatible;
MSIE 6.0; Windows NT 5.1; Alexa Toolbar)
User IP Address (REMOTE_ADDR) : 203.10.110.131
Form Server IP (SERVER_ADDR) : 216.127.70.116
Form Server Name (SERVER_NAME) : www.softswot.com
Requested URL (REQUEST_URI) : /Form1Try.php
When set to "true" this will include set user cookie data for the current domain in the delivered form data. For example:
If this is empty or set to "false" no User Cookies will be added to the form data.
User Cookies are only those cookies that are currently set on the users system by the domain hosting the form (i.e http://www.mysite.com). They are included in the form data and formatted cookie name : cookie value as in the following example:
Cookies -
a : testCookie
When set to "true" this will remove the default line break between field Names and Values in the delivered form data. For example:
If this is empty or set to "false" the default line break will be maintained.
Removing the line break results in the delivered form data format:
EMAIL : user@theirsite.com
Maintaining the line break results in the delivered form data format:
EMAIL :
user@theirsite.com
This message will be sent to the input value of the form field named EMAIL on form submission. For example:
If this is empty there will be no Auto Responder Message.
When using the Auto Responder the form should include an email field named EMAIL and it should be set as Required (all upper case i.e EMAIL). The Auto Responder Message is sent as a plain text email. To include a line break use "\n" as in the above example. All other non-Alphanumeric characters should be avoided.
These form field names and their variants (i.e all upper case if set as required) are not necessary for form processing but when included will be applied in the following manner.
Field name Email - This is the email address provided by the form user. It is applied in the From address of the delivered form data email. If there is no field "Email" the delivery email address will use be used as the From address.
Field name Subject - This 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.
Field name FirstName - This is a name provided by the form user. If provided it is combined with the field LastName (in the form "FirstName LastName") and applied in the From address of the delivered form data email.
Field name LastName - This is also a name provided by the form user. If provided it is combined with the field FirstName (in the form "FirstName LastName") and is applied in the From address of the delivered form data email.
Field name EmailCC - This is usually a check box and when selected by the user a CC (carbon copy) of the form data email is sent to the From address. This should only be used in conjunction with the "EMAIL" field otherwise it will result in two emails being delivered to the form delivery email address. The all upper case "EMAIL" field name sets this field as required to ensure an email address for the user is provided.
Processing - The form information processed for email delivery is determined by the Field Name. Fields that have a name where the first letter is Upper Case (i.e FirstName, Email) will be processed for email delivery and included in the form data email. Fields that have a name where the first letter is lower case (i.e submit, reset) will not be processed for email delivery. Field names that are all upper case (i.e FIRSTNAME, EMAIL) are identified as Required. If a Required field has no input on form submission a user prompt is provided.
Submit Button - All forms must include a submit button button with the name "submit".
Form Tag - The form tag must include <form action="<?php echo "$PHP_SELF"; ?>" method="post">. Or instead of using php code in the form action replace <?php echo "$PHP_SELF"; ?>" with the form file name i.e <form action="QuickForm.php" method="post">.
To add Form1 processing code to an existing form copy the php form processing code from the top down to and including the line:
/* #### Below here is standard html. You can adjust the html as required. You can also copy the code from here up (including the ?> following this comment) and paste it at the top (above the html tag and any document type tags) of any html form page. All forms must be valid html and follow the guidelines provided in the help file. */?>
Paste this code at the top (above the html tag and any document type tags) of the html form page. The form must be valid html and include:
You can modify the file including User Configuration Settings directly in the text editor. Save the code as a file with the php extension and upload the saved file to your server.
Take Care when modifying and uploading you Form1 file to ensure the php coding is not corrupted. If your uploaded Form1 does not deliver your form when you submit with a valid email address check the form action. When you view Form1 in your editor the form tag is:
<form action="<?php echo "$PHP_SELF"; ?>" method="post">
The action is php code telling the form to load itself. When Form1 is run on the server and you view source the action becomes the Form1 file name. If the form action is missing the php code may have been corrupted when you edited or uploaded the file. To overcome this you can manually set the form action to the file name i.e.:
<form action="QuickForm.php" method="post">
Form1 Builder runs directly in your browser. Your browser must support JavaScript and the Document Object Model. Current browsers all support these features. If your browser does not support these features a browser upgrade notification will be provided when you open Form1 Builder.
Form1 runs on your web server. To run Form1 your server must support the php scripting language. Most commercial web servers support php. For information on php and how to check if it is available on your server goto What is php?
If your downloaded software is compressed (.zip) it will require unzipping for use. Trial Zip software is available free from Winzip.
An online Form1 Builder is available at Try Form1 Builder. This allows you to test run the software without installing it on your computer.
You can also test an example Form1 based on a Quick Form at Try Form1. This allows you to submit and receive the delivery email from a base Form1 without installing it on your server.
You can Download Form1 Builder as shareware free for evaluation. The evaluation version includes all Form1 Builder functions and will operate for 7 days. To maintain software beyond evaluation you must Register Form1 Builder.
Form1 Builder runs in your web browser. If your downloaded software is compressed (.zip) it requires unzipping for use. Trial Zip software is available free from Winzip. To install simply unzip or run the downloaded file then open the file Form1Builder.html in your browser and follow the Instructions for Use.
Form1 (the actual forms) run on your web server. To run Form1 your server must support the php scripting language. Most commercial web servers support php. For information on php and how to check if it is available on your server goto What is php?
Please Note: Form1 code includes php scripting which may be corrupted by some html editors. To directly edit the actual Form1 code without using the Form1 Builder it is recommended that a text editor is used. If you wish to use a html editor we recommend (and use) HTML-Kit. HTML-Kit is a free standards compliant editor that unlike most html editors (Front Page, DreamWeaver etc) produces clean valid html and will not corrupt php scripts.
Once you have made your modifications save your form file and upload it to your web server. Then open Form1 in your browser i.e www.myserver.com/Form1.php.
You can make modifications to Form1.php and save each with a different file name to create multiple forms.
You can Register Form1 Builder online using our secure transaction processor for just $US37.00. As soon as your transaction is processed you will receive Registration Details and by return email.
Registered software can be freely used within your business to generate forms for any domain owned by the registered user. If you purchase a single user license (Quantity set to 1) the software must only be used with domains owned by the registered user. To utilize software with domains not held by the registered user additional licenses must be purchased for each Domain Owner Group. The number of licenses you purchase is the maximum Number of Domain Owner Groups with which the software can be used. To use the software with more than one Domain Owner Group you must purchase a Multi-user license by setting the purchase quantity to the required number of licenses.
For service, portal and network provider License details please Contact Us.
The specific suitability of this software must be independently assessed. Software is provided as is, use is entirely at the users risk, and use acknowledges that softSWOT and all associated parties are held harmless from any claims or losses relating to software provided.
For items not addressed here, in the online Help or in our Frequently Asked Questions page please Contact Us.
Web Site: www.softswot.com
softSWOT
15 Island View Court
Queensland, 4556, Australia.
ABN: 24 312 166 103
Telephone: +61 7 5445 5325
Regards
David Morcom
www.softSWOT.com