Since the beginning of Catalog UI, it had always shown Name, in both Catalog Tree and the Catalog content list.
That, however, was changed to DisplayName
since 13.14 due to a popular feature request here https://world.episerver.com/forum/developer-forum/Feature-requests/Thread-Container/2019/12/use-localized-catalog-in-commerce-catalog-ui/#214650
All is good and the change was positively received. However not every is happy with it – some want it the old way, i.e. `Name` to be displayed. From a framework perspective, it might be complex to let partners configure which field to display. But if you are willing to do some extra work, then it’s all easy.
Catalog content is transformed using CatalogContentModelTransform
, this is where DisplayName
is added to the data returned to the client. If you override that, you can set DisplayName
to whatever you want, for example, Name
.
Here is what the implementation would look like
using EPiServer.Cms.Shell.UI.Rest.Models.Transforms;
using EPiServer.Commerce;
using EPiServer.Commerce.Catalog;
using EPiServer.Commerce.Catalog.ContentTypes;
using EPiServer.Commerce.Catalog.Linking;
using EPiServer.Commerce.Shell.Rest;
using EPiServer.Framework.Localization;
using EPiServer.ServiceLocation;
using Mediachase.Commerce.Catalog;
using Mediachase.Commerce.Customers;
using Mediachase.Commerce.InventoryService;
using Mediachase.Commerce.Markets;
using Mediachase.Commerce.Pricing;
namespace EPiServer.Reference.Commerce.Site.Infrastructure
{
[ServiceConfiguration(typeof(IModelTransform))]
public class BlahBlahBlah : CatalogContentModelTransform
{
public BlahBlahBlah(ExpressionHelper expressionHelper, IPriceService priceService, IMarketService marketService, IInventoryService inventoryService, LocalizationService localizationService, ICatalogSystem catalogContext, IRelationRepository relationRepository, ThumbnailUrlResolver thumbnailUrlResolver, CustomerContext customerContext) : base(expressionHelper, priceService, marketService, inventoryService, localizationService, catalogContext, relationRepository, thumbnailUrlResolver, customerContext)
{
}
public override TransformOrder Order
{
///Yes, this is very important to make it work
get { return base.Order + 1; }
}
protected override void TransformInstance(IModelTransformContext context)
{
var catalogContent = context.Source as CatalogContentBase;
var properties = context.Target.Properties;
if (catalogContent is NodeContent nodeContent)
{
properties["DisplayName"] = nodeContent.Name;
}
if (catalogContent is EntryContentBase entryContent)
{
properties["DisplayName"] = entryContent.Name;
}
}
}
}
And here is how it looks
A few notes:
CatalogContentModelTransform
, and other APIs in Commerce.Shell, are not considered public APIs, so they might change without notice. There is a risk for adding this, however, it’s quite low.- This (or the bug fix) does not affect breadcrumb, it has been, and still is, showing
Name
.