Topics

All topics

Configure custom widgets to support content locations

To configure your custom widget to support content locations, you must mark the widget with the following property:
[SitefinityWidget(IsContentLocation = true)]

GITHUB EXAMPLE: You can see an example of how to use this property in Sitefinity GitHub Repository » ContentListViewComponent.cs.

To support the content locations functionality, in the widget, you should also provide the following properties via the Entity object :

Property Description

SelectedItems
(Required)

 Holds the selected items.

ContentViewDisplayMode
(Optional)

Determines the behavior of the widget. It can be one of the following:

  • Automatic - Automatically determines whether to render the items in list mode or detail mode.
    This is the default behavior.
  • Master - Always displays items in list mode and does not handle additional parameters. 
  • Detail - Always displays items in detail mode based on the selection of the first item from the manually selected items. 

DetailPageSelectionMode (Optional)

Determines how to open the detail mode of content items inside the content widget:

  • SamePage - Opens the detail item in the same page.
  • ExistingPage - Opens the detail item in another existing page.
    Requires property DetailPage to be present. 

DetailPage
(Required, if ExistingPage is selected)

 When you have chosen to open the detail mode of an item in another existing page, this property gets the details page. 

The following sample demonstrates how to use the above properties:

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?

Next article

Customize icons in the widget selector