Free-Conversant Support / Message Macros
 Home   About Conversant   Free Sites   Hosting   Support   XML-RPC 

Search




Subject Message Macros
Posted 10/14/2000; 3:11 PM by Greg Pierce
Last Modified 1/22/2002; 10:31 AM by Seth Dillingham
In Response To (#Top of Thread.)
Label Docs Read 12834
<Previous Next> Thread: Forward chronological view Reverse chronological view Hierarchical outline view Edit Reply

Using Message Macros

Jump to the Macro List

Message macros are designed to allow flexible ways to configure message views throughout your conversations, and also to allow access to properties of messages in a variety of locations. These macros are fully supported in templates used for editing and viewing messages in the discussion group, in bound URL pages, and also are current supported in the message templates of Full Thread Page and Advanced Query Page types.

There are two ways of using Message Macros: in the context of message rendering, and as stand alone macros. A message macro must know what message number to use to access the information it should return.

  • When using message macros "in context", a message number is assumed, based on the context of the current page being rendered. For example, if you are viewing a message in the discussion group ( http://yoursite/[msgnum] ), or you are viewing a bound URL page in your site, there is a single message number attached to that entire page rendering, and it will be assumed to be the message number you wish to use in the macros.
  • In Page Types that support Message Macros, there can multiple contexts in the same page, such as each message item returned in a query result.

You can also override the "in context" message number used by the macros, by using the "msgNum=[number]" attribute in the macro. This will cause the macro to return the appropriate property of that specific message.

When rendering "in context", you can also override the assumed message number with several special values that that select a message relative to the message that's in context. These special values are:

  • next - returns the property for next higher valid message number
  • prev - returns the property for the next lower valid message number
  • nextThread - returns the property for the top level message of the next thread
  • prevThread - returns the property for the top level message of the previous thread
  • top - returns the property for the top level message of the current thread
  • inresponseto - returns the property for the message the current message is responding to

Available Message Macros

<Previous Next> Thread: Forward chronological view Reverse chronological view Hierarchical outline view Edit Reply
ENCLOSURES

None.
REPLIES

RE: Message Macros
10/15/2000 by Mark Morgan
Fantastic, and I love these new macros. I love the way you can pull information

Feature Request: more msgNum modifiers
10/28/2001 by Jim Roepcke
I'd like to have a msgNum modifier (a la msgNum="next") to get the next or

Message Macro: msgBody
1/2/2002 by Seth Dillingham
Message Macro: msgBody Usage: <!--#msgBody--> Overview: Returns the body

Message Macro: msgBoundURL
1/2/2002 by Seth Dillingham
Message Macro: msgBoundURL Usage: <!--#msgBoundURL--> Overview: Returns

Message Macro: msgBoundURLs
1/2/2002 by Seth Dillingham
Message Macro: msgBoundURLs Usage: <!--#msgBoundURLs--> Overview: Returns

Message Macro: msgCreationDate
1/2/2002 by Seth Dillingham
Message Macro: msgCreationDate Usage: <!--#msgCreationDate--> Overview:

Message Macro: msgCreatorAddress
1/2/2002 by Seth Dillingham
Message Macro: msgCreatorAddress Usage: <!--#msgCreatorAddress--> Overview:

Message Macro: msgCreatorName
1/2/2002 by Seth Dillingham
Message Macro: msgCreatorName Usage: <!--#msgCreatorName--> Overview:

Message Macro: msgCtReads
1/2/2002 by Seth Dillingham
Message Macro: msgCtReads Usage: <!--#msgCtReads--> Overview: Returns

Message Macro: msgCustomField
1/2/2002 by Seth Dillingham
Message Macro: msgCustomField Usage: <!--#msgCustomField fieldName="A_Field_Name"-->

Message Macro: msgCustomFieldProperty
1/2/2002 by Seth Dillingham
Message Macro: msgCustomFieldProperty Usage: <!--#msgCustomFieldProperty

Message Macro: msgEditLink
1/2/2002 by Seth Dillingham
Message Macro: msgEditLink Usage: <!--#msgEditLink--> Overview: Returns

Message Macro: msgEditURL
1/2/2002 by Seth Dillingham
Message Macro: msgEditURL Usage: <!--#msgEditURL--> Overview: Returns

Message Macro: msgEnclosures
1/2/2002 by Seth Dillingham
Message Macro: msgEnclosures Usage: <!--#msgEnclosures--> Overview: Returns

Message Macro: msgFullThreadLink
1/2/2002 by Seth Dillingham
Message Macro: msgFullThreadLink Usage: <!--#msgFullThreadLink--> Overview:

Message Macro: msgInResponseTo
1/2/2002 by Seth Dillingham
Message Macro: msgInResponseTo Usage: <!--#msgInResponseTo--> Overview:

Message Macro: msgLabelColor
1/2/2002 by Seth Dillingham
Message Macro: msgLabelColor Usage: <!--#msgLabelColor--> Overview: Returns

Message Macro: msgLabelId
1/2/2002 by Seth Dillingham
Message Macro: msgLabelId Usage: <!--#msgLabelId--> Overview: Returns

Message Macro: msgLabelName
1/2/2002 by Seth Dillingham
Message Macro: msgLabelName Usage: <!--#msgLabelName--> Overview: Returns

Message Macro: msgLabelPopup
1/2/2002 by Seth Dillingham
Message Macro: msgLabelPopup Usage: <!--#msgLabelPopup--> Overview: Returns

Message Macro: msgLabelTextColor
1/2/2002 by Seth Dillingham
Message Macro: msgLabelTextColor Usage: <!--#msgLabelTextColor--> Overview:

Message Macro: msgModificationDate
1/2/2002 by Seth Dillingham
Message Macro: msgModificationDate Usage: <!--#msgModificationDate-->

Message Macro: msgModifierAddress
1/2/2002 by Seth Dillingham
Message Macro: msgModifierAddress Usage: <!--#msgModifierAddress--> Overview:

Message Macro: msgModifierName
1/2/2002 by Seth Dillingham
Message Macro: msgModifierName Usage: <!--#msgModifierName--> Overview:

Message Macro: msgNoInThread
1/2/2002 by Seth Dillingham
Message Macro: msgNoInThread Usage: <!--#msgNoInThread--> Overview: Returns

Message Macro: msgNoOfReplies
1/2/2002 by Seth Dillingham
Message Macro: msgNoOfReplies Usage: <!--#msgNoOfReplies--> Overview:

Message Macro: msgOwner
1/2/2002 by Seth Dillingham
Message Macro: msgOwner Usage: <!--#msgOwner--> Overview: Returns the

Message Macro: msgReadFlag
1/2/2002 by Seth Dillingham
Message Macro: msgReadFlag Usage: <!--#msgReadFlag--> Overview: If the

Message Macro: msgReplies
1/2/2002 by Seth Dillingham
Message Macro: msgReplies Usage: <!--#msgReplies--> Overview: Returns

Message Macro: msgReplyLink
1/2/2002 by Seth Dillingham
Message Macro: msgReplyLink Usage: <!--#msgReplyLink--> Overview: Returns

Message Macro: msgReplyURL
1/2/2002 by Seth Dillingham
Message Macro: msgReplyURL Usage: <!--#msgReplyURL--> Overview: Returns

Message Macro: msgSubject
1/2/2002 by Seth Dillingham
Message Macro: msgSubject Usage: <!--#msgSubject--> Overview: Returns

Message Macro: msgTopOfThreadLink
1/2/2002 by Seth Dillingham
Message Macro: msgTopOfThreadLink Usage: <!--#msgTopOfThreadLink--> Overview:

Message Macro: msgNum
1/2/2002 by Seth Dillingham
Message Macro: msgNum Usage: <!--#msgNum--> Overview: Returns the message

Message Macro: msgURL
1/2/2002 by Seth Dillingham
Message Macro: msgURL Usage: <!--#msgURL--> Overview: Returns the URL

Message Macro: nextMsgLink
1/2/2002 by Seth Dillingham
Message Macro: nextMsgLink Usage: <!--#nextMsgLink--> Overview: Returns

Message Macro: prevMsgLink
1/2/2002 by Seth Dillingham
Message Macro: prevMsgLink Usage: <!--#prevMsgLink--> Overview: Returns

Message Macro: msgReplyForm
1/2/2002 by Seth Dillingham
Message Macro: msgReplyForm Usage: <!--#msgReplyForm--> Overview: Displays

Message Macro: msgNewThreadForm
1/2/2002 by Seth Dillingham
Message Macro: msgNewThreadForm Usage: <!--#msgNewThreadForm--> Overview:

Message Macro: msgNoInThreadUnread
9/2/2002 by Seth Dillingham
Message Macro: msgNoInThreadUnread Usage: <!--#msgNoInThreadUnread-->

Message Macro: msgSetReadFlag
9/2/2002 by Seth Dillingham
Message Macro: msgSetReadFlag Usage: <!--#msgSetReadFlag--> Overview:


TRACKBACKS