home SideBar
login User Login


Forgot Password? | Register


3-1-Tags:CFMailParam

last edited byusericonlmajano on 23-Aug-2009

Contents

cfmailparam

Description

Sets a header or attach a file to an e-mail.

Category

Other

Implemented

Usage Syntax

<cfmailparam  
	[file="String"]
	[name="String"]
	[value="String"]
	[type="String"]
	[disposition="String"]
	[contentid="String"]
 />

[] = Optional attribute

Attributes

Name Type Required Default Description
file String No Attaches the specified file to the message. This attribute is mutually exclusive with the name attribute.
name String No Specifies the name of the header. Header names are case insensitive. This attribute is mutually exclusive with the file attribute.
value String No Indicates the value of the header.
type String No The MIME media type of the part.
disposition String No How the attached file is to be handled. Can be one of the following: attachment: presents the file as an attachment. inline: displays the file contents in the message.
contentid String No The Identifier for the attached file. This ID should be globally unique and is used to identify the file in an IMG or other tag in the mail body that references the file content.

Example Usage

<---  Adding some headers: --->
<cfmail from="sender@host"
		to="recipient@host"
		subject="Urgent, please read!"
		type="html"
>
	<cfmailparam name="MIME-Version" value="1.0" />
	<cfmailparam name="X-Priority" value="1" />
	<cfmailparam name="X-MSMail-Priority" value="High" />
	<cfmailparam name="Reply-To" value="reply@host" />
	<p>This message adds 4 headers by using cfmailparam tags.</p>
</cfmail>

<---  Adding an attachment: --->
<cfmail from="sender@host"
		to="recipient@host"
		subject="An attachment for you"
		type="html"
>
	<cfmailparam file="#expandPath('images/logo.gif')#" type="image/gif" />
	<p>This message adds an attachment by using a cfmailparam.</p>
</cfmail>

 
Download in other Formats:
markup Markup | pdf PDF | html HTML | word Word

comments Comments (1)

You need to login in order to comment!

sebgmc@hotmail.com's Gravatar

url Sebastiaan said

at 02:55:12 PM 08-Apr-2010

Dear Railo, In which new version of Railo will the Remove attribute that CF8.0.1 introduced for automagically removing attachments sent with an email be introduced to Railo? hoping soon, would save me a couple of lines of programming and a scheduled task!