This tutorial demonstrates how to add a hierarchical taxon selector in a widget's designer view. You can select taxa from a hierarchical taxonomy like Categories or a custom classification of your choice. For more information about categories in Sitefinity CMS, see For developers: Hierarchical taxonomies. For more information on custom classifications in Sitefinity CMS, see Create custom classifications.
To add a Hierarchical taxon selector, in your DesignerView.YourView.cshtml file, place one of the following tags anywhere in the HTML code:
DesignerView.YourView.cshtml
Single item selection:
Multiple items selection:
The values of the attributes are scope properties that you define in the MVC widget controller.
To access the selected value, you use the sf-selected-item and sf-selected-item-id attributes. If multiple selection of items is enabled, you must use the sf-selected-items and sf-selected-ids attributes. For more information on multiple selection of items, see Use content item selectors.
sf-selected-item
sf-selected-item-id
sf-selected-items
sf-selected-ids
By default, the selector shows only categories but you can modify it to work with a hierarchical taxonomy of your choice. You do this by specifying a sf-taxonomy-id attribute that accepts a scope property holding the GUID of the taxonomy. For an example on how to find the ID of a taxonomy, see Hierarchical taxonomies API
sf-taxonomy-id
You can specify the dialog header using the sf-dialog-header attribute. By default, the dialog header is Select but if you set sf-dialog-header="Department", then the header is Select Department.
sf-dialog-header
sf-dialog-header="Department"
Sign up for our free beginner training. Boost your credentials through advanced courses and certification. Register for Sitefinity training and certification.
To submit feedback, please update your cookie settings and allow the usage of Functional cookies.
Your feedback about this content is important