The new and improved Media picker UI/UX introduced in Umbraco 8.14. Click here for full-screen video.
This has now been addressed in 8.15. You can switch the property editor from an old “mediapicker2” to “mediapicker3” and it should just work 🎉 If you want to make use of the new local cropping feature, just be aware that you will potentially need to update your frontend code to render specific crops. You can see examples directly on this issue (it’s now IPublishedContent) and we’ll have updated documentation for the final release.
We’d appreciate feedback on the data “migration” from the old to the new Media picker, so if you can try the switch out with the release candidate installed and report any issues that would be really helpful.
And much more…
There are quite a few additional improvements in the release, see the full list on the download page.
Breaking changes
There are a few breaking changes in relation to the updates for the new Media picker. These should be minor and are mostly functional changes but can be good to be aware of if you’ve already implemented the new Media picker using Umbraco 8.14:Â
- MediaWithCrops model: no parameterless constructor and properties don't have a setter anymore
- Removed ambiguous method: IHtmlString GetCropUrl(this UrlHelper urlHelper, ImageCropperValue imageCropperValue, string cropAlias, bool htmlEncode = true) (was also available as separate PR #10527)
Functional changes:
- Local crops are merged with media crops when using the GetCropUrl() extension methods on MediaWithCrops
- The GetLocalCropUrl() extension methods are now obsoleted because of this
- The concrete implementation of MediaWithCrops model is now MediaWithCrops<T> and implements IPublishedContent
- The MediaItem property is obsoleted, as it's now recommended to use the Content property (that is of a specific type when using the generic model)
- Only configured crops are returned in the ImageCropperValue and MediaWithCrops models
See the original issue for more information.
How to test
First, you need to make a new Umbraco installation from 8.15RC (links below) or upgrade an existing project, both scenarios can provide valuable feedback.
If you find things in the RC that are not working, we’d be grateful for feedback on the Github issue tracker. You’re welcome to add comments to the features and fixes listed under 8.15 release or submit new bug reports (click New Issue and select Bug Report), please prefix the issue with 8.15RC:.