Sitecore Experience Commerce

Commerce Shared renderings

Abstract

Each of the renderings in the Shared group can be used on many different types of pages.

You can use the renderings in the Commerce Shared group in the SXA toolbox for building different types of pages.

The following image is an example of how the Commerce Shared renderings might appear on a storefront page:

SharedRenderings_examplePage.png

This topic describes the following renderings in the Commerce Shared group in the SXA toolbox:

You use the Language Selector to enable the customer to determine the language displayed on the storefront by selecting a language from a list of available languages.

When you add the Language Selector rendering to a page, it appears as a hyperlinked text that displays the current language. This rendering is similar to the Language Selector rendering in the Context group in the SXA toolbox. The difference is that you use the Language Selector rendering from the Commerce Shared group when you want to link the rendering to a language set in the Commerce Control Panel.

Result

On the live storefront, when you click the language selector link, the list of available languages expands. You can then select a language.

Shared_LanguageSelector.png

Configuration

You can define the languages displayed in the Language Selector rendering in the Language Set item (/sitecore/Commerce/Commerce Control Panel/Shared Settings/Language Sets):Commerce Engine and Storefront configuration settings

Each language set has a list of selected languages, and a default language:

Shared_ConfigureLanguageSets.png

You specify the language set that applies to your storefront in: sitecore/Commerce/Commerce Control Panel/Storefront Settings/Storefronts/<Your Storefront>/Language Configuration, in the Language Set field:

Shared_LanguageConfiguration.png

You use the Top Bar Links rendering to display a number of links to the customer. The links displayed depend on the customer's authentication status. For example, if the customer is not logged in, a Sign in link is displayed; if the customer is logged in, the Sign out link is displayed together with the customer's login name.

Anonymous customer

If the customer is not logged into their account, the Top Bar Links rendering displays the following links by default:

  • Sign in

  • Gift cards

Shared_TopBarLinks.png

Logged in customer

If the customer is logged in, the Top Bar Links rendering displays the following links by default:

  • Username

  • Sign out

  • Account

  • Gift cards

Configuration

In the associated content item, you can add or remove links from the list of links that are displayed in the rendering. Click the Edit link on the Links tab to open the Select Items dialog box:

Shared_SelectItems.png

The content items for the individual links can be found in: /sitecore/content/Sitecore/[SITE]/Data/Links/TopBar

Shared_TopBarLinks_Configuration.png

For each link, you can configure the following fields:

  • Link – leave the field blank if you want to display a static text.

  • Text – enter the text of the link.

  • Tooltip – enter a tooltip for the link.

  • Show when Authenticated –select to only display the link when the customer is logged in.

  • Show Always –select to always show the link.

  • Generate Secure Link – select to enforce https:// when this link is clicked.

You use the Message Summary rendering to display messages that have been triggered by other renderings and pushed to the Message Summary. The rendering groups messages by type and displays them in the following order:

  • Errors

  • Warnings

  • Informational messages

The storefront style sheet (CSS) determines the appearance (style) of the different types of messages.

When you drop the Message Summary rendering on a page, it contains placeholder data:

Shared_MessageSummary.png

Result

On the live storefront, the rendering is invisible if it does not contain any messages.

Configuration

The messages displayed in the Message Summary rendering are Commerce storefront system messages. You can configure the messages in the System Messages folder (/sitecore/Commerce/Commerce Control Panel/Storefront Settings/Commerce Terms/System Messages).