IMPORTANT: This version of Sitefinity CMS is out of support and the respective product documentation is no longer maintained and can be outdated. Use the version selector to view a supported product version.

For developers: Customize the default view of widgets through widget definitions | WebForms

Widget definitions, or, control definitions in Sitefinity CMS are a developer concept that enables building structured declarative user interfaces. They facilitate reuse of components when building the backend user interface (UI) and also enable third-party developers to plug their own components to extend that UI. For more information about definitions, see For developers: Build the backend UI with Control definitions.

Each widget definition consists of views for the backend and the frontend that represent a specific UI, for example for actions like Edit, Insert, View Preview, and so on. In some cases, you need to extend the default functionality the UI views for the needs of a more complex scenario. To do that, you need to replace the default view with your custom one through the widget definitions.

Sitefinity's ContentView class and all its inheritors (widgets such as News, Blog Posts, Events, and so on) are important elements that build the Sitefinity CMS experience. They enable you to select the data you want to display, as well as data's behavior on the frontend.

This article demonstrates how to inherit from a ContentView class and directly manipulate its DataSource property to result in frontend filtering in any News widget. As every other widget that is derived from the ContentView class, the widget derived from the NewsView class also has a Master and a Details view. Since you want to filter the list of items displayed by the widget, you need to modify the News widget List of news template and inherit from its MasterView class.

You can download and set the template and map the new template to the News widget. Alternatively, you can do the whole procedure from scratch.

Was this article helpful?

Yes No

Would you like to submit additional feedback?

Your feedback about this content is important

How helpful is this article?

Very helpful Somewhat helpful Not helpful

How can we improve this article?(Optional)

Fix typos or links

Fix incorrect information

Add or update code samples

Add or update illustrations

Add information about...

Send feedback Cancel