Tags

Tags are keywords that can be assigned to users, groups, content, and library items. On a Web site, tags for a user or group appear in a profile, helping site visitors learn about a user or group.

You also can perform tag-based searching.

For example, you tag content related to a new product release with “Widgets 2.0.” Anyone could enter that term into the Search box, click Tags from the drop-down list, then Search to find all related content.

Tags are used in these Workarea locations:

NOTE: The CommunityGroupBrowser, CommunityGroupProfile, and CommunityGroupList server controls can display group tags and link them to a list of all groups that share the tag. Also, the TagCloud server control displays a weighted list of tags. See Also: TagCloud Server Control

Tag types

Tag Types

There are 2 tag types:

  • Default
    • Created by system administrator in Settings > Community Management > Tags area
    • Appear as checkbox options where tags can be applied
  • User-created
    • Created by user wherever tags can be applied
Creating default tags as administrator

Creating Default Tags as Administrator

An Ektron administrator can create default tags for each object (user, user group, content or library item). For example, you want to let users associate themselves with a favorite race car driver. You create a default user tag for each driver’s name. When a user creates or edits an item for which you created the default tags, the tag appears and the user clicks check boxes to assign them.

Ektron provides screens for creating default tags for user groups, users, content and library items. They are available via Settings > Community Management > Tags.

  1. In the Workarea, navigate to Settings > Community Management > Tags and select on the the default tag items.

  2. Select a language for the tag.
  3. Add the tag in the empty text box. If no empty box appears, click Add () then enter the tag.
  4. Click Save Tag.
Creating tags as end user

Creating Tags as End User

Users, community group leaders, and content editors can create their own tags. For example, while you are editing content, you decide that none of the default tags is correct. So, you create and assign a new tag: Rosebud. That tag is now applied to that content.

The tag also appears on the Settings > Community Management > Tags screen, where you can see its ID number. If someone creates another tag with the same name, it shares the ID number with the previous one, and the Times Used increases from 1 to 2. However, the new tag does not appear as a default on any screen.

Managing tags

Managing Tags

Administrators manage tags from the Settings > Community Management > Tags screen. This screen displays all default and user-created tags. You can filter the list by language. Click any tag’s name to see its details.

This screen displays the following information about each tag.

  • ID—Tag's integer ID
  • Name—Tag's title
  • Times Used—The number of times a tag has been assigned
  • Language—Its language. This appears as a national flag. For example, American English appears as .

When you click a tag’s name, its details appear on the View Tag screen.

  • ID—Tag's integer ID
  • Language—Tag's language
  • Name—Tag's title
  • Tagged Type—Shows how the tag is assigned: to a community group, user, content, or library item.
  • Times Used—The number of times this tag is assigned to each Tagged Type
Deleting tags

Deleting Tags

The following table shows how to delete each tag type.

Tag Type

Result

Procedure

User-created

Delete a single tag
  1. Open the item’s Tags area. For example, for content, edit the Metadata tab.
  2. Uncheck the checkbox next to the tag.
  3. Publish the content.

Delete all occurrences of a tag
  1. Go to the Settings > Community Management > Tags screen.
  2. Click the tag.
  3. Click delete (). A confirmation message appears.
  4. Click OK.

Default

There are 2 methods for deleting default tags. Each has different results.

Deleting a Default Tag

  • No longer available for assignment to users, content, and so on.
  • Existing links to it remain
  1. Go to Settings > Community Management > Tags
  2. Select the screen for the kind of tag you want to delete (group, user, content or library).
  3. Select the language.
  4. Click ( ) to the right of the tag you want to delete. You are asked if you are sure. Click OK.
  5. Click Save.

Deleting a Default Tag and All of its Links

  • No longer available for assignment to users, content, and so on.
  • Existing links to it are deleted
  1. Go to the Settings > Community Management > Tags screen.
  2. Click the tag.
  3. Click Delete (). A confirmation message appears.
  4. Click OK.
TagCloud server control

TagCloud Server Control

The TagCloud server control shows a weighted list of tags assigned to users, community groups, content, or library items. Each tag’s size is proportional to the number of times it is assigned. For example, there are 2 tags, Software and Programming. If the Software tag is used 5 times and the Programming tag is used 2 times, the Software tag is approximately twice as large.

Use the TagType property to determine which types of tags appear in the cloud. For example, set TagType to User to display user tags.

You can set a maximum number of tags to display via the MaxTagsDisplayed property. This property makes sense if the Orderby property is set to Taggedcount. In this case, the cloud only displays items with the highest number of tags.

Use the OrderBy property to sort tags within a cloud. Your choices are alphabetical or by Taggedcount (the number of times an item is tagged). Then, use the OrderByDirection property to determine if items are sorted in ascending or descending order.

Within a tag cloud, you can link tags to their source items. If you do, site visitors can click a tag to launch a search of all users, community groups, content, or library items to which the tag is assigned. For example, if someone views a user-based tag cloud and clicks Motorcycles, the community search page appears, showing all users tagged with Motorcycles.

To make a tag cloud’s items searchable, add a path to the Web form containing the Search server control in the TagTemplate property.

TagCloud server control properties

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

  • CacheInterval (Double)

    The number of seconds that the server control’s data is cached. The default is 0 (zero). For example, if you want to cache the data for 5 minutes, set to 300. See Also: Caching with Server Controls.

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

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

  • DynamicParameter (String)

    By default, the TagTemplate property passes a TagId parameter, whose value is the tag that a site visitor clicked in the tag cloud. Use this property to manually override that parameter and set the TagID value by hand.

  • 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.
  • Language (Integer)(missing snippet link)
  • MarkupLanguage (String)

    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 LanguageControlling Output with Ektron Markup Language

  • MaxTagsDisplayed (Integer)

    The maximum number of tags to display. 0 (zero) = unlimited. If you set a maximum, and more than that number of tags are applied, then only the most frequently-used tags appear. For example, if you enter ten, the ten tags applied the most number of times appear.

  • OrderBy (String)

    The criteria by which the tags are ordered within the tag cloud. Choices are:

    • TaggedCount—sort by how many times a tag is assigned
    • Text—sort alphabetically by tag name
  • OrderByDirection (String)

    Select the direction of the OrderBy property. Choose Ascending or Descending.

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

    If you want a tag cloud’s items to link to a page that shows all items with that tag, add a path to a Web form page that hosts the appropriate search control. The path can be relative or absolute.

    • If the TagType is User or Community Group, enter a page hosting a Community Search server control.
    • If the TagType is Content or Library, enter a page hosting a Web Search server control.

    For example, in the Ektron Intranet starter site’s tagcloud.aspx page, the first 2 TagCloud controls link to users and community groups. So, this property is set to CommunitySearch.aspx, a Web form that hosts the CommunitySearch server control.

    When a site visitor clicks a tag cloud item, the Community Search page displays, populated with search results for the clicked tag. The visitor can click any result to see more about it.

    The following 5 parameters are added to the link’s QueryString, and pass tag information to the destination Web form. Its search server control uses the parameters to populate the search.

    • searchtag or searchgrptag—searchtag represents the tag’s text for users; searchgrptag represent the tag’s text for community groups
    • TagId—the clicked tag’s ID
    • TagLanguage—the clicked tag’s language; only search results in this language appear
    • TagCount—the number of times the tag has been assigned
    • TagType—the tag’s type: user, community group, content or library item. This value is obtained from the TagType property (described below).

    In addition to these parameters, you can add your own by defining them in the path. If you do, the above 5 parameters are appended to yours.

  • TagTemplateTarget (ItemLinkTargets)

    Determines the type of window that appears when you click a link in the server control.

    • _Self (default)—opens in same window.
    • _Top—opens in parent window.
    • _Blank—opens in new window.
    • _Parent—opens in the parent frame.
  • TagType (String)

    Select the type of tags that appear in the tag cloud. Choices are:

    • User
    • CommunityGroup
    • Content
    • Library
  • 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.