Try our conversational search powered by Generative AI!

Shannon Gray
Nov 14, 2016
(2 votes)

Promotion Engine Sale Price Customization

Overriding how sale prices are calculated in Episerver’s promotion engine for SKUs and packages outside of the cart requires a minor customization. Good examples of where this applies are category landing page and product detail pages where you may show a discount price(s). Sales price calculation is usually done by a) evaluating the prices associated with a SKU or package and b) applying the site’s business rules to determine the correct price of an item for a customer. The sales price is calculated in the promotion engine to determine the price from which to subtract the promotion discounts. As I previously mentioned here, using the PromotionEngine GetDiscountPrices() method involves an important constraint: It has a default sale price calculation built in which may or may not fit your site’s business rules. Here is how to customize the promotion engine to use alternate pricing calculation logic.

The sale price for items to be evaluated in the promotion engine is calculated in the PromotionEngineContentLoader class by calling the ReadOnlyPricingLoader GetDefaultPrice() method. This method returns the lowest “All Customer” price for an item that has a valid date and is the correct currency and market for the current customer. So it doesn’t use customer-specific, price group, or custom sale price types to calculate the sale price. An instance of PromotionEngineContentLoader is stored in the IOC container and used in the promotion engine - so it can be overridden in your implementation.

To override this sale price calculation in the promotion engine, create a class that inherits from PromotionEngineContentLoader and then configure your IOC container to use this new implementation. Here’s an example of how you can do this:

   1: public class CustomPromotionEngineContentLoader : PromotionEngineContentLoader
   2: {
   3:     public CustomPromotionEngineContentLoader(
   4:             IContentLoader contentLoader, 
   5:             CampaignInfoExtractor campaignInfoExtractor, 
   6:             ReadOnlyPricingLoader readOnlyPricingLoader) : base(contentLoader, campaignInfoExtractor, readOnlyPricingLoader){ }
   8:     public override IOrderGroup CreateInMemoryOrderGroup(ContentReference entryLink, IMarket market, Currency marketCurrency)
   9:     {
  10:         var orderGroup = new InMemoryOrderGroup(market, marketCurrency);
  12:         //this is where you can reference your own pricing calculator to retrieve the right sale price
  13:         IPriceValue price = YourSalePriceCalculator.GetSalePrice(entryLink);
  15:         if (price != null)
  16:         {
  17:             orderGroup.Forms.First().Shipments.First().LineItems.Add(new InMemoryLineItem
  18:             {
  19:                 Quantity = 1,
  20:                 Code = price.CatalogKey.CatalogEntryCode,
  21:                 PlacedPrice = price.UnitPrice.Amount
  22:             });
  23:         }
  25:         return orderGroup;
  26:     }
  28: }

Notice that an IOrderGroup is used to contain the SKU or package. The InMemoryOrderGroup is simply an implementation of that interface that allows carts and one-off SKUs or packages to be processed for promotion calculation in the same way. This also simplifies promotion calculation. It allows for the custom promotion processors (see here) that you create to simply process the IOrderGroup instance rather than having separate methods for one-off items and carts. The PromotionProcessorContext class contains an IOrderGroup property and is passed into the Evaluate() method for promotion processor classes.

Finally, add initialization of your IOC container to point to your custom implementation like this:

   1: [ModuleDependency(typeof(EPiServer.Commerce.Initialization.InitializationModule))]
   2: public class DiscountCalculateInitialization : IInitializableModule, IConfigurableModule
   3: {
   4:     public void ConfigureContainer(ServiceConfigurationContext context)
   5:     {
   6:         context.Container.Configure(c => c.For<PromotionEngineContentLoader>().Singleton().Use<CustomPromotionEngineContentLoader>());
   7:     }
   9: }

The ModuleDependency ensures that the new implementation is set/used, overriding the original implementation set in Episerver’s commerce initialization module.

As you can see, overriding the promotion engine sale price takes very little effort. I think the new promotion engine has made calculating discounts a lot easier with a straight-forward and exposed model that can be overridden.

Nov 14, 2016


Erik Norberg
Erik Norberg Jun 21, 2017 03:16 PM

This is more complicated than it has to be, you can use the default PromotionEngineContentLoader there is no need to override it.

It uses the ReadOnlyPricingLoader.GetDefaultPrice which in turn calls IPriceService.GetDefaultPrice, which really is the one you need to override.

Write your own IPriceService with your custom logic in the GetDefaultPrice function and register our own IPriceService and the promotion engine will work the way you want.

Toke Frostholm
Toke Frostholm Sep 10, 2020 12:13 PM

@Erik can you provide an example of such implementation? I am struggling getting my overridden GetDefaultPrice to fire after calling IPromotionEngine.Run.

Please login to comment.
Latest blogs
Optimizely Web... 6 Game Changing Features in 2024

If you are interested in learning about what's new within Optimizely Web, you are in the right place. Carry on reading to learn about the 6 greates...

Jon Jones | Mar 3, 2024 | Syndicated blog

Headless forms reloaded (beta)

Forms is used on the vast majority of CMS installations. But using Forms in a headless setup is a bit of pain since the rendering pipeline is based...

MartinOttosen | Mar 1, 2024

Uploading blobs to Optimizely DXP via PowerShell

We had a client moving from an On-Prem v11 Optimizely instance to DXP v12 and we had a lot of blobs (over 40 GB) needing uploading to DXP as a part...

Nick Hamlin | Mar 1, 2024 | Syndicated blog

DbLocalizationProvider v8.0 Released

I’m pleased to announce that Localization Provider v8.0 is finally out.

valdis | Feb 28, 2024 | Syndicated blog