1.) Decompress(unzip) formtoemailX.X.zip to your local computer.
2.) Once the files have been unzipped you should see a folder named formtoemailX.X (X is the version you downloaded. IE: 2.1) Enter this directory then click
on the templates directory. Edit the templates to fit your websites look/feel.
Take care not to remove the variables in your templates I.E. <:<ERROR>:>
3.) Upload the folder with all of the contents to your web server.
4.) On your web server, enter the folder you just uploaded (formmailX.X). Enter the directory labeled "templates" change the permissions(CHMOD) to 777 on all
the template files in that directory.
5.) Go up one directory; change the permissions(CHMOD) to 777 on the directory "includes", & file named "ip.txt"
6.) Enter the includes directory change the permissions(CHMOD) to 777 on the file jconfig.php.
7.)
(optional) Go up 2 directories or to your webroot folder, and rename your formtoemailX.X directory. You may rename this directory to whatever you
wish: IE: contact, contactus.
8.)
Setting your variables. Load the admin script in your web browser: http://www.yourdomain.com/formtoemailX.X/form_admin.php .
The default password is demo.
9.) Once logged in click on "settings"
Edit the following:
- referrers: Separated by commas, this function will prevent spammers from entering an email address from your own domain name.
- blocked_domains: separated by commas, enter in the domain name extentions you wish to block from using your email script. IE: .ru,.tk will block any
email from that domain name extention.
- ademail: The Email address where the contents of your form will be sent.
- ccemail: If you wish to CC or send a copy to a specified email.
- bccemail: Same as above but a "Blind" copy sent.
- date_format: Shows current date. Uses PHP's date() variables. http://us3.php.net/manual/en/function.date.php;
- time_format: Same as above;
- email_to_admin_subject: The subject line of the email where the contents of your form is to be sent;
- send_auto: Send an autorepsonse message to the person who filled out the form. Uses templates/auto.txt file.
- email_to_client_subject: The Subject Line of the email if sending an auto response;
- req_fields: Requires a bit of skill. Separated by commas enter in any required fields on your form.
I.E. first_name,address,phone However the field names *MUST* match these names exactely. If first name is a required field then you must have <input
type=text name="first_name"> in order for this to function properly.
- adminpass: The administrative password for form_admin.php
- max_uses_per_day: How many times a user on your site is allowed to use the script. If they use it more than 1 or 2x, chances are they are just spamming;
- use_ajax: Advanced users. If you are using Ajax to send the contents of your form set this to 1 See ajax_form_example.html for details;
- error_invalid_admin_address: Error code shown when your admin address isn't valid. If you set up correctly, then there's no need for this error code.
- error_email_from_same_domain: Sometimes spammers will attempt to spam your contact forms by entering an email address that is from your own domain. This
little checker helps slow spam down so that you only get legitimate requests.
- error_invalid_domain: Invalid Domain name extention. If the user tries to send an email from one of your blocked domain extentions, this is the message
they will see.
- error_invalid_email_address: Error code shown when the users email address is invalid or blank.
- error_required_field_empty: Error code shown when a required field was left blank.
- error_invalid_password: Error Code shown when your administrative password entered doesn't match the password in your config settings.
- error_session_expired: Error code shown when your cookie has expired in your admin area.
- usmtp: Use SMTP server or standard php's mail() function.
- If above is turned on, then change the SMTP settings below.
- auth: SMTP authentication.
- helo: yourdomain.com
- smtpuser: Username of the email address you'll be using
- smtppass: SMTP password for this account;
- host: usually your domain.com;
- port: Standard SMTP port is "25";
- template_ext: The template extention ".txt" by default. If advanced users wished to use .html extention templates instead you would change this variable.
#######################
## GLOBAL VARIABLES: ##
#######################
<:<HTTP_USER_AGENT>:> - Gives you the web browser type.
<:<date>:> - Shows the date the script was accessed, according to the format you set in the date_format under your admin settings.
<:<time_format>:> - Shows the current time the script was used, according to the format you
set in the time_format under your admin settings.
<:<ip>:> - Shows the IP address of the user who accessed the script.
