CFX_Email2Image
Version 1.0

What is CFX_Email2Image?
CFX_Email2Image is a ColdFusion Custom Tag that enables your application to easily create an image from an e-mail address. Displaying e-mail addresses as images will prevent robots and spammers from scraping e-mails from your website. A JPEG or PNG file will be output on the file system that you can reference with an HTML <img> tag.

EXAMPLE

<cfx_Email2Image OUTPUTFILE = "C:CFusionMX7wwwrootemail.jpg"
                                   EMAIL = "myname@mydomain.com">

<img src="email.jpg" />

Installing CFX_Email2Image

1.) Copy the Email2Image.class file into your ColdFusion -> CFX -> java folder. On Windows, this folder is usually located at:
     C:CFusionJavaclasses or C:CFusionMXcfxjava

2.) Go to ColdFusion Administrator in your web browser, then click on CFX Tags (under Extensions)

3.) Click Register Java CFX

4.) For Tag Name, type: CFX_Email2Image For Class Name, type: Email2Image

5.) Submit Changes

6.) You may need to restart your ColdFusion server for the changes to take effect

DOCUMENTATION

Return Variables

EMAIL2IMAGE_MESSAGE

Contains any errors generated by the tag, or "OK" if everything completed successfully.

Syntax

<cfx_Email2Image OUTPUTFILE = "string"
                                   EMAIL = "string"
                                   FONTFACE = "string"
                                   FONTSIZE = "integer"
                                   FONTCOLOR = "hexadecimal integer"
                                   FONTSTYLE = "string"
                                   BGCOLOR = "hexadecimal integer">

Note: Make sure that you place quotation marks around all attributes, including integer and boolean attributes.

Attributes

OUTPUTFILE
Required. The absolute path to the image that is output by cfx_Email2Image.
Valid File Types: jpeg and png
Example: OUTPUTFILE = "C:myimage.jpg"

EMAIL
Required. The email used to generate the image.
Example: EMAIL = "myemail@mydomain.com"

FONTFACE
[Default = Arial]
Optional. The font face associated with the EMAIL.
Note: The availability of font faces will vary depending on your server. Common fonts are Arial, Courier, Times New Roman and Verdana.
Example: FONTFACE = "TimesRoman"

FONTSIZE
[Default = 14]
Optional. The font size associated with the EMAIL.
Example: FONTSIZE = "32"

FONTCOLOR
[Default = 555555 (medium grey)]
Optional. The hexadecimal equivalent of the RGB color associated with the EMAIL. If you are unfamiliar with hexadecimal colors, http://www.december.com/html/spec/color.html offers help choosing the right hex value.
Example: FONTCOLOR = "FF0000"

FONTSTYLE
[Default = Plain (no style)]
Optional. The font style associated with the EMAIL.
Values: bold, italic, both
Example: FONTSTYLE = "bold"

BGCOLOR
[Default = FFFFFF (white)]
Optional. The hexadecimal equivalent of the RGB background color for the image. If you are unfamiliar with hexadecimal colors, http://www.december.com/html/spec/color.html offers help choosing the right hex value.
Example: BGCOLOR = "FF0000"