~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


D F D   M A I L E R   1 . 1 2    D O C U M E N T A T I O N


Product Page:
http://www.dragonfrugal.com/open.source/software/dfdmailer/


Version 1.13+ Upgrading Check:
http://www.dragonfrugal.com/open.source/software/dfdmailer/check.version.php?dfd_mailer_version=1.13


Software Product Support:
https://www.dragonfrugal.com/php-bin/product-feedback/


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~




***********************IMPORTANT NOTICE FOR THOSE UPGRADING*********************** FROM version 1.11 or earlier...ajax.request.js is now renamed to ajax.request.js.php, so your website's forms will need updating (see step 3).




1) Hard-Code your email address in the "mailer.config.php" file:

$mailto_admin = 'you@yourdomain.com';



2) Copy the form mailer's application directory (folder) into your web space. A secondary directory named "php-bin" off your root web directory is recommended, so your FTP path may be for instance "/public_html/php-bin/form.mail/"...but this is not required. It just needs to be in your public html direcory.




3) In the head of the html document structure on your contact page (which can be anywhere, it doesn't need to be in the application's directory), there needs to be a link to the javascript file running the form mailer's ajax server connection. Note the section below where it says"/php-bin/form.mail/", you will need to change this if you installed this in a location different than "yourdomainname.com/php-bin/form.mail/":

<script type="text/javascript" src="/php-bin/form.mail/ajax.request.js.php"></script>




4) The form's opening tag needs to be modified to use the attribute values shown below, --and-- 2 additional div objects placed above it, with the second one not closing until ---immediately after the closing </form> tag--- way at the bottom of the contact form:

<div id="form_status"></div>

<div id="form_div_data">        

<form name="form_data_mail" action="" method="post">




5) Any email field's name and id attributes should be changed to "_Email" so the form mailer will automatically validate the email address to assure it appears correct (furthermore, additional emails can be validated by using the format "ANY-UNIQUE-NAME-HERE_Email" for other name and id attributes in other form fields):

<input name="_Email" type="text" id="_Email" />





6) The CAPTCHA security code field has to be added, and the field name/id attribute must always be the value "security_code"

<p>Please enter the security code: 
<input name="security_code" type="text" id="security_code" value="" size="8" /> &nbsp;&nbsp;
<script type="text/javascript">
document.write('<img src="' + compat_url() + 'captcha.php" alt="" border="0" align="top" vspace="0" style="border: 1px solid #808080;">');
</script>
</p>





7) The submit button has to be formatted / reformatted to run the ajax connection:

<input type="button" value="Submit Form" onclick="send_data();" />





8) Hidden form fields must be added to the form's html to submit data, ---and enable required fields--- seperate each required fiel's name/id with a "|" symbol

<input type="hidden" name="submitted" value="1" />
<input type="hidden" name="required" value="First Name|Last Name|_Email|security_code" />




9) To personalize a thank you message, you First Name / Last Name text fields should be something like this:

<input name="First Name" type="text" id="First Name" />

<input name="Last Name" type="text" id="Last Name" />




10) TROUBLESHOOTING EMAIL TRANSPORT ISSUES - If you have the javascript src path correct in step 3, have properly altered your form, and receive the thank you confirmation screen --but get no emailed data to your inbox-- then you may be on a server which does not have PHP's mail() function fully configured...so you'll want to try using your own SMTP server in the "mailer.config.php" file:

$winmail_bug = 1;   //    1 = ON    /    NULL = OFF   ... *****MUST BE SET TO 1 TO ACTIVATE USING THE BELOW SMTP SETTINGS*****
$smtp_domain = 'www.yourmailserver.com';   // Fill in your STMP mail's server address
$smtp_email = 'you@yourmailserver.com';   // Fill in the authorized email address handled by the SMTP server, to send the mail to
// The "$smtp_email" email address may need to be the same exact address as the "$mailto_admin" value atop the config file