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.
We also provide Form1 Builder software to make form building even easier. This software runs directly in your browser and will generate Form1 forms with a couple of clicks. Form1 Builder software is also available free for evaluation, you can even Try Form1 Builder online.
Form1 is a single file web form and form to email processor. Form1 provides a fully customizable form and the script for processing and delivering form submissions to your email address. All you need to do is input your Form1 delivery email address using a text editor, upload Form1 to your server and you have a fully functional form, without the need for additional form processing cgi scripts. You can also modify, add or copy html code to create a form to your exact requirements.
Form1 incorporates your delivery email address in its php server side code. Your delivery email address is not displayed in browsers or browser source code and cannot be harvested by spam emailers unlike standard form processing scripts which include your delivery email address in the web page source code.
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?
Download and unzip the Form1 software. Before you Install Form1 on your server you can edit the User Configuration Settings and the html form code to suit your requirements.
To do this open the file Form1.php (included in the downloaded zip file) in your text editor. Form1.php is an example Quick Form that can be used as a base to build your form by simply:
You can make modifications to Form1.php and save each with a different file name to create multiple forms.
To make building your forms even easier we also offer Form1 Builder software. This software runs directly in your browser and will generate Form1 forms with a couple of clicks. Form1 Builder software is available free for evaluation.
Initially it is recommended that you simply add your Form Delivery Email Address to the example Quick Form, save it as a file with a .php extension (i.e QuickForm.php). Some servers require files to have the extension .php before they will execute php code. If using NotePad as your text editor when you Save, select Save As Type "All Files" and then provide the full File Name i.e "QuickForm.php" to ensure a .txt extension is not applied to the file. Then upload the file to your web server and open the form in your browser i.e www.myserver.com/QuickForm.php to give it a test run.
Once you have seen Form1 in action on your server you can adjust other Form1 variables, the html code or add the Form1 php processing code to the top of existing web forms to tailor Form1 to meet your requirements.
At the top of the file Form1.php is the php form processing code. This includes the following User Configuration Settings below the line #### Start User Configuration Settings:
Using a text editor open Form1.php and adjust these settings to suit your requirements. 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 to an existing form open Form1.php in a text editor and copy the php code from the top of the file 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 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?
Downloaded software is compressed and requires unzipping for use. Trial Zip software is available free from Winzip.
A sample version of Form1 is available at Try Form1. This allows you to preview the software without installing it on your server. You can input your name and email address then submit the form to receive a copy. If you view the form web page source code you will see that the delivery email address is not available to browsers. This protects it from being harvested by spam mailing lists.
You can Download Form1 as shareware free for evaluation. The evaluation version includes all Form1 functions and will operate for 7 days. To maintain software beyond evaluation you must Register Form1.
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?
Downloaded software is compressed and requires unzipping for use. Trial Zip software is available free from Winzip. To install simply unzip the downloaded file, open the file Form1.php in your in your text editor (i.e NotePad) and follow the Instructions for Use to modify Form1.php as required.
Please Note: Form1 includes php scripting which may be corrupted by some html editors. It is recommended that a text editor is used for all modifications. 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 online using our secure transaction processor for just $US15.00. As soon as your transaction is processed you will receive Registration Details and Download links by return email.
Registered software can be freely used within your business with 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