Commerce Layer is a commerce platform designed to integrate online shopping into various platforms such as websites, mobile apps, chatbots, wearables, effortlessly through a rapid and secure API.

This app enables content editors to select products and categories from a connected CommerceLayer instance and reference them in Storyblok.

Setup

1. Once installed, navigate to the block library and create a new field of the type plugin (in either a new or an existing block). Set the custom type to sb-commerce-layer.
2. In the field configuration, define the following values:
   • apiUrl (required): The URL of the API endpoint associated with your CommerceLayer instance (e.g., https://example.commercelayer.io).
   • integrationClientId (required): The client_id from your integration API credentials
   • integrationClientSecret (required): The client_secret from your integration API credentials. The value of this option must be encrypted using the Storyblok Encryption Service.
   • salesChannelClientId (optional): The client_id from your sales channel API credentials.
   • salesChannelDefaultMarketNumber (optional): The number of a specific sales channel market (e.g., 10460). Note that this option must be provided together with salesChannelClientId but can also be omitted.
   • limit (optional): The maximum number of items that can be selected.
   • selectOnly (optional): If left empty, editors can choose products and categories. If set to product, only products can be selected. If set to category, only categories can be selected.
3. Use the block containing the field in the Visual Editor, select one or multiple products or categories, save the story, and check the API response.

Please refer to the e-commerce concept for a detailed introduction to the topic.