MicroMessagingBookmarklet

Inserting the MicroMessagingBookmarklet server control onto a page

Prerequisite

You must have installed the server controls. See Installing server controls into Visual Studio Toolbox.

1. In Visual Studio, choose View > Toolbox.
2. Click the Ektron server control tab to display the server controls.
3. Drag the MicroMessagingBookmarklet server control and drop it into the desired location on the page.

   NOTE: You also can place the cursor on the page where you want the server control, then double click the server control that you want.

   <CMS:MicroMessagingBookmarklet ID="MicroMessagingBookmarklet1" runat="server" />

4. Click on MicroMessagingBookmarklet in the code to display and modify the control’s properties using the Properties window of Visual Studio. The page is updated as you modify the property values.
   —Image—

   

The following are Ektron-specific server controla server control uses API language to interact with the CMS and Framework UI to display the output. A server control can be dragged and dropped onto a Web form and then modified. properties. For information about native .NET properties such as font, height, width and border style, use Visual Studio^® help.

• DoInitFill (Boolean)

  By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, Fill is automatically called during the Page Render event. You might do this if you need to set or change a property on the control in code-behind and have it render with your changes shown.

• FormUrl (String)

  The path to the page that appears when a user clicks the MicroMessagingBookmarklet link. By default, when a user clicks a link, he is redirected to the siteroot/Workarea/share.aspx page.

• Hide (Boolean)

  Hides or displays the output of the control in design time and run time.

  • True. Hide the control output.
  • False. Display the control output.
• IncludeCSS (Boolean)

  Lets you include or exclude the control's default .css file, which provides the "look and feel" of the control on a Web page.

• Language (Integer)

  Set a language for viewing content; shows results in design-time (in Visual Studio) and at run-time (in a browser).

• LinkText (String)

  The text that appears on the MicroMessagingBookmarklet link.

  

  To modify the look and feel of this area, edit the ektron.micromessaging.bookmarklet.css file in the siteroot/Workarea/csslib folder.

• OutputLinkIcon (Boolean)
  • False. Suppress the icon
  • True. Show the MicroMessagingBookmarklet link icon on the button

    

  To modify the look and feel of this icon, edit the ektron.micromessaging.bookmarklet.css file in the siteroot/Workarea/csslib folder.

• PopupHeight (Integer)

  The height of the MicroMessagingBookmarklet link window in pixels.

• PopupWidth (Integer)

  The width of the MicroMessagingBookmarklet link window in pixels.

• SiteName (String)

  The name of the website using this server control. The SiteName value is embedded in the instructions for adding the MicroMessagingBookmarklet to the toolbar. See example below.

  

Customizing the MicroMessagingBookmarklet server control

The MicroMessagingBookmarklet server control is template-based which means you can change the control's appearance without an extensive XSLTExtensible Stylesheet Language Transformations or EkMLEktron Markup Language file.

The JavaScript used to render the MicroMessagingBookmarklet control is loaded into the Href property of the control's anchor tag.

The following code shows the first MicroMessagingBookmarklet server control in bookmarklet.aspx.

<li>
<div class="controlWrapper">
<h3>Default</h3>
<CMS:micromessagingbookmarklet ID="bookmarkletDefault" runat="server" />
</div>
</li>

Because MicroMessagingBookmarklet is a templated server control, you can enter any valid markup, and it will be rendered exactly as you entered it. As examples, you can enter the following items within the <div> tags that surround the control.

• another Ektron server control
• any third-party server control
• HTML syntax
• databinding syntax
• style classes
• style tags, such as <strong>