Ektron, Inc. provides an EkML basic template for each control. These templates are located in [webroot]/Workarea/Templates
. At the top of each template is a list of variables that can be used with that control.
WARNING! You should save the template under another name and use that template. This prevents your file from being overwritten when upgrades occur.
NOTE: If you install the Developer site, .ekml template files reside in various project folders. These files exemplify using the .ekml with a specific server control.
This file defines which items and information are included when displaying content item information in a collection using the Collection server control.
<img src=””/>
tag, the image appears. For example: <img src=”[$Image]”/>
See: [$Image]<img src=””/>
tag, a thumbnail version of the image appears. For example: <img src=”[$ImageThumbnail]”/>
. See: [$ImageThumbnail]<a href=””>
tag’s target=””
attribute, this variable reads the server control’s LinkTarget
property and uses its setting. [$LinkTarget]<a href=””>
tag, you can create a Hyperlink. [$QuickLink]http://www.example.com/demo.aspx
, the return is www.example.com
. [$SERVER_NAME][$ShowBubble]
. It calls the <ekbubbleinfo>
tags and lets you set the width of the bubble. [$ShowBubble(width,height)]<ekbubbleinfo>
tags and places the information contained within those tags in a pop-up bubble. [$ShowBubble]?id=27
and the variable is [$UrlParam(‘id’)]
, 27 appears. [$UrlParam(‘paramname’)]This file defines which items and information are included when displaying content item information in a list summary using the ListSummary server control. For an example of using this file with a ListSummary server control, see the Ektron demo example: http://<your site>/CMS400Developer/Developer/ListSummary/TemplateMarkup.aspx
.
<img src=””/>
tag, the image appears. For example: <img src=”[$Image]”/>
[$Image]<img src=””/>
tag, a thumbnail version of the image appears. For example: <img src=”[$ImageThumbnail]”/>
[$ImageThumbnail]<a href=””>
tag’s target=””
attribute, this variable reads the server control’s LinkTarget
property and uses its setting. [$LinkTarget]<a href=””>
tag, you can create a Hyperlink. [$QuickLink]http://www.example.com/demo.aspx
, the return is www.example.com
. [$SERVER_NAME][$ShowBubble]
. It calls the <ekbubbleinfo>
tags and lets you set the width of the bubble. [$ShowBubble(width,height)]<ekbubbleinfo>
tags and places the information contained within those tags in a pop-up bubble. [$ShowBubble]?id=27
and the variable is [$UrlParam(‘id’)]
, 27 appears. [$UrlParam(‘paramname’)]The map.ekml file defines which items and information are included when using the Map server control. Unlike most other .ekml files, the map.emkl has some variables that cannot be changed or moved around.
The file’s variables appear in 3 <tr></tr> table rows. These rows are located below the main table. In the first 2 table rows, you can modify a tag’s style information only. In the third, you can change the style information and the order of the variables to create different layouts for your page. It is recommended you hide the first 2 table rows if you are not changing their style information. For example:
When using the map.ekml file remember these 3 rules.
This file defines which items and information are included when displaying message information for a message board using the MessageBoard server control.
Displays the Add Comment text box and button for a message board.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$UserName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Displays the Approve link for the message. This link is used to approve the message for display when the Moderate
property is set to true. Only Administrators, the person who left the message, or the person who owns the board can see this link.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$UserName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Display the profile image of the member who entered the comments on the message board.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$UserName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Displays the Delete link for a comment on the message board. Only Administrators, the person who left the message or the person who owns the board.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$UserName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Displays the display name of the member who left the message.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$DisplayName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Displays the email address of the member who left the message on the board. To create a hyperlinked email, wrap the [$EmailAddress] variable in a <a> tag with the mailto: variable. For example:
<a href="Mailto:[$EmailAddress]">[$EmailAddress]</a>
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$UserName]  <a href="Mailto:[$EmailAddress]">[$EmailAddress]</a> </span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Displays the first name of the user who left a comment on a message board.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$FirstName] [$LastName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Displays the last name of the user who left a comment on a message board.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$FirstName] [$LastName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Displays the text of a message on a message board.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$UserName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Displays the number of comments posted on the message board.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$UserName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
Display the Username of a user who left a comment on a message board.
<ekoutput> <div class="ContributionForm"> <h4>[$NumberComments] Comments</h4> <ul> <ekrepeat> <li class="ekMessagePost"> <div class="avatar">[$Avatar]</div> <div class="message"> <div class="metaData"> <span class="username">[$UserName]</span> <span class="time">[$DateCreated]</span> </div> <p>[$MessageText]</p> <ul class="commands"> <li class="ekDeleteMessage">[$DeleteMessageLink]</li> <li class="ekApproveMessage">[$ApproveMessageLink]</li> </ul> </div> </li> </ekrepeat> </ul> [$AddCommentBox] </div> </ekoutput>
This file defines which items and information are included when displaying content item information for a metadata list using the MetadataList server control.
<img src=””/>
tag, the image appears. [$Image]<a href=””>
tag’s target=””
attribute, this variable reads the server control’s LinkTarget
property and uses its setting. [$LinkTarget]<a href=””>
tag, you can create a Hyperlink. [$QuickLink]http://www.example.com/demo.aspx
, the return is www.example.com
. [$SERVER_NAME][$ShowBubble]
. It calls the <ekbubbleinfo>
tags and lets you set the width of the bubble. [$ShowBubble(width,height)]<ekbubbleinfo>
tags and places the information contained within those tags in a pop-up bubble. [$ShowBubble]?id=27
and the variable is [$UrlParam(‘id’)]
, 27 appears. [$UrlParam(‘paramname’)]This file defines which items and information are included when displaying taxonomy item information using the Directory server control. Similar to maps.ekml, the taxonomy.ekml works differently than other .ekml files.
The Directory server control produces multiple areas where content or functionality is defined. To specify these areas in a template, you would call the <ekoutput>
tag with the mode attribute equaling the area you want to define. For example, in the Directory server control, you can define information in the breadcrumb area of the server control by using <ekoutput mode=”breadcrumb”>
.
Additional descriptions and commenting in the taxonomy.ekml file will assist you with learning about EkML with taxonomy. This file is located in <web root>/CMS400Developer/Workarea/template/taxonomy/taxonomy.ekml
.
The following <ekoutput modes=””> are used with the taxonomy.ekml template.
EkML Tag |
Description |
|
Defines the display of the breadcrumb portion of the taxonomy. Within these tags you can define:
|
|
Defines how the category information appears. Within these tags you can define:
|
|
Defines information about the link that moves the category up one level. This can be a text link or an image link. In this mode, you need to define the following tags:
See Also: [$categorybacklink] |
|
Defines how the search results from the taxonomy are displayed. |
|
Defines the display of an individual content item in your taxonomy. |
|
This section defines the overall output view of the Taxonomy. It denotes the locations of the Search box, Breadcrumb, Category and Articles. |
<ekactivebacklink>
tags, this variable adds a clickable image that allows a user to navigate up one category level. When placed between <ekdisablebacklink>
tags and in the text area of an <a>
tag, this variable adds a clickable image that allows a user to navigate to another URL once they reach the top level category. [$categorybacklink]<ekoutput mode=”article_search”>
[$ContentByteSize]<a href=””>
tag’s target=””
attribute, this variable reads the server control’s LinkTarget
property and uses its setting. [$LinkTarget]<ekoutput mode=”article_search”>
[$PagingCurrentEndIndex]<ekoutput mode=”article_search”>
[$PagingCurrentStartIndex]<a href=””>
tag, you can create a Hyperlink. [$QuickLink]<ekoutput mode=”article_search”>
[$SearchDuration]<ekoutput mode=”article_search”>
[$SearchSummary]<ekoutput mode=”article_search”>
[$SearchText]http://www.example.com/demo.aspx
, the return is www.example.com
. [$SERVER_NAME]<ekbubbleinfo>
tags and places the information contained within those tags in a pop-up bubble. [$ShowBubble][$ShowBubble]
. It calls the <ekbubbleinfo>
tags and lets you set the width of the bubble.[$ShowBubble]
. It calls the <ekbubbleinfo>
tags and lets you set the width and height of the bubble. [$ShowBubble(width,height)]<a href=””>
tag, you can create a Hyperlink. [$TemplateQuickLink]?id=27
and the variable is [$UrlParam(‘id’)]code, 27 appears.
[$UrlParam(‘paramname’)]This variable adds a link that allows a user to add HTML content to Ektron. Clicking the link opens an editor. When the content is added, it’s automatically added to the taxonomy category associated with the Directory server control. When you allow users to add content using this variable, you should set the AddItemFolderID
property in the Directory server control to the folder ID where the content will be stored. This variable should not be added between the <ekrepeat></ekrepeat> tags.
<tr> <td> [$AddArticle] </td> </tr>
This variable adds a link that allows a user to add assets to Ektron via a drag and drop box. When the asset is added, it’s automatically added to the taxonomy category associated with the Directory server control. When you allow users to add assets using this variable, you should set the AddItemFolderID
property in the Directory server control to the folder ID where the asset will be stored. This variable should not be added between the <ekrepeat></ekrepeat> tags.
<tr> <td> [$AddAsset] </td> </tr>
This variable displays the Template Quicklink information assigned to the taxonomy item in the Workarea. When wrapped in an <a href=””>
tag, you can create a Hyperlink.
<ekmarkup> <ekoutput> <table width="100%" border="0"> <ekrepeat> <tr> <td> <a href="[$TemplateQuickLink]">[Title]</a><br/>[$Teaser] </td> </tr> </ekrepeat> </table> </ekoutput> </ekmarkup>
When placed between <ekactivebacklink> tags, this variable adds a clickable image that allows a user to navigate up one category level.
When placed between <ekdisablebacklink> tags and in the text area of an <a> tag, this variable adds a clickable image that allows a user to navigate to another URL once they reach the top level category.
<ekoutput mode="categorybacklink"> <ekactivebacklink> [$categorybacklink] </ekactivebacklink> <ekdisablebacklink> <a href="http://www.example.com" target="_blank">[$categorybacklink]</a> </ekdisablebacklink> </ekoutput>
This file defines which items and information are included when displaying search results using the WebSearch server control.
NOTE: The WebSearch server control is deprecated as of Release 8.5. Instead of the Web search control, you should convert to templated search
The websearch.ekml template needs 2 <ekoutput>
nodes.
<ekoutput>
node formats the results of non-image searches<ekoutput>
node formats results that include images<img src=””/>
tag, the image appears. [$Image]<a href=””>
tag’s target=””
attribute, this variable reads the server control’s LinkTarget
property and uses its setting. [$LinkTarget]<a href=””>
tag, you can create a Hyperlink. [$QuickLink]NOTE: The Adobe IFilter, which is used to generate the abstract, is only supported in Tier 1 languages (English, French, German, and Japanese). If your Web site uses other languages, the abstract may not be legible. In such a case, you should suppress the abstract from the search results.
The numerical record of the last item on a page. For example, if you are displaying items 1 through 10 out of 50 total items on a page, this variable represents the number 10.
This variable is typically used in the following context:
Results [$PagingCurrentStartIndex]
—[$PagingCurrentEndIndex]
of [$ItemCount]
for item [$SearchText] ([$SearchDuration])
.
Displays the text for which a user is searching. This information is same as what a user entered in the search text box.
This variable is typically used in the following context:
Results [$PagingCurrentStartIndex]
—[$PagingCurrentEndIndex]
of [$ItemCount]
for item [$SearchText] ([$SearchDuration])
.
The numerical record of the first item on a page. For example, if you are displaying items 1 through 10 out of 50 total items on a page, this variable represents the number 1.
This variable is typically used in the following context:
Results [$PagingCurrentStartIndex]
—[$PagingCurrentEndIndex]
of [$ItemCount]
for item [$SearchText] ([$SearchDuration])
.