easiForm 

 

 

 

Home | easiForm Examples | easiForm | Buy easiForm | Download Demo | Contact Us | [] [1]

 

 

 

 

 

 

 

easiForm is a php mail script for web forms that allows the user to customise these forms but takes all the work out of the scripting side. It also offers reasonable protection against spam bots from using your form. easiForm will offer more protection or your form against spam usage out of the box but using easiForm with easiCaptcha or easiCaptchaM (included with the easiCaptcha 1.3 package) will offer even more protection.

Set up your web forms easily and quickly, easiForm consists of 1 php script, a decrypt loader folder and a configuration file that you can use to adjust easiForms's settings... if you feel you want to. No knowlage of php is needed and easiForm will auto detect the use of easiCaptcha or easiCapchaM if used together so no alteration to any scripts is needed for these. (You will need to add a couple of supplied lines of code to your form)

easiForm needs php 4.2.0 or above to be running on the server where it is being used.

 

 

 

 

 

Freeway tutorial: easiForm with Freeway

Have a look at: easiForm Examples

 

 

 

 

 

*

What do I need to use easiForm?

 

 

 

 

 

1# A copy of easiForm, you can use a demo to get everything up and running: Download Demo

2# You need a web form, this can be written by hand, in Dreamweaver, in Freeway or any other program used to create web sites with, you can even use one of the ones in our examples and edit it to suite your needs.
NOTE: easiForm does not create your form or thanks page, it is only the script that processes these.

3# A loader file to decrypt the easiScript, the loaded used depends on the system and server type that the easiScript is used on. The default download of easiForm includes the loaders needed for both Windows and Linux servers, if you need a loader for another server type such as OSX, FreeBSD, Solaris or other then those loaders can be downloaded from the ioncube loaders download page. If you are unsure as to which loader to use or have other questions you can Download a folder that will check the loader you need, or if you are having problems you can Contact us.

Note: The form page generally needs to end in .php, so this following name would not work: 'myform.html' it would need to be: 'myform.php' unless the form page notation is set to be parsed as php on the server easiForm is used on.

 

 

 

 

*

How much does easiForm cost?

 

 

 

 

 

The license for easiForm is $20 per domain (Not IP Address) or $30 as an easiForm and easiCaptcha or easiCaptchaM bundle, this allows as many copies of easiForm to be used on the same domain it is registered for. Once bought a license cannot be used for any other domain than the one it has been registered for, nor is it interchangable under any circumstances. Buy easiForm.
You should Download the Demo and get your form up and running before you buy, then you know it works on the server it is registered for.

 

 

 

 

*

How does easiForm work?

 

 

 

 

 

Basically easiForm will loop through the form variables, checking to see if there is spam behaviour and if any of these are REQUIRED values, if all is well it will send the message or information by email using PHP's mail() function, any user errors will be returned in a variable string as will an error for each REQUIRED field that does not contain a value. Using the config file settings you can show form errors in different ways, these can be shown as a list of errors and/or using the variable of 'elementname_err' be used to print the element title text in red or other colour.

easiForm can be set to send a confirmation to the user, it can be set to use a randon number in the subject for tracking etc. if you have selected those options in the config variables, see the next section for the options that are available.

easiForm will make checks for spam bots and allows easy integration of easiCaptcha and easiCaptchaM to make your form even more secure.

Cookies need to be enabled to use easiForm with easyCaptcha but are not needed for easiForm on it's own.

^-- Top

 

 

 

 

*

Setting form element values?

 

 

 

 

 

Setting up your form is fairly simple, the important thing is:

1. How you set each field name:

$f, names of form values set as array values, the e-mail field must be set called $f[email], if you where setting this by hand then it might look like:

<input name=f[name] value="<?php echo $f[name]; ?>" size=25>

It is common practice to use an array item as: $f['name'] but with easiForm array items on the actual form should be used without the quotes, e.g. the name as: f[name] and the value as $f[name]

2. The name of your form Submit button:

The submit button must be called 'submit', just as I have written here, lowercase but without the quotes. If you where setting this in code it would be set as:

<input type=submit name="submit" value="Send">

^-- Top

 

 

 

 

*

What control do I have?

 

 

 

 

 

There are many options you can edit in the easiForm_config.php file but it you only want to get things working without delving into all the other options then you need only set the first two RECIPIENT, ONSUCCESS and the REQUIRED values, the rest are all set to default values which you can change if required:

$RECIPIENT, the e-mail address of who the form should be sent to, permits one email address only to be passed with this variable.

$ONSUCCESS, the path to and/or including the thanks page used for a successful form submission.

