AdaptiveImages 2.0.9.9

Adaptive Images add-on for Optimizely

DOCUMENTATION

Developer documentation: https://sdk.adaptiveimages.net

When add-on is installed and enabled, user documentation is available in the help menu (question mark icon) in the global navigation of the Optimizely UI.

To enable the addon, invoke something like the follwing in your Startup class:

public void ConfigureServices(IServiceCollection services)
{
    services.AddCms()
            .AddAdaptiveImages(); // Enable the add-on
}

NOTE: Developer documentation is only available when in debug mode, or when logged in as an administrator.

IMAGE PROVIDERS

To test with an external image provider, you may install the "AdaptiveImages.Unsplash" NuGet package and enable it in your Startup class:

public void ConfigureServices(IServiceCollection services)
{
    services.AddCms();
            .AddAdaptiveImages();
            .AddUnsplash(); // Enable the Unsplash image provider
}

When at least one searchable image provider is added, the "Image bank" tab is displayed in the edit UI. Note that you may need to "Reset views" in user settings for the component to appear.

UPGRADING FROM 1.X

  • Remove old package (TedGustaf.Episerver.AdaptiveImages) and remove the \\modules\\_protected\\TedGustaf.Episerver.AdaptiveImages folder and any app settings from web.config
  • Install new package (AdaptiveImages) and enable the addon as described above, optionally passing settings to the AddAdaptiveImages() method
  • Change any references to the TedGustaf.Episerver.AdaptiveImages namespace to simply AdaptiveImages
  • If you run into problems with model synchronization, you may need to set ModelType to null in tblContentType in the database for the SingleImage and AdaptiveImage types (currently being investigated as a bug in the CMS) and restart the website (this is because of the namespace change for the content types)
  • Refer to the integrated documentation on how to configure the add-on in your Startup class

SUPPORT

Visit https://adaptiveimages.net or send e-mail to: [email protected] @tedgustaf and @tednyberg are also active on Twitter for any questions or feedback.

CHANGE LOG

Version Summary
2.0.7.14 Multi-target builds, separate assemblies for .NET 5, 6, and 7.
2.0.2.29 Support for multiple proportions formats, explicit focal points, additional rendering options.
2.0.0 .NET 5 / CMS 12 support. Cloudinary no longer required for production environments.
1.2.2021.05210 Rendering quality settings to override auto.
1.2.2021.03300 Progressive encoding and quality options can be set through ImageRenderSettings for URL providers that support it. Improved crop dialog performance for large images.
1.2.2021.01110 Ability to show original image ID in the crop dialog.
1.2.2020.11171 Requirement on Episerver 11.20.2 or above because of Episerver bug CMS-17430 regarding proxy generation which affected globalization features.
1.2.2020.10202 Support for lazy loading.
1.2.2020.10050 Fixed isses with incorrect default rendering widths when using PropertyFor.
1.1.2020.09191 Improved behavior in cropping dialog when cropping near edges.
1.1.2020.09092 Support for image properties on POCO objects for IList properties, using base classes ImagePropertyList/ImagePropertyListEditorDescriptor/AdaptiveImagePropertyListItem/SingleImagePropertyListItem, and SingleImageConverter/AdaptiveImageConverter JSON converters for any additional image properties on the list item type.
1.1.2020.08280 TinyMCE plugin handles standard insert image dialog, offering user to convert Episerver image to adaptive image.
1.1.2020.08273 TinyMCE plugin handles native Episerver images (drag and dropped from the "Media" component) as adaptive images.
1.1.2020.08140 Support drag-and-drop of local image file, uploading the file to the current assets folder.
1.1.2020.05280 Support for required image properties (RequiredImage attribute).
1.1.2020.05200 Support for culture-specific image properties (CultureSpecificImage attribute).
1.1.2020.05190 Paging support for image providers.
1.1.2020.05180 Support for adaptive image descriptions (alt texts).
1.1.2020.05130 Support for single form factor image properties (SingleImage property type).

Showing the top 5 packages that depend on AdaptiveImages.

Packages Downloads
AdaptiveImages.Azure
Provides support for using blob storage for image caching.
3,561
AdaptiveImages.Unsplash
Makes Unsplash images searchable in the Optimizely UI for use with the Adaptive Images add-on.
3,082
AdaptiveImages.Cloudinary
Adds support for Cloudinary image optimization and CDN delivery.
2,490
AdaptiveImages.Cumulus
Requires Cumulus DAM. Makes Cumulus images searchable in the Optimizely UI for use with the Adaptive Images add-on.
1,869
AdaptiveImages.Pickit
Requires Pickit DAM. Makes Pickit images searchable in the Optimizely UI for use with the Adaptive Images add-on.
1,529

Improvements to features, performance, compatibility, and/or stability.

.NET 6.0

.NET 7.0

.NET 8.0

Version Downloads Last updated
2.0.9.9 662 03/01/2024
2.0.9.4 103 01/31/2024
2.0.9.3 40 01/15/2024
2.0.8.4 361 10/20/2023
2.0.7.64 19 09/25/2023
2.0.7.55 533 05/15/2023
2.0.7.46 241 04/18/2023
2.0.7.38 22 04/12/2023
2.0.7.34 87 03/29/2023
2.0.7.31 52 03/23/2023
2.0.7.27 60 03/20/2023
2.0.7.9 267 11/10/2022
2.0.6.24 454 09/20/2022
2.0.6.23 57 09/14/2022
2.0.6.22 52 09/06/2022
2.0.6.19 54 08/18/2022
2.0.6.18 54 08/17/2022
2.0.5.8 277 06/01/2022
2.0.5.2 61 05/05/2022
2.0.5.1 65 04/20/2022
2.0.4.41 74 04/12/2022
2.0.4.31 120 03/01/2022
2.0.4.26 183 02/16/2022
2.0.4.23 68 02/15/2022
2.0.4.18 68 02/10/2022
2.0.4.9 65 02/10/2022
2.0.4.7 86 02/06/2022
2.0.4.6 74 02/03/2022
2.0.3.7 72 01/26/2022
2.0.2.31 170 01/12/2022
2.0.2.30 66 01/11/2022
2.0.2.29 101 01/06/2022
2.0.2.28 74 01/05/2022
2.0.2.16 120 12/13/2021
2.0.2.15 145 12/10/2021
2.0.2.12 76 12/03/2021