Jay's PHP Form to Email with Anti-Spam Features Documentation for Version 2.5 If you aren't using at least Version 2.5 Please upgrade or install the latest version now. 1.) Installation 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. 2.) Standard form example Once you've set up your script, you'll then need to set up a form for your website. You can use the examples to set up a standard form, or an Ajax form. The Ajax form is a little more complicated, while the standard form is a little easier to get set up and running. Please take note of the action="" in the copy/paste code. This code assumes that your form is in the same directory as your contact.php script will be. Otherwise you'll need to change the action="contact.php" to point to the correct path to your contact script. For example: If you created a folder on your server named "contact" or "formail" where you've uploaded the files for this script, but your form is outside of that directory; let's say on your home page of your website. Then you'll need to change the path in action="contact.php" to action="contact/contact.php". The same applies to the img src="" tag, *if* you are using CAPTCHA. Name: Email: Comments: CODE: Highlight and Copy Code Below <FORM METHOD="POST" action="contact.php"> <table align=center><tr><td>Name: </td><td> <input type=text name="Your_Name" size=30></td></tr><tr> <tr><td>Email:</td><td> <input type=text name="email" size=30></td></tr><tr> <td>Comments:</td><td><textarea name="comments" cols=30 rows=5></textarea></td></tr><tr> <td bgcolor=#EEEEEE colspan=2 align=center> <input type=submit value="Submit"> <input type=reset value="Reset"> </FORM></td></tr></table> CODE WITH CAPTCHA INCLUDED: Highlight and Copy Code Below <FORM METHOD="POST" action="contact.php"> <table align=center><tr><td>Name: </td><td> <input type=text name="Your_Name" size=30></td></tr><tr> <tr><td>Email:</td><td> <input type=text name="email" size=30></td></tr><tr> <td>Comments:</td><td><textarea name="comments" cols=30 rows=5></textarea></td></tr><tr> <TD colspan="2" align="center"><img src="includes/captcha.php?.png" alt="CAPTCHA"><BR> Enter in the Information above. (cAse SeNSItivE!)<BR> <input type="text" name="captchastring" size="30"> <BR> </TD></TR><TR> <td bgcolor=#EEEEEE colspan=2 align=center> <input type=submit value="Submit"> <input type=reset value="Reset"> </FORM></td></tr></table> 3.) Ajax Form to Email Example If you aren't using at least Version 2.5 Please upgrade or install the latest version now. 1.) Copy / Paste the code from the text area below into your webpage. 2.) If need be, edit the variables found in your javascript code. Edit the URL path to your contact.php script. IE: /contact/contact.php, or http://yourwebsite.com/contact/contact.php var url = "contact.php"; If using ajax then this is the id name of your div tag that will display the results of your form. If you copy pasted the code from the example you wont have to change this If you have your own form you'll need to create a <div and/or <span with an id="something" assigned to it and fill it in here. var jform_results = 'f_results'; Name of your submit form button If you copy pasted the code from the example you wont have to change this if you have your own form you'll need to create a button like so: <input type=button value="something" onclick="getFormElements(('nameofform')" name="something"> fill it in here. var sub_btn = 'sub_btn'; CODE: Highlight and Copy Code Below <script language=javascript> //the URL path to your contact.php script. //IE: /contact/contact.php, or http://yourwebsite.com/contact/contact.php var url = "contact.php"; //if using ajax then this is the id name of your div tag that will display the results of //your form. If you copy pasted the code from the example you wont have to change this //if you have your own form you'll need to create a <div and/or <span with an id="something" assigned to it and //fill it in here. var jform_results = 'f_results'; //name of your submit form button //If you copy pasted the code from the example you wont have to change this //if you have your own form you'll need to create a button like so: // <input type=button value="something" onclick="getFormElements(('nameofform')" name="something"> //fill it in here. var sub_btn = 'sub_btn'; /* leave the rest alone. unless of course you know what you're doing. ###################################### */ //thanks too: javascriptkit.com //create ajax request for users specific browser. function ajaxRequest(){ var activexmodes=["Msxml2.XMLHTTP", "Microsoft.XMLHTTP"] //activeX versions to check for in IE if (window.ActiveXObject){ //Test for support for ActiveXObject in IE first (as XMLHttpRequest in IE7 is broken) for (var i=0; i<activexmodes.length; i++){ try{ return new ActiveXObject(activexmodes[i]) } catch(e){ //suppress error } } } else if (window.XMLHttpRequest) // if Mozilla, Safari etc return new XMLHttpRequest(); else return false } /* end ajax call */ //1-30-09 added check for radio and checkboxes. // //3-16-09 updated ajax calls for cross-browser functionality. //updated getFormElements to allow any form name. //need to add for selection boxes.// // hello? is Ajax there? Who's calling? IE, Chrome? Firefox? Opera? // I'd like to send the contents of my form if you're not too busy. thanks! var getajxdta= new ajaxRequest(); function getFormElements(x){ //if no x passing then use the first form on the page and hope the user doesn't have any other forms // on the page. If they do, hopefully it's the first <form tag. yay! if(!x) { x = 0; } var formlength = document.forms[x].elements.length; var frmnames = new Array(); var frmvls = new Array(); var postvars = "?"; for(i=0;i<formlength;i++) { //for checkboxes and radio buttons // if(document.forms[x].elements[i].type == 'radio' || document.forms[x].elements[i].type == 'checkbox') { if (document.forms[x].elements[i].checked) { frmnames[i] = document.forms[x].elements[i].name; frmvls[i] = document.forms[x].elements[i].value; } else { frmnames[i] = ''; } } else { frmnames[i] = document.forms[x].elements[i].name; frmvls[i] = document.forms[x].elements[i].value; } frmvls[i] = escape(frmvls[i]); frmvls[i] = frmvls[i].replace('+', '%2B'); frmvls[i] = frmvls[i].replace('%20', '+'); frmvls[i] = frmvls[i].replace('*', '%2A'); frmvls[i] = frmvls[i].replace('/', '%2F'); frmvls[i] = frmvls[i].replace('@', '%40'); if(frmnames[i]) { postvars += frmnames[i] + "=" + frmvls[i] + "&"; } } //postvars = escape(postvars); //document.forms[x].postedvars.value = postvars;return; jsend_mail(postvars,x); } /* send email */ function jsend_mail(postvars,frmname) { //3-26-2009 changed += to var turl= url + postvars because //it was doubling up on get vars when using ajax. var turl = url + postvars; document.forms[frmname].elements[sub_btn].disabled = true; document.forms[frmname].elements[sub_btn].value = 'Sending..'; if(getajxdta) { getajxdta.open("GET", turl,true); getajxdta.onreadystatechange = function() { if(getajxdta.readyState == 4 && getajxdta.status == 200) { var obj = document.getElementById(jform_results); obj.innerHTML = getajxdta.responseText; } } getajxdta.send(null); } document.forms[frmname].elements[sub_btn].disabled = false; document.forms[frmname].elements[sub_btn].value = 'Submit'; } </script> <FORM name=me OnSubmit="return false;"> <table align=center> <tr><td colspan="2" align="center"> <div id="f_results" style="background-color:#FFFFFF;color:red;font-size:16px;border:dashed 1px #000000;padding:5px;"> Position this <Div> anywhere you want to display the results of your email and/or any errors. </div> </td> </tr> <tr><td>Name: </td><td> <input type=text name="Your_Name" size=30></td></tr><tr> <tr><td>Email:</td><td> <input type=text name="email" size=30> </td></tr><tr> <td>Comments:</td><td><textarea name="comments" cols=30 rows=5></textarea></td> </tr><tr> <td bgcolor=#EEEEEE colspan=2 align=center> <input type=button value="Submit" onclick="getFormElements(this.form.name)" name='sub_btn'> <input type=reset value="Reset"> </FORM></td> </tr> </table> Position this <Div> anywhere you want to display the results of your email and/or any errors. Name: Email: Comments: