08.May.2009 revised 21.May.2009 revised 12.Jul.2009 revised 13.Jul.2009 for V 2.2.2 HEFS BULLETIN - THIS IS VERY IMPORTANT!! If you haven't done so already go sign up for the HEFS Bulletin http://JSH.us/hefs-bulletin The bulletin is not issued often, but by signing up you will get the LATEST info, including info on new releases. People frequently write me about problems that would have been solved if they had just received the latest updates. Please Sign Up! PLEASE DO NOT SKIP THE DOCUMENTATION You do not have to read the whole thing. And if you hit a snag you can email me. But PLEASE go to page 1 and start there. I've added a lot to help you. For example, I've reordered the manual to save you time. You do NOT need to read the whole manual, but please go to page 1 and start there. RECENT CHANGES This release now includes new documentation User Manual for Huggins' Email Form Script V2.2.2 5-01-058.doc and Host Issues for Huggins' Email Form Script V2.2.2 9-01-058.doc These new documents are significant "rearrangements" of the prior versions to improve flow and readability for new users and to truly help new users who want to follow directions instead of just launching into the script and trying things. No new script functionality is included with these changes. A prior version (2.1.2) corrected two "bugs" identified by Robert Walto (1) error E023 was reporting low-value instead of high-value in the error message; this caused the error message to not make any sense (2) in checking for "OFF" within MsgxFieldNameValueSubstitutionList the program was using "off" instead of OFF; correcting the case solved this problem Version 2.2.0 changed variable names. MsgxAddressesAndSubjectDropDown is changed to MsgxLabelSubjectAndAddressesDropDown. This variable name does not change functionality but more accurately reflects the contents of the variable. If you use the prior variables in your parameters, you must change the name. Version 2.2.1 slightly modifies one error message. Version 2.2.2 modifies an error message (C005) to significantly increase functionality. UPLOADING THE SCRIPT A client recently had a problem. It turns out he uploaded the script incorrectly and it was loaded "damaged" onto his server. This was caused by using incorrect FTP settings. You must upload the script as ASCII. If you your FTP tool uses "autodetect" it might upload as BINARY instead of ASCII. You MUST upload as ASCII. If you use "autodetect", be sure to set your FTP tool to recognize both "FTP" and "FTP5" as needing ASCII. Do NOT upload as binary. If you do not do this, the script will fail in SOME but not all cases. REQUIREMENTS To use the V2.2.2 version of Huggins' Email Form Script, your web host must provide the ability to process PHP. While the script can provide minimal functionality with most versions of PHP 4, and enhanced functionality with most versions of PHP 5, full functionality requires at least PHP 5.1. But, if your webhost doesn't support at least PHP 5.1, contact them immediately. I would also appreciate a brief note about their laggard performance. PHP 5.1 was released on 24.Nov.2005 ... more than 3 years ago. If your host is that far behind the curve and you want to move to a more up to date host, write me. I know a couple I can recommend. SPECIAL NOTE ON THE PHP5 FILE TYPE This is covered in the manual. But many don't read the manual. Do you? The script ships as huggins-email-form-script-v2.2.2.php5.txt You have to change it to huggins-email-form-script-v2.2.2.php5 by taking off the ".txt" part However, that may not work on your server. If not, change it to --- huggins-email-form-script-v2.2.2.php That is, change .php5 to .php if your host/server does not support ".php5". Only a few do. Mine does. Most do not. Your's may not. Note that if you do that, you have to change the references to it also. REVISED MANUAL The latest manual is --- User Manual for Huggins' Email Form Script V2.2.2 5-01-058.pdf All known issues with this documentation have been addressed. Please advise of any issues you detect. Note that the script version number (2.2.2) now appears earlier in the documentation name and the formal documentation number now appears last. This minor name "order" change is true for both --- User Manual for Huggins' Email Form Script V2.2.2 5-01-058.pdf and --- Host Issues for Huggins' Email Form Script V2.2.2 9-01-058.pdf CONTENTS These are the contents of this release packet --- 0 READ ME FIRST V2.2.2.txt --- 0 READ ME SECOND V2.2.2.txt --- 0 READ ME THIRD V2.2.2.txt --- check-info.php5.txt --- HEFS Acknowledgment Link V2.2.2.txt --- HEFS Form Statement and Hidden Field Parameters V2.2.2.txt --- HEFS Form Statement and Hidden Field Parameters V2.2.2 for XHTML.txt --- hefs-mail-test-v2.2.2.htm.txt --- hefs-mail-test-v2.2.2.php.txt --- Host Issues for Huggins' Email Form Script V2.2.2 9-01-058.pdf --- User Manual for Huggins' Email Form Script V2.2.2 5-01-058.pdf --- huggins-email-form-script-v2.2.2.php5.txt --- simple-html-email-form-v2.2.2.htm.txt EMAILING ME If you have any problems please email me at JHuggins@JamesSHuggins.com and please include "HEFS V 2.2.2" somewhere in the email subject. ALSO, always be sure to include 1) your phone number 2) your time zone 3) when I can call you SPECIAL NOTICE FOR CRICKET'S CLASSES If you are pointing to my server to test your forms as part of a Cricket class, you must change the pointing to reference http://www.JamesSHuggins.com/p/huggins-email-form-script-v2.2.2-xxxxxxxx.php5 where "xxxxxxxx" is the "access code" for Cricket's class. Note that the new features of a) the error page template and b) the CSV file will NOT work if you use the script on my server.