Toolbox filtering: Implement the IToolboxFilter interface

The IToolboxFilter interface provides an extension point for filtering toolbox sections and toolbox items. 

  1. In Visual Studio, open the context menu of your project and click Add » Class.
  2. Name the class file RoleToolboxFilter.cs and click Add.
  3. Make the RoleToolboxFilter implement the IToolboxFilter interface.
  4. Create a constructor that accepts an IToolboxFilter object.
    The constructor forms a chain of responsibility, where each toolbox filter points to an instance of the next filter in line.
  5. Implement the IsSectionVisible() method from the IToolboxFilter interface.
    The code checks whether a toolbox section complies with the specified conditions to be visible. It also calls the IsSectionVisible() method of the next filter in line. The method accepts the toolbox section and an IToolboxFilterContext context as parameters.
    Optionally, since Sitefinity CMS version 12.0 you can implement additional filtering logic using the IToolboxFilterContext. It provides the following information:
    • MediaType - the media type indicates whether the toolbox is loaded in the context of the Pages, Templates, Forms, or Email campaigns modules screens. If you want your filtering to be applied only to some of these modules you can implement conditional logic based on this property.
    • ContainerId - the container Id property can help you distinguish in your code, whether you are working with the widgets toolbox or the layout controls toolbox. The possible values are LayoutToolboxContainer and ControlToolboxContainer respectively.
  6. Implement the IsToolVisible() method from the IToolboxFilter interface.
    The code checks whether a widget complies with the specified conditions to be visible. It also calls the IsToolVisible() method of the next filter in line.
  7. Implement the role filtering logic, by passing a set of tags, representing the roles that can view a section or a tool, on method call.
    Using the ClaimsManager class, the code retrieves the current user identity and compares the set of tags with the current user's roles. It returns a result that indicates if any of them overlap.

Use the following code sample:

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?