Add a Related users custom field

You can relate Sitefinity users to a Dynamic Content Module by using a field control that lets you select the users that will be related to your dynamic content items. The users are stored as an array of user identifiers (Guid[]).

For this field control, you need a Sitefinity web application, as defined in the following example:

  1. Add the source code from the repository at https://github.com/Sitefinity/related-users-field-control to your SitefinityWebApp project.

    If you used the same folder structure as in that repository, the CLR type of the field control is:

    SitefinityWebApp.FieldControls.RelatedUsers.RelatedUsersField
  2. Build your solution and run your Sitefinity application.

  3. In the Module Builder window, add a new field to the Dynamic Module you want to extend:

    related users Module Builder

  4. Fill in the new field properties as shown in this example:

    • Name: NewField
    • Type: Array of GUIDs
    • This is a hidden field: unchecked
    • Type or Virtual path of the custom widget: SitefinityWebApp.FieldControls.RelatedUsers.RelatedUsersField
  5. When you open your content module to add or edit an item, you see the RelatedUsers control:

    Access to Related Users dialog

    Clicking Select Users… opens the selection dialog, as illustrated:

    Selecting from Related Users

You can further adjust the user selector to fit your requirements. Because it is based on the Sitefinity FlatSelector, the options can be easily modified in the template file of the user selector field, RelatedUsersField.ascx. Common adjustments are for: AllowPaging, PageSize, AllowMultipleSelection, AllowSearching, and ShowProvidersList.

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

Manage item relations