Son Do
Oct 8, 2022
visibility 5092
star star star star star star
(1 votes)

Adding market to Optimize Commerce site url in .net core

As we all know, CMS 12 and Commerce 14 a brought brand new evolution to the developer, with .net core, performance improvement and headless style. Beside the great announcement, the major version contains a lot of breaking changes which were highlight in the document. However, we need to migrate one by one in each document section.

In the topic today, I'd like to dig a bit into the routing which was introduced in CMS 12.

I faced a challenge that is adding the market id to site url. The expectation is the site url contains language, market and the rest of content, it should be like https://mycommercesite/en/sw/new-arrivals/ for the CMS content, where en is language code and sw (Sweden) is a market id.  In addition, the Commerce products content url should looks like https://mycommercesite/en/sw/fashion/mens/mens-sweatshirts/p-22471481/ , and I need to remove fashion - the catalog name as well since we used only 1 catalog. The requirement is great, clear enough and a challenge :) 

Market routing in url

I found some blog post, forum post which relates to this request. The Māris' blog post could be mentioned as a solution which can be applied to CMS 11 and below, the post is great, but unfortunately, it cannot be applied to .Net core and CMS 12 site.

So I dig into a couple of documents for routing in CMS 12

  • The routing setion in breaking changes document
  • The IPartialRouter interface and it’s sample code document 
  • IPartialRouter<TContent, TRoutedData> and PartialRouter<TIncoming, TOutgoing> class document 

I read them a couple of time, tried a couple of way and  finally, I found a possible way to do this stuff.
Now let go to the code and I will explain the solution in detail.

First of all, in the sample code for News partial routing, it said about IPartialRouter: Make the partial router handle incoming requests beyond pages of type NewsContainer. Also, allow outgoing FURLs to be created for instances of NewsContent. So which means we can use IPartialRoute for all the pages - PageData :) 

I folked the latest version of Foundation project and created MarketPageDataPartialRouting.cs, you can get it in my github.

In this file, there are 2 most important methods: 

  • object RoutePartial(...) this method handles imcomming request
  • PartialRouteData GetPartialVirtualPath(...) this method handles outgoing url

Members of IPartialRouter

In the GetPartialVirtualPath method, we will get the current market id and set to url, in current language.

PartialRouteData GetPartialVirtualPath

This step help us create the link with language and market in our site.

In the RoutePartial, we will look for the market id in url segment and set it to current market if needed, then also process the rest of the content, returns correct content for that url.

RoutePartial and Process Market Segment

This step handles the incomming request with language and market in site url.

However, we need to register our Market partial routing to the site using PartialRouteHandler.RegisterPartialRouter to make the routing works as expected.

Register Market routing

You can get the code in the Foundation project in my github, MarketPageDataPartialRouting.cs file. And that is for CMS content, I'll create Commerce content in another post.

Bonus tip: we can use the HttpContextExtensions.GetContentLink(HttpContext) to get the current  page content link :) it's useful.

Hope this make developer life easier :)) If you have any comment about the solution, could be better way, please let me know :)
Btw, I'm glad to be back to Optimizely Commerce after 3 years, a pretty long time :)

Oct 08, 2022

Comments

Øyvind Wabakken Hognestad
Øyvind Wabakken Hognestad Oct 19, 2022 06:51 AM

Link to  MarketPageDataPartialRouting.cs is broken.

Son Do
Son Do Oct 19, 2022 09:28 AM

Thank @Hognestad, I fixed the link :)

Johan Björnfot
Johan Björnfot Oct 21, 2022 03:01 PM

I have not tried but I think an alternative could be to hook up event handlers to 

IContentUrlGeneratorEvents.GeneratedUrl

and

IContentUrlResolverEvents.ResolvingUrl

In the first event handler (outgoing) you would add market segment to the url (and remove fashion) while you in the second (incoming) would consume/remove the market segment and add back fashion segment. 

As I said I have not tested it but in theory it should work and might be simpler solution. 

Paul McGann (Netcel)
Paul McGann (Netcel) Feb 2, 2023 08:06 PM

Hi Son Do,

Great write up, I was just wondering if you ever got round to the commerce piece of this and if so would you mind sharing?

Thanks

Paul

error Please login to comment.
Latest blogs
Integrating a Third-Party DAM into Optimizely CMS 12: A Case Study

There is no handbook for wiring an external DAM into Optimizely CMS 12. This case study walks through the research, dead ends, and breakthroughs —...

WilliamP | Jul 7, 2026 |

Ringing a Physical Sales Bell from Optimizely Commerce

This one started as a weekend project that got a little out of hand. I built an “On Air” sign for my office — one of those LED signs streamers use ...

KennyG | Jul 6, 2026

Exploring Asset Lifecycle Management Approaches for Bynder and Optimizely SaaS CMS

Note: This is Part 3 of our Bynder integration series. For setup and filtering prerequisites, see Part 1  and  Part 2 . Introduction In my previous...

Vipin Banka | Jul 5, 2026

Unlock AI-Ready Experiences with Optimizely

Over the past few months, almost every customer conversation has shifted from SEO to AI readiness. The questions are no longer just: “How do we......

Madhu | Jul 5, 2026 |

Planning Your Bynder DAM and Optimizely SaaS CMS Integration the Right Way: Avoiding Asset Sprawl and Unnecessary Synchronization

Note: This is Part 2 of our Bynder integration series. If you missed the Part 1, check out " Implementing the Bynder DAM Connector with Optimizely...

Vipin Banka | Jul 4, 2026

Implementing the Bynder DAM Connector with Optimizely SaaS CMS: Lessons Learned

What I learned while integrating Bynder DAM with Optimizely SaaS CMS, exploring Optimizely Graph, and building a headless frontend experience....

Vipin Banka | Jul 3, 2026