$ACTSUCCESS, set to 0 to include the thanks page, 1 to redirect to the thanks page or 0 to just load the form again. $easiMail_success will be set to true on success.

$REQUIRED, a string value consisting of the field names you require the user to use on the form, the value of $f[email] is set as a required value by default and so must be used on any form handled using the easiForm script.

$SUBJECT, allows you to set a subject of your liking, 'Web contact' will be used if this value is empty.

$FROMEMAIL, in case the from email address should be differenct than that of the addresss used in $RECIPIENT.

$MAILOPEN, set the text the message to you should start with.

$CONFIRM, option to also send a confirmation email to the sender.

$TEXTWRAP, string of field names to wrap the text on, this can be used for message and or comment type fields where the text would be better formatted in email if wrapped at a specific length.

$WRAPTO, the number of chars to wrap any values set in the $TEXTWRAP variable.

$NOTALLOWED, string of words not allowed to be used in the form email fields.

$CONOPEN, text string to start any confirmation message with.

$F_WEB, Website for confirmation footer signature if used.

$F_EMAIL, E-mail for confirmation footer signature if used.

$F_LINE, Hyphenated line for confirmation message if used.

$FOOTER, any footer text for any confirmation message.

$SETRAMDOM, Set as a string to start a random number with, if used will add a random number to the subject so message tracking can be used.

$BLOCKDOM, set to 0 to allow an email address cotaining the host domain, 1 to block an email using the host domain or 2 to block any email address containing the host domain and any other dot notation of the same.

$BLOCK_HTML, set to 0 to allow an email address cotaining html code, 1 to block an email using html code or 2 to block any email containing html code.

$STZ, server time zone for date stamp in messages.

$BASICERR, select to clear the field names in the error string, can be used to show a sting of errors or not, this way the user can use the specific field name errors for their own custom error style, for example: setting their field names in a colour or highlight.

$EF_N, Number any form errors.

$EF_N_S, Set to use a char after any $EF_N error number.

Users have also access to any langusge strings output by the form so easiForm can then easily be used with different languages, these values are set at the end of the easiForm config file.

^-- Top

 

 

 

 

*

Do I get access to the code for easiForm?

 

 

 

 

 

No, easiForm comes as 2 files and a 'Ioncube' folder, the code content of the easiForm script is encrypted 'non readable', the configuration script is not encrypted and can be edited with a text editor. easiForm is distributed like this so no one can alter it or know it's structure therefore making it more secure.

^-- Top

 

 

 

 

*

Do I need to add any code to my form to use easiForm?

 

 

 

 

 

Yes, but it is very simple, you just need to copy the code from the fields below and follow the directions:

 

 

 

 

 

1# This needs to be added to the very top of the form, before the <HTML> tag is a good place:

 

 

 

 

 

<?php
if($_POST['submit']) {
include_once('easiForm_mail.php');
}
?>

 

 

 

 

 

Tip: If you use a title for a field or element then call the field or element by the same name, if you use say 'First name' as a title then use f[first_name'] for the element name and value, this way when there is a user error the error text will remove the '_' and report the error to the user as: "The field name 'Field name' needs a value", so the user will know instantly the field they have made an error on.

 

 

 

 

 

2# OPTIONAL - Use the following just above the first field of your form. (Recommended)

 

 

 

 

 

This is best to be used as it will return feedback to the form user, it is not imperative to the fuction of easiScript but it is recommended so your users know when they have made an error.

 

 

 

 

 

<?php
if($ef_errors!='') {
echo $ef_errors;
} else {
echo 'Field names marked in bold are needed.';
}
?>

 

 

 

 

 

3# OPTIONAL - Use for custom field errors

 

 

 

 

 

Note: If you have named a field or other element in the easiForm_config.php files $REQUIRED string, now lets say the user didn't fill in a value... a variable will be created for that element and set to true, so if you used a field and set it's name to 'f[name]' with it's value set to '$f[name]', an error variable called '$name_err' would be created and set to true. Now you can use this to customise your forms using a little PHP with css or html, for example if there is an error it can be used to set the element title text to Red, the folowing example shows a little PHP and html:

 

 

 

 

 

<?php
if(isset($field_name_err) {
echo '<b><font color=red>Field name:</font></b>';
}
else {
echo 'Field name:';
}
?>

 

 

 

 

 

 

 

 

If you are using Freeway to build your web form with then there are Freeway 4 Pro examples here.

^-- Top

 

 

 

 

 

 

 

 

 

Copyright © Mike Brackenridge 2006 - 2022