MHonArc Resources: MAILTOURL

# MAILTOURL

## Syntax

Envariable

  `M2H_MAILTOURL=`URL-template

Element

  `<MAILTOURL>
  ` URL-template
  `</MAILTOURL>
  `

Command-line Option

  `-mailtourl` URL-template

## Description

The MAILTOURL defines the URL template for hyperlinked e-mail addressed in message headers when the MAILTO resource is active.

NOTE

  The MAILTOURL resource has different rules for variable expansion. If a variable does not exactly match the set of variables available for the MAILTOURL, the variable text will be taken literally as part of the element content. Therefore, a single "`$`" can be used to represent a "`$`" character.

  Also, variables in the MAILTOURL should NOT have "`:`NU" modifier. This will prevent the variables from be recognized. MHonArc will automatically treat the replacement value as a part of a URL string.

## Default Setting

    mailto:$TO$

## Resource Variables

Variable | Value
--- | ---
`$FROM$` | The complete text in the `From:` field.
`$FROMADDR$` | Address portion of `From:` field.
`$MSGID$` | The message-id of the message.
`$SUBJECT$` | The subject text of the message.
`$SUBJECTNA$` | The subject text of the message.
`$TO$` | The email address being converted into a hyperlink. It is NOT the value of the `To:` field. The variable name is misleading.

## Examples

The following example defines how MAILTOURL can be used to have e-mail addresses linked to a CGI program:

    <MailToURL>
    /cgi-bin/mailform.cgi?to=$FROM$;subject=$SUBJECT$;srcid=$MSGID$
    </MailToURL>

## Version

1.0

## See Also

MAILTO