Ektron CMS400.Net Reference

>>Managing User Communities > SocialBar Server Control

SocialBar Server Control

The SocialBar server control allows users of a community Web site to bookmark colleagues, community groups, and content. The following table explains the details.

Item being
bookmarked
Description

Users

Sends colleague requests

Removes colleagues when a user visits another user’s profile page

Group

Join and leave community group

Invite others to join group

Content

Add or remove content and URLs from a user’s Favorites. See Also: Favorites Server Control

The Social Bar control is also used to bookmark Web pages with Social Bookmarking services, such as Digg.com or del.icio.us. By default, Digg.com and del.icio.us are loaded in the Items property of the server control. See Also: Items Property

In addition, the Social Bar control can print or email a Web page, and invite non-site users to become members of the site. Clicking Invite links to a Web page that hosts the Invite server control. See Also: Invite Server Control.

Adding a Web Page URL to a Favorites Via the Social Bar

See Also: Adding a URL to Your Favorites via the Favorites Control

You can allow users to add a Web page’s URL to their Favorites when they click Add to Favorites on the Social Bar. Typically, you would do this if more than one content item appears on a Web page, but you want only one Social Bar control on the page.

The image below shows a web page with several content items. A Social Bar control is associated with each one. In this example, when a user clicks Add to Favorites, he adds the associated content item to his Favorites.

In the second image, one Social Bar appears on the Web page with several content items. In this example, if a user clicks Add to Favorites on the Social Bar, he adds the Web page’s URL to his Favorites.

To allow users to add a URL to their Favorites from the SocialBar server control, follow these steps.

1. Drag and drop a SocialBar server control on a Web form.

2. Set the DefaultObjectID property to 0 (zero).

3. Leave the DynamicObjectParameter property blank.

4. If it is not already there, copy the comma-separated list of items from the Items property to the Addto item property.

5. Set the ObjectType property to Content.

Private Messaging from the Social Bar

Users can send private messages to another user or the community group administrator from the Social Bar control. To enable this feature, follow these steps.

1. Drop a SocialBar server control on a user’s profile or community group’s page.

2. Set the ObjectType property to User or Group.

3. Add either PrivateMessageUser or PrivateMessageAdmin to Items property.

- Use PrivateMessageUser to let a user send a message to the user whose profile is being viewed.

- Use PrivateMessageAdmin to let a user send a message to the group administrator.

4. In the MessagingUrl property, identify a page that contains the Messaging server control. See Also: Messaging Server Control

5. Make sure the DynamicObjectParameter is set, if necessary.

See Also: Items Property

Tweeting the URL a User is Currently Browsing

You can allow site visitors to use Twitter to tweet their current browsing location. You do this by adding the Twitter item to the list of parameters in the SocialBar’s Items property.

After the item is added, a Twitter icon and link appear in the Social Bar. When a user clicks the link, Twitter is launched. After a user logs into his Twitter account, his current browsing location appears in the “What are you doing?” status box. The user can then click Twitter’s Update button to post the status.

To allow users to tweet the URL they are currently browsing, follow these steps.

1. Drag and drop a SocialBar server control on a Web form.

2. Make sure the DefaultObjectID property is set to 0 (zero).

3. Leave the DynamicObjectParameter property blank.

4. If it is not already there, add the Twitter item to the comma-separated list in the Items property.

5. Set the ObjectType property to Content, User or Group, depending on the type of page you are editing.

SocialBar Server Control Properties

The SocialBar server control properties are described in this table.

Note: The following table only lists Ektron-specific properties. It does not describe native .NET properties such as font, height, width and border style. For documentation of these properties, see Visual Studio help.

Property

Description

Data Type

Authenticated

Indicates if you are logged in to the CMS Explorer and can use it to browse to Content, Collections, etc. See Also: Working with Ektron CMS400.NET Server Controls

String

CacheInterval

Sets the amount of time the server control’s data is cached. The default is 0 (zero). This is the amount of time, in seconds, a control’s data is cached. For example, if you want to cache the data for five minutes, set this property to 300 (three hundred). See Also: Caching with Server Controls

Double

DefaultObjectID

The default object ID for this control to use when there is no matching dynamic parameter value passed. If you set this property set to 0 (zero) and leave the DynamicObjectParameter blank, the social bar can be used to add Web pages to your favorites.

Long

DisplayXslt

Determines how the Social Bar items are displayed on the page. Enter the path to a custom XSLT file. The path can be relative or absolute.

Warning! If you specify an
external file, it is strongly recommended that you do not store this file in your site's Workarea folder. If you do, the file will be overwritten when you upgrade.

String

 

DoInitFill

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 codebehind and have it render with your changes shown.

Boolean

DynamicObjectParameter

Gets or sets the QueryString parameter to read a object ID dynamically. To use the default object ID, leave blank.

String

