API changes in Sitefinity CMS 10.2

PageData has new property VariationTypeKey. This property’s value is used to differentiate personalization page variations from A/B test page variations. For personalization page variations, its value is “pers”, and for A/B testing page variations it is set to “abtest”. An upgrade script runs upon first start of Sitefinity 10.2 that sets “pers” value for all personalization page variations that has been created before the upgrade.

SitefinityContextBase.GetSites method was added a new optional parameter – ifAccessible. It allows to get only the sites that the user has permission to access from UserActivityManager cache. This is backward compatible as it does not change the behavior of previous uses without passing the parameter – in that case it still returns all the sites.

The below properties, fields, classes and enums have been removed in regards to the removal of the Silverlight Video player in Sitefinity

• Telerik.Sitefinity.Modules.Libraries.Configuration.LibrariesConfig.MediaPlayerMode
  
• Telerik.Sitefinity.Modules.Libraries.Configuration.LibrariesConfig.UploadMode
  
• Telerik.Sitefinity.Modules.Libraries.Web.UI.EmbedControl.DefaultSilverlightEmbedStringTemplate
  
• Telerik.Sitefinity.Modules.Libraries.Web.UI.ThumbnailMediaPlayerDialog.MediaPlayerMode
  
• Telerik.Sitefinity.Modules.Libraries.Web.UI.Videos.MediaPlayerControl.MediaPlayerMode
  
• Telerik.Sitefinity.Modules.Libraries.Web.UI.Videos.MediaPlayerControl.SilverlightPlayerSkin
  
• Telerik.Sitefinity.Modules.Libraries.Web.UI.Videos.MediaPlayerControl.TemplatePath
  
• Telerik.Sitefinity.Modules.Libraries.Web.UI.Videos.ThumbnailMediaPlayerControl.MediaPlayerMode
  
• Telerik.Sitefinity.Web.Configuration.ConfigDescriptions.MediaPlayerMode
  
• Telerik.Sitefinity.Web.Configuration.ConfigDescriptions.UploadMode
  
• Telerik.Sitefinity.Web.UI.Fields.FileField.UploadMode
  
• Telerik.Sitefinity.Web.UI.Fields.ThumbnailField.MediaPlayerMode
  
• Telerik.Sitefinity.Modules.Pages.ScriptRef.Silverlight
  

• Telerik.Sitefinity.Modules.Libraries.Configuration.LibrariesFileUploadMode
  
• Telerik.Sitefinity.Modules.Libraries.Configuration.LibrariesMediaPlayerMode
  
• Telerik.Sitefinity.Modules.Libraries.Web.LibrariesRadUploadHandler
  
• Telerik.Sitefinity.Modules.Libraries.Web.UI.Videos.ThumbnailControl
  

• Telerik.Sitefinity.Analytics.Infrastructure.Services.AnalyticsAccountService.GET is renamed to Telerik.Sitefinity.Analytics.Infrastructure.Services.AnalyticsAccountService.Get
  
• Telerik.Sitefinity.Analytics.Infrastructure.Services.AnalyticsAccountService.POST is renamed to Telerik.Sitefinity.Analytics.Infrastructure.Services.AnalyticsAccountService.Post
  

Introduced performance optimizations when working with Discount and CartDiscount objects. Discounts are no longer fetched on each operation inside the method logic but can be passed as an optional method parameter instead and this parameter will be used in the method execution chain.

NOTE: This change enables you to pass a list of discounts when working with the respective methods. Keep in mind you need to manually filter the list for active discounts (OrdersManager.GetDiscounts().Where(x => x.IsActive).ToList(); ) as the default implementation will not apply the filtering. If you pass any non-active discounts, Sitefinity will treat them the same way and will apply them as well. If you do not pass any discounts Sitefinity will get them using the old logic.

Changed interfaces 

Telerik.Sitefinity.Modules.Ecommerce.Orders.Interfaces.IDiscountCalculator

New method signatures:

• Telerik.Sitefinity.Modules.Ecommerce.Orders.Interfaces.IDiscountCalculator.ApplicableCartDiscounts – gets all applicable CartDiscounts for the CartOrder from a list of Discounts
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Interfaces.IDiscountCalculator.CalculateAndApplyOrderDiscounts – new overload of the CalculateAndApplyOrderDiscounts method which accepts a List<CartDiscount>
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Interfaces.IDiscountCalculator.SumRoundedOrderDiscounts - new overload of the SumRoundedOrderDiscounts method which accepts a List<CartDiscount>

Changed method signatures:

• Telerik.Sitefinity.Modules.Ecommerce.Orders.Interfaces.IDiscountCalculator.CalculateAndApplyOrderDiscounts – accepts a List<Discount> as an optional parameter
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Interfaces.IDiscountCalculator.SumRoundedOrderDiscounts - accepts a List<Discount> as an optional parameter
  
  
  

Changed functions

All methods listed below now accept a List<Discount> as an optional parameter. If none is specified, Sitefinity will use all active discounts.

• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.DiscountCalculator.ApplicableCartDiscounts
  
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.DiscountCalculator.CalculateAndApplyOrderDiscounts
  
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.DiscountCalculator.SumRoundedOrderDiscounts
  
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.Calculators.DiscountCalculatorBase.ApplicableCartDiscounts
  
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.Calculators.DiscountCalculatorBase.CalculateAndApplyOrderDiscounts
  
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.Calculators.DiscountCalculatorBase.SumRoundedOrderDiscounts
  

New functions

• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.DiscountCalculator.ApplicableCartDiscounts - gets all applicable CartDiscounts for the CartOrder from a list of Discounts
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.DiscountCalculator.CalculateAndApplyOrderDiscounts - new overload of the CalculateAndApplyOrderDiscounts method which accepts a List<CartDiscount> parameter
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.DiscountCalculator.SumRoundedOrderDiscounts - new overload of the SumRoundedOrderDiscounts method which accepts a List<CartDiscount> parameter
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.Calculators.DiscountCalculatorBase.CalculateAndApplyOrderDiscounts - new overload of the CalculateAndApplyOrderDiscounts method which accepts a List<CartDiscount> parameter
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.Calculators.DiscountCalculatorBase.SumRoundedOrderDiscounts - new overload of the CalculateAndApplyOrderDiscounts method which accepts a List<CartDiscount> parameter
• Telerik.Sitefinity.Modules.Ecommerce.Orders.Business.Calculators.DiscountCalculatorBase.SumRoundedOrderDiscounts - new overload of the CalculateAndApplyOrderDiscounts method which accepts a List<CartDiscount> parameter

New empty value for non-nullable GUID array field – empty array