Invite Server Control

The Invite server control lets a site visitor invite people to join the site or become a colleague. The control displays a dialog box that prompts for several email addresses. The dialog includes an optional message, which appears in the body of the email. The site visitor can edit or delete the message.

NOTE: Messages are defined in the Workarea. For more information, see Email Invitations for Community Management.

Invitations have a single "from" email address. Its default value is [email protected]. Your site administrator should change it to one that is appropriate for your organization. To change the "from" email address for all invitations, open your site’s web.config file and change the value of following key.

<add key="ek_InvitationFromEmail" value="[email protected]"/>

WARNING! The default From email address used to send all invitations is [email protected]. Ektron, Inc. strongly recommends changing this address.

Invite server control properties

Invite Server Control Properties

The following are Ektron-specific server control properties. You can find information about native .NET properties such as font, height, width and border style in Visual Studio® help.

  • Authenticated (String)

    Indicates if you are logged into the CMS Explorer and can use it to browse to content, collections, and so on. See Also: Browsing Your Ektron Site Using CMS Explorer.

  • DisplayXslt (String)

    If desired, enter a relative or absolute path to an Xslt that determines the display of the page.

    WARNING! If you specify an external file, do not store this file in the Workarea folder. If you store this file in the Workarea folder, the file will be lost when you upgrade.

    If you enter a valid EkML file at the MarkupLanguage property, the Displayxslt property value is ignored.

  • 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.

  • FriendMessageId (Long)

    The ID of the message to send in the link section of a FriendInvitation type email. This message is defined in the Workarea > Settings > Community Management > Messages. See Also: Email Invitations for Community Management. If set to 0 (zero), the server control uses the default message.

  • 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.
  • InviteMessageId (String)

    The ID of the message to send in the link section of a GroupInvitation or FriendInvitation email. This message is defined in the Workarea > Settings > Community Management > Messages. See Also: Email Invitations for Community Management. If set to 0 (zero), the server control uses the default message.

  • Language (Integer)

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

  • OptionalMessageText (String)

    The body text of the email message. The text appears in the Invite server control’s dialog box and can be edited by site visitors when they use the Invite control.

  • Stylesheet (String)

    Specify the path to a style sheet for use with this server control. The location can be relative or absolute. Leave blank to use the default style sheet.

    WARNING! If you enter a valid EkML file at the MarkupLanguage property, the Stylesheet property is ignored.

  • SuppressWrapperTags (Boolean)

    Suppresses the output of the span/div tags around the control.

    • True—Suppress wrap tags.
    • False (default)—Allow wrap tags.
  • WrapTag (String)

    Lets a developer specify a server control’s tag.

    • Span (default)—designate an inline portion of an HTML document as a span element.
    • Div—apply attributes to a block of code.
    • Custom—Lets you use a custom tag.