SuperValueConverters

SuperValueConverters is a collection of powerful property value converters for Umbraco, eliminating the need for casting and null checks on Umbraco picker values in views or controllers and helping to keep code cleaner.

v1.x supports Umbraco 7.7+, v2.x supports Umbraco 8, v3.x supports Umbraco 9, and v4.x supports Umbraco versions 10 and beyond.

Usage

Once installed you don't need to do anything to activate SuperValueConverters.

Where a picker that returns multiple items (such as MNTP or Nested Content) has been configured to only allow a single item to be selected (via it's "maxItems" setting), the returned value will now be a single IPublishedContent rather than IEnumerable<IPublishedContent>.

Supported value converters will no longer return null if no value has been picked - an empty collection will be returned instead, preventing the need for null checks.

Currently the following datatypes are supported:

• Multi-Node Tree Picker
• Nested Content

Models Builder

SuperValueConverters works seamlessly with Models Builder (if you're using it) to return the correct model types from pickers rather than IPublishedContent.

Where a picker has been configured to only allow items of a specific doctype, the returned value will be already cast to the relevant Models Builder generated model.

In cases where an allowed doctype uses compositions Models Builder will generate an interface for that model. If more than one allowed doctype on a given picker implements the same interface, the returned value will be cast to the shared interface rather than the default IPublishedContent.