Hide

Used to hide output of the control in design time and run time.

True = Hide control

False = Display control

Boolean

IncludeIcons

Select whether icons are displayed next to each item.

True = Display icons next to each item.

False = Do not display icons next to each item.

Boolean

InviteURL

The URL to the Invite server control’s Web page. Two variables used within the URL.

{0} - represents the object ID

{1} - represents the object type

The link must have both variables. The Web form can be relative or absolute. Below is an example.

invitepage.aspx?id={0}&type={1}

String

Items

A comma separated list of items that you want to appear on the Social Bar. See Items Property for information.

String

Language

Set a language for viewing the server control. This property shows results in design-time (in Visual Studio) and at run-time (in a browser).

Integer

MarkupLanguage

Identify the template markup file that controls the display of the server control. For example, mymarkup.ekml. If the *.ekml file is located in the same folder as the Web form containing the server control, just enter its name. Otherwise, the path to the file can be relative or absolute. See Also: Controlling Output with Ektron Markup Language

String

MessagingUrl

The Web page that hosts the Messaging server control. This property is used when either PrivateMessageUser or PrivateMessageAdmin appears in the Items property. See Items Property for information on these items.

Note: If a value appears in the ek_RedirectFromLoginKeyName key in the web.config file, the user is returned to the original URL after sending the message. By default, this value is RedirectUrl. If you remove this value and do not add another, the person sending a message sees a note stating “Your message has been sent.”

String

ObjectType

The type of object to which this control is assigned. Choices are:

Content - this control is assigned to content.

User - control assigned to an individual

Group -control assigned to a community group

Data Type: Ektron.Cms.Common.EkEnumeration.CMSSocialBarTypes

Stylesheet

Specify the path to a style sheet for use with the 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.

String

SuppressWrapperTags

Suppresses the output of the span/div tags around the control. The default is False.

True - Suppress wrap tags.

False - Allow wrap tags.

Boolean

WrapTag

Allows a developer to specify a server control’s tag. The default is Span.

Span - The <span> tag is used to designate an inline portion of an HTML document as a span element.

Div - The <div> tag is used when you want to apply attributes to a block of code.

Custom - Allows you to use a custom tag.

String

Items Property

The Items property controls which items appear in the Social Bar. Below is a list of items that can appear in the Social Bar.

Item

Description

Addto

If this control is associated with a user, the Addto item appears as:

- Add a Colleague - if user is viewing another user’s profile page and can add them as a colleague.

- Cancel Colleague Request - if user is viewing another user’s profile page who he asked to be a colleague but the user has not yet accepted.

- Remove From Colleagues - if user is viewing a current colleague’s profile page.

If the control is associated with a community group, the Addto item appears as:

- Join Group - if user visits a community group that he has not joined.

- Leave Group - if user already belongs to a community group.

- Cancel Request to Join - if user has tried join a restricted group and has not yet been accepted.

If the control is associated with content, the Addto item appears as:

- Add to Favorites - if user views content that is not in their Favorites.

- Remove Favorites - if user views content that is in their Favorites.

Invite

A link to the Web page that contains the Invite server control. This control allows you to invite people to register on the site and become a colleague.

Warning! For the Invite item to be active, you must enter a link to the page hosting the Invite control into the InviteURL property. See Also: InviteURL.

GroupInvite

Opens a dialog that invites colleagues or people who are not registered on the site to join the group.

Email

Email this Web page. Clicking this item launches a user’s email with the subject and body loaded with the information about the content, user or community group.

Digg

Appears as Digg It. Launches Digg.com, a social bookmarking service.

Delicious

Appears as Bookmark It. Launches del.icio.us, a social bookmarking service.

Facebook

Appears as Facebook. Launches Facebook, a social network service.

Google

Appears as Google It. Launches Google’s social bookmarking service.

Furl

Appears as Furl It. Launches Furl, a social bookmarking service.

Technorati

Appears as Technorati. Launches Technorati, a social bookmarking service.

Twitter

Launches Twitter, a social network service, which allows users to communicate with other Twitter users.

If the Twitter link is clicked, and a user logs in to a Twitter account, a link to the current page is inserted into the Status box. See Also: Tweeting the URL a User is Currently Browsing

Yahoo

Appears as Yahoo! It. Launches Yahoo’s social bookmarking service.

Print

Print the Web page.

PrivateMessageUser

Creates a link that allows you to send a Private Message to a user. See Also: Private Messaging from the Social Bar

PrivateMessageAdmin

Creates a link that allows you to send a Private Message to a community group’s administrator. See Also: Private Messaging from the Social Bar


Visit the Ektron Dev Center at http://dev.ektron.com 1-866 - 4 - EKTRON

Ektron CMS400.NET Reference Version 8.02 SP1 Rev 1

Ektron Documentation,© 2011 Ektron, Inc.