OneGuy Productions - Dynamic Solutions For The Small Business

Using FMailCD On Your Website

FMailCD v3.0 is available for use. Although it has been thoroughly tested, there is a chance that application bugs could still be present. If you use FMailCD v3.0 and run into problems, contact us for assistance here.

The FMailCD v3.0 Wizard is now complete to help you set up your form!

Click Here to get started building your form.

This page provides all of the details necessary for getting FormMailCD v3.0 to work on your web page.

If you use FMailCD 3.0 on your website, it would be appreciated if the following were added to the page with the form that calls the application.

<div align="center" style="font-family:Arial,Helvetica;font-size:10px;color:#000000;">Free Form-To-EMail Gateway<br><a HREF="http://www.oneguy.com" TARGET="_blank"><img SRC="http://www.oneguy.com/fmailcd/images/fmcdtile.gif" ALT="FMailCD v3.0 - Free Form-To-EMail Gateway" BORDER="0"></a></div>

This displays the following link:

Free Form-To-EMail Gateway

FMailCD v3.0 incorporates several changes that have been requested by users over the last couple of years. If you are upgrading from a previous version of the FMailCD application, be sure to pay attention to the modifications necessary for the new version to function properly.

FMailCD v3.0 is designed to be configured using hidden fields in the form being submitted. These fields provide processing information to the FMailCD v3.0 application that determine how and where the results email is sent, along with what to do after the email has been delivered. This can range from redirecting to an alternate URL, or displaying a customized page.

To include file attachements with with your email, use the <INPUT TYPE=FILE> tag in your form definition. Multiple files can be selected this way, but the total size of all files can not exceed 175KB. This is a limit established by OneGuy Productions to avoid potential misuse of the FMailCD application.

To begin, use the following command in you HTML document to set up the FMailCD v3.0 form:

This is a change from version 1.0 and 2.0 with the addition of file attachments, the ENCTYPE parameter must be included .

The following table contains the list of fields that can be included in the form definition to customize the email messages generated from the form. The fm_to, fm_from and fm_subject fields are required, all others are optional.

Field Name

Description

Default Value

Comments

fm_to The email address to use for delivery of the generated email This field can be type HIDDEN or TEXT to accomodate input from the user.

fm_from The email address to use as the return address of the generated email This field can be type HIDDEN or TEXT to accomodate input from the user.

fm_mailserver The mail server to use for origination of the generated email mail.oneguy.com There is typically no reason to change this value. Useful only if you want emails to originate from a local mail server.

fm_subject The text to use as the subject line of the generated email Web Page Form Submission

fm_mailheader The first line of text to include in the email message body. This information has been submitted from a web page

fm_MailFormat The type of format to use for sending the email. EMails can be generated in HTML or Plain Text. HTML Allowed values are "HTML" and "TEXT"

fm_mailonly This flag controls the removal of the form field names from the generated email. Show both field names and values Use VALUE="Yes" to only include form data and not form field names.

fm_includeIP This flag controls inclusion of the IP Address of the user submitting the form. IP Address not included Use VALUE="Yes" to include IP address in generated email.

fm_includeURL This flag controls inclusion of the page URL of the page submitting the form. URL not included Use VALUE="Yes" to include page URL in generated email.

fm_includeMailFrom This flag controls inclusion of the From address in the body of the email message. Mail From address not included Use VALUE="Yes" to include From address in generated email.

fm_includeMailTo This flag controls inclusion of the To address in the body of the email message. Mail To address not included Use VALUE="Yes" to include To address in generated email.

fm_includeMailSubject This flag controls inclusion of the Subject line in the body of the email message. Mail Subject not included Use VALUE="Yes" to include Subject line in generated email.

fm_ForPager This flag controls delivery of a full version of the email, or a stripped down version for use with pagers and cell phones. Generate as normal email Use VALUE="Yes" to send version of email designed for pagers. If enabled, automatically changes mail format to plain text.

fm_CopySender This flag controls sending a blind copy to the From address specified in the fm_from field. No copy sent to sender Use VALUE="Yes" to send a blind copy of the email to the From address

fm_CheckOnly This flag will test configuration of the submitted form without generating any emails. Normal operation Use VALUE="Yes" to test configuration of the form.

fm_BlockIP This allows blocking of individual or groups of IP addresses. No IPs are blocked Use a comma delimited string of any combination of IP addresses or groups of addresses.

Ex. Value="192.168.0.2,192.168.10.*,192.168.20.*"

fm_MailFooter Add a custom footer to the generated email No footer is added Use the text or HTML of the custom footer for the VALUE of the form element.

The following optional fields are used to configure the results page displayed after the email has been sent. Any fields that are omitted will be set to the default value, or not included in the resulting web page.

Field Name

Description

Default Value

Comments

fm_privateURL This specifies a page to redirect the user to after the form is submitted. Overrides all other display configuration tags. None If this tag is used, no other optional display tags will be processed.

fm_StyleSheet The full path to a style sheet (including http://) to include in the resulting web page. None The style sheet must be accessible from a web server, not just as a directory on a local machine.

fm_Background Background image for the results page None

fm_BGColor Background color for the results page #ffffff (White)

fm_FontFace Font Style (Family,Face) Times New Roman

fm_FontSize Font Size None

fm_TextColor Normal Text color #700000 (Medium Red)

fm_LinkColor Link color #0000ff (Blue)

fm_VLinkColor Visited Link color #000033 (Dark Blue)

fm_ALinkColor Active Link color #ff0000 (Red)

fm_SuccessText Text to be displayed to notify the user that the form was submitted successfully The form has been successfully submitted.

fm_TextInstruct Instructions to the user on how to continue after submitting the form None

fm_ReturnURL URL to return to when user follows the continue instructions None

fm_ReturnTitle Title of the page specified in the fm_ReturnURL field None

fm_NoReturn Flag to control showing or hiding the Return URL and Return Title fields. Useful if the form was submitted in a framed environment. Enabled

fm_ImgSuccess Image to display if the form submission was a success None

fm_PageTitle Title to apper in the browser title bar for the results page. None

fm_Body1 Miscellaneous text to include in results page. None

fm_Body2 Miscellaneous text to include in results page. None

fm_Body3 Miscellaneous text to include in results page. None

fm_Body4 Miscellaneous text to include in results page. None

Avoid using "fm_" as the first 3 characters of any fields in your form that are not FMailCD configuration fields. The application will not include any fields whose name starts with "fm_" in the resulting Email.