The mgiToken Tag

Tag Behavior

Use the mgiToken tags to append a token to URLs (HREFs and ACTIONs) between the beginning and ending tags. A token number can be used as a visitor's unique shopping basket identification. A token is composed of the visitor's IP number and time interval so that each token is absolutely unique.


Tag Syntax

The mgiToken tag has a beginning tag with no required parameters and three optional parameters, a body, and an ending tag. The tag form is:

<mgiToken mode="Mode" pathArgumentName="Name" 
pathArgumentValue="Value">
URLs to be tokenized
</mgiToken>

Required Parameters:

  • None.

Optional Parameters:

  • mode - The mode is the function that the mgiToken tag performs. In "addTokenOnly" mode, the mgiToken tag appends the mgiToken path argument and unique token value to URLs. In "addTokenWithPathArguments" mode, the mgiToken tag appends the token and all path arguments to URLs. In "addPathArgumentsOnly" mode, the mgiToken tag appends all path arguments to URLs. The default value is "addTokenOnly".
  • pathArgumentName - The pathArgumentName is the name of a path argument that is always appended to tokenized URLs. If this parameter is not followed by a pathArgumentValue parameter in the tag, it is ignored.
  • pathArgumentValue - The pathArgumentValue is the value of the specified path argument that is always appended to tokenized URLs. If this parameter is not preceded by a pathArgumentName parameter in the tag, it is ignored.


Technical Notes

  • Token Exceptions - The mgiToken tag does not append a token to "mailto" HREFs or URLs with an ending slash (/). URLs with an ending slash usually indicate a link to an external site.


Example Usage and Output

<mgiToken>
<A HREF="purchase.html">Purchase Our Products!</A>
</mgiToken>

When this example token tag is processed through an MGI server, the HREF is appended with a unique token number such as:

<A HREF="purchase.html?mgiToken=CD982415B2F65040">
Purchase Our Products!</A>


Suggested Usage

  • Shopping Baskets
  • Affiliate Systems


[Understanding MGI Menu] [Using MGI Menu] [Referencing MGI Menu]


[MGI Guides Main Menu] [User Guide Main Menu]