HTMLMAIL.PHP Version 2
HTML-Formatted Email Module for Phorm

The purpose of this module is to allow you to send HTML-formatted email and 
responder messages. If you have this plugin installed and your email or 
responder template file has the extension .html, the message will be sent in 
HTML format.

INSTALLATION
To install this module, unpack this archive file in your plugins directory. To 
use it with your responder, add the following line to the registry file 
registry.php:

< respn htmlmail.php

To use it with the email sent to you add this line:

< email htmlmail.php

There is also a PHP3 version of the plugin (just use htmlmail.php3 as above). 

This distribution also contains HTML versions of the email and responder 
templates for the "Widgets Inquiry" and "Warble Specification" examples in the 
Phorm distribution. Simply copy the files to the respective template folders 
in the Phorm examples folder.

USE
To use this plugin, give your responder or email template file a .html 
extension, add whatever HTML formatting to it that you desire, and set your 
$PHORM_RESPOND or $PHORM_TMPL variable accordingly.

If you wish to include images in the HTML and have them attached to the 
message, the image files must exist in the same directory as the templates,
or a directory below it. The subdirectory or subdirectories can be called 
whatever you like, just include the relative path in the SRC attribute of
your IMG tag. For example:

  <IMG SRC="images/pic1.jpg">

IMG tags with http:// in the SRC attribute will be left as-is, and of 
course the image will not be attached. Some email programs cannot process
http:// SRC references, or may be configured not to.

IMAGE type INPUT tags and the BACKGROUND attribute of the BODY and TD 
tags will also be processed. Bear in mind that some people still have slow
connections, so you might not want to get too carried away with attaching
graphics files.

Also, some email programs cannot render HTML, or may be configured not to.
If there is a file by the same name as your HTML template, but with a .txt
extension, it will be included in the message. For example, if your responder
template is in responder.html, you would put the plain-text version of the
message in responder.txt. Email programs that can render HTML will show the 
HTML version of the message; those that cannot will show the plain-text 
version. This is recommended, unless you specifically wish to limit your 
message to people whose email programs will show HTML.

That's all there is to it!

NOTE: I believe my message encoding is standard, but some cases, Outlook and 
Outlook Express have trouble recognizing the HTML segment of messages 
generated by this plugin, and instead just display the HTML tags. The 
maddening thing is that they only *sometimes* have trouble. I use a different 
email client, but I have OE installed on my system, and of course it displays 
the messages just fine, which means I can't troubleshoot it. I've also had 
other Outlook/OE users tell me it worked fine for them. So until I get a 
chance to figure out some way to troubleshoot this and get it debugged, my 
advice is to go ahead and use this plugin if you don't mind the fact that some 
percentage of Outlook/OE users will not be able to display it properly. I'll 
keep looking into it; any input from persons knowledgeable about message 
format is welcome.

NOTE: if you are a registered user and have the file attachment module,
this plugin will not work with the version of that module that you 
received if you registered before Phorm v3.0.3. Contact Holotech for
an update of the file attachment module if you wish to use it in
conjunction with this plugin.

===========================
Copyright (c) 2002 Holotech Enterprises (phorm@holotech.net) You may freely 
distribute this program as-is, without modifications, as part of a valid Phorm
distribution. If you are not sure whether you have a valid distribution, 
you can obtain one from http://www.phorm.com/. You may use this program 
freely, and modify it for your own purposes.