Move Webshop Site Settings outside the website root


Description

This article describes how to configure Sitecore Ecommerce website to use Webshop Site Settings located outside the website root item. It affects SES 2.0 - 2.1 versions.

Requirements:
By default, the Sitecore Ecommerce Services module requires Webshop Site Settings to be stored under the website root item. However, if you want to separate the content and general settings of the website, the following procedure can be used.

Solution

  1. Place the Sitecore.Support.379399.dll file in the /Bin folder of your website.
  2. Extract and put the Sitecore.Support.379399.config file into the /App_Config/Include folder of your website.
  3. Specify the absolute path of the Webshop Site Settings item as a value of the EcommerceSiteSettings setting of the appropriate webshop site definition, for example: 
    <site name="example" … EcommerceSiteSettings="/sitecore/content/Site Settings" … />
Notes:
  1. The solution overrides the functionality of the following processors:
    • Sitecore.Ecommerce.Shell.Pipelines.HttpRequest.ShellShopResolver - amendments in the processor are needed for proper functionality of the Product Catalog editor (in the Sitecore Desktop).
    • Sitecore.Ecommerce.Pipelines.GetConfiguration.GetFromContextSite - amendments in the processor are needed for proper functionality of the frontend website.
    • Sitecore.Ecommerce.Apps.Pipelines.HttpRequest.MerchantShopResolver - amendments in the processor are needed for proper functionality of the Order Manager tool.
  2. The Sitecore.Support.379399.config file overrides the definition of the Sitecore.Ecommerce.Apps.Pipelines.HttpRequest.MerchantShopResolver processor that is defined in the /App_Config/Include/Sitecore.Ecommerce.Apps.OrderManagement.config file.
    If the <ShopContextName> attribute of the processor is already specified in your configuration, you should copy the value of the attribute to the Sitecore.Support.379399.config file.
  3. The solution provides an opportunity to use an absolute path or a relative path (relative to the StartItem of the webshop site) as a value of the EcommerceSiteSettings setting of the appropriate webshop site definition.