/Kentico.Xperience.AspNetCore.XeroCode.Widgets

Widgets made in the UI for Kentico Xperience 13.

Primary LanguageC#MIT LicenseMIT

Xero Code Widgets

Database-only widgets for Kentico Xperience 13.

Stack Overflow
NuGet NuGet package for the admin
NuGet NuGet package for your MVC project
NuGet NuGet package for localization

Xero Code Widgets is an extension for Kentico Xperience 13 that allows marketers to create page builder widgets without code or needing to restart the presentation application.

This repository contains the source code for the admin NuGet, the presentation NuGet, and a supporting NuGet for localization.

Description

Xero Code Widgets is an extension for Kentico Xperience 13 that allows marketers to create page builder widgets without code or needing to restart the presentation application. The extension adds an admin application named Xero code widgets where marketers can create, modify, and delete widgets defined in the database. The extension configures the MVC application to make these widgets available in the page builder.

Marketers can set the name, description, icon, properties, and view of widgets. Properties can use a subset of the available form components and can have a default value, a label, a tooltip, and an explanation. The view is any Razor syntax where the property values are available in @Model.Properties.* by property name.

Requirements and prerequisites

  • Kentico Xperience 13 installed.
    • Only the ASP.NET Core development model is supported.

Installation

  1. Use Visual Studio to open the solution with the admin project.
  2. In the NuGet Package Manager Console, run Install-Package KenticoXperience.AspNetCore.XeroCode.Widgets.Admin.
  3. Build and make a request to the admin where it is running.
  4. Use Visual Studio to open the solution with your MVC project.
  5. In the NuGet Package Manager Console, run Install-Package KenticoXperience.AspNetCore.XeroCode.Widgets.
  6. In Startup.cs locate the ConfigureServices method.
  7. In that method, there should already be a call to AddControllersWithViews(). In the chain after this call, add a call to AddXeroCodeWidgets() (the extension method is in theKentico.Xperience.AspNetCore.XeroCode.Widgets.Extensions namespace).
  8. There should also already be a call to services.AddKentico with an arrow function with a body. If there is no arrow function with a body, define one. In the body, add a call to services.UseXeroCodeWidgets().
  9. Build and run in IIS Express, or publish the project where it is hosted.
  10. In the admin, open Xero code widgets. You may need to set up permissions to see the application if you are not an administrator.
  11. Use the UI to create widgets.
  12. Open Pages.
  13. Navigate to a page with the page builder feature and add any of the created widgets.