Tags widget

Use the Tags widget to display tags on your page. The tags are then used to filter content. By clicking different tags from the list of tags displayed on the webpage, the user can filter the content on the page.

PREREQUISITES: You have created at least two tags.

For more information about when and how to use tags, see Use tags.

To configure the Tags widget, perform the following:

  1. After you have dragged the Tags widget on your page, click Edit button in the upper-right corner of the widget.
    The Edit window appears in advanced mode.
  2. In BaseUrl input field enter the URL name of the page which content you want to filter using tags.
    This page can be either the same page on which the Tags widget is, or it can also be another page.
    For example, you can display the tags on one page of your website, but if the user clicks a tag, the system opens another page and filters its content.

    NOTE: You enter the URL name in the following format ~/<URL name of page>. For example, if the title of the page is About us, the automatically generated URL name is about-us (in case you have not changed it), then in BaseUrl input field you enter ~/about-us.
    You can find out the URL name of a page in the address bar of the browser, when a page is opened in content editing mode. The URL name is the name after the name of the project (http://…/project name/page-name/…) or you can see the URL name in the properties of the page. For more information, see Edit and delete a page.

  3. To configure how the widget displays the tags, in RenderAs input field, enter one of the following:
    • HorizontalList
      The widget displays tags in a horizontal list.
    • VerticalList
      The widget displays tags in a vertical list.
    • Cloud
      The system tags in a horizontal list. The more items are tagged with a tag, the larger font the system uses to display this tag.
  4. To change the default sorting of the tags, in SortExpression input field, enter the desired sorting.
    For example, Title ASC
  5. To display only a list of particular tags, perform the following:
    1. In field TaxaToDisplay, enter Selected.
    2. In SelectedTaxaIds, enter one or more tags’ GUIDs, separated by semicolon.
      For example, CCE147AC-DAD1-6F1C-989A-FF000075ADAC;CDE147AC-DAD1-6F1C-989A-FF000075ADAC;
  6. To display tags that are not assigned to any content type, in ShowEmptyTaxa, entertrue.
    By default, the tags that have no items tagged with them are not displayed.
  7. To filter the items tagged with a particular tag according to their content type, you use input field ContentType:
    To display only:  In ContentType field, enter: 
    Blog posts  Telerik.Sitefinity.Blogs.Model.BlogPost 
    Events  Telerik.Sitefinity.Events.Model.Event 
    News  Telerik.Sitefinity.News.Model.NewsItem 
    Images  Telerik.Sitefinity.Libraries.Model.Image 
    Videos  Telerik.Sitefinity.Libraries.Model.Video 
    Documents  Telerik.Sitefinity.Libraries.Model.Document 

    For example, when you click a tag and you want only events tagged with this tagged to be displayed, in ContentType enter Telerik.Sitefinity.Events.Model.Event.

    NOTE: To show tags that are assigned only to a specific dynamic content type, in field DynamicContentType, enter Telerik.Sitefinity.DynamicTypes.Model.<Module_name>.<ContentType_name>

  8. Click Save.
  9. The system saves the setting and closes the editing mode of the widget.

For more information about creating tags, see Create tags.
For more information about how to tag a content item, see Add categories and tags to content items.
For more information about configuring other properties, see Advanced configuration of widgets.

Configure the Tags widget to display custom classification

To display a custom simple list classification, you can use the Tags widget. After you have created a Create custom classifications, perform the following:
  1. Drag the Tags widget on your page and click Edit button in the upper-right corner of the widget.
    The Edit window appears in advanced mode.
  2. Delete the contents of field TaxonomyId and click Save.
    A list of all created classifications and they IDs appears.
  3. Copy the TaxonomyId of the classification which you want to display.
  4. Click Edit button in the upper-right corner of the widget.
  5. Paste the ID of the classification in TaxonomyId field.
  6. In field FieldName, enter the classification name of the taxonomy field as specified on the module.
    For example, Geographic regions. This is different than the single item name, for example, Geographic region.
    The purpose of this property is to specify which hierarchical taxonomy will be used, because there might be more than one.
  7. To further configure the widget, perform Step 2 to Step 4 of the above procedure.

Additional resources

ARTICLES

Was this article helpful?