Xperience by Kentico

Name	Package
Kentico.Xperience.K13Ecommerce
Kentico.Xperience.Store.Rcl
Kentico.Xperience.StoreApi

Description

This integration is primary intended for existing Kentico Xperience 13 (KX 13) E-Commerce projects to enable them to migrate to new Xperience By Kentico (XbyK) and still use KX 13 E-Commerce functionality.
It can also be used as a basis for new projects where E-Commerce data will be stored on KX 13, but further development is necessary to achieve this goal.

This solution covers several scenarios according to the complexity of integration between XByK and KX 13:

Product listing widget

We recommend to use this widget for simple scenarios such as Landing page offers, etc.
Product listing widget example is located in Dancing Goat XbyK example project.
The widget is used to display products directly from KX 13, purchase itself still takes place on Kentico 13.
The widget has a couple of properties based on the Store property selector which enable to display products for given category, culture and currency.

Full scale e-commerce solution

We recommend to use for possible partial migration of existing e-commerce projects from KX 13 to XbyK.
Product data (with variants and images) is synchronized to Content hub (can be turned off).
Product listing, detail and checkout process are placed on XbyK (shopping cart is saved and calculated still on KX 13).
Orders are created from cart, order related data is saved on KX 13 side.
Products need to be linked from Content hub to pages in website channel applications. This can either be done manually or using automatic product page synchronization. You can use CI to restore examples of content types for pages that display products. See this section of User Guide for detailed information.
Sample XbyK Dancing Goat site implements store functionality and can be used as an example of migration of existing e-commerce projects to new XbyK.

The integration provides an API with services for implementing the following scenarios:

Listing products based on parameters, product categories, prices and inventory
Actions with shopping cart, changing currency and order creation
Listing of orders in the administration
Listing of orders on the live site for the current customer
Updates of existing orders
Retrieving and listing order statuses
Listing site cultures and currencies
Check this part of User Guide for more specific description

Project structure

There are currently 2 solutions:

Kentico.Xperience.K13Ecommerce.sln

Complete solution with all libraries and sample sites:

Kentico.Xperience.StoreApi - library for Kentico 13 that exposes a REST API for an E-Commerce site.
Kentico.Xperience.K13Ecommerce - library for XbyK connecting to the REST Store API running under Kentico 13.
Kentico.Xperience.Store.Rcl - Razor Class Library for selector components.
Sample Dancing Goat sites
- DancingGoat.csproj - XbyK Dancing Goat (live site channel + administration) enriched with integration to KX 13 Dancing Goat to show how to create simple e-shop with product listing, product detail and checkout process on XByK.
- Kentico13_DancingGoat.csproj - KX 13 Dancing Goat example (live site) with configured Store API to demonstrate how you can set up REST Store API on your own KX 13 e-commerce solution.
KX 13 administration project (CMSApp) is not part of this solution!

Kentico.Xperience.K13Ecommerce.Libs.sln

Contains only libraries without sample sites, used for publishing of NuGet packages

Library Version Matrix

Summary of libraries which are supported by the following versions Xperience by Kentico / Kentico Xperience 13

Kentico Xperience 13 E-Commerce integration

Library	Xperience Version	Library Version
Kentico.Xperience.K13Ecommerce	>= 29.3.3	>= 1.1.0
Kentico.Xperience.Store.Rcl	>= 29.3.3	>= 1.1.0
Kentico.Xperience.K13Ecommerce	>= 29.2.0	1.0.0
Kentico.Xperience.Store.Rcl	>= 29.2.0	1.0.0
Kentico.Xperience.StoreApi	>= 13.0.131	1.0.0

Dependencies

Xperience by Kentico application:

Kentico Xperience 13 application (or standalone API app):

Package Installation

Add these packages to your XbyK application using the .NET CLI

dotnet add package Kentico.Xperience.K13Ecommerce
dotnet add package Kentico.Xperience.Store.Rcl

Kentico Xperience 13

Add this package to your Kentico Xperience 13 ASP.NET.Core application (live site or create standalone application when your KX 13 live site is not running)

dotnet add package Kentico.Xperience.StoreApi

Quick Start

Kentico Xperience 13

First set up your Kentico 13 ASP.NET Core application:

Set up your own settings for Store REST API authentication (based on JWT and OAuth client credentials flow)

{
  "CMSStoreApi": {
    "Jwt": {
      "Key": "YourSecretKeyForAuthenticationOfApplicationMustBeAtLeast64CharsLong",
      "Issuer": "yourCompanyIssuer.com",
      "Audience": "XbyK-DancingGoat",
      "TokenExpiresIn": 60
    },
    "ClientId": "3ef7fe1b-696c-4afa-8b56-d3176b7bea95",
    "ClientSecret": "********************"
  }
}

Add Store API services to application services and configure Swagger

// Startup.cs

public void ConfigureServices(IServiceCollection services)
{
    // ...
    //Store API registration
    services.AddKenticoStoreApi();
    //Registers Swagger generation
    services.AddKenticoStoreApiSwagger();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment environment)
{
    //Registers Swagger endpoint middleware and swagger UI
    app.UseStoreApiSwagger();
}