Page builder development

Kentico 12 Service Pack note

You may encounter problems related to the page builder functionality in the initial release of the Kentico 12 Service Pack (hotfix 12.0.29). We recommend installing the latest hotfix version to avoid these issues.

As a developer, you can enable content editors to create content on MVC sites using the page builder. The page builder provides a user-friendly interface where non-technical users can manage content using configurable widgets prepared by the developers. Users can also work with page templates to quickly create new pages based on predefined layouts.

The page builder should be used when you want to allow editors to create visually captivating pages and experiment with the design and layout. To learn more about scenarios for which page builder is suitable, see Choosing the format of page content.

Page builder

To start using the page builder:

Prerequisite

In order to use the page builder, you need to enable preview mode support for your site.

  1. Register the page builder
  2. Create pages with editable areas
  3. Implement and register widgets
  4. Implement and register sections (layouts for widgets)

Page builder components

The page builder framework consists of several components, which fit together in the following hierarchy. Additionally, widget zones can contain any number of widgets.

Page builder components

Editable areas

Editable areas are the top-level layout component and contain one or more sections. You can learn how to add editable areas to a view on the Creating pages with editable areas in MVC page.

Sections

Page sections specify the visual layout of widget zones. They represent reusable pieces of markup that can store an arbitrary number of widget zones – areas where content creators place widgets. Sections are fully customizable, and as a developer, you have absolute freedom in the way you set each section’s layout. See Developing page builder sections to learn how to implement and customize page sections.

Widget zones

Widget zones are components that allow content editors to insert widgets using the plus button. Widget zones are defined in the views of sections.

Widgets

Widgets are reusable components that can be easily manipulated by content editors and other non-technical users. Widgets give non-technical users more power and flexibility when adjusting page content, in addition to basic editing of text and images. By working with widgets, users can decide which components are placed on pages and where. You can learn more about widget development and customization on the Developing widgets in MVC page.

Aside from editable regions, the page builder allows you to use page templates.

Page templates

Page templates allow content editors to gain greater control over the layout of pages, without the need to ask a developer to modify the code in the MVC project. With templates, it is easy to switch between page layouts, so they are suitable for creating pages with a predesigned or repeating structure, such as landing pages. You can learn more about page template development and customization on the Developing page templates in MVC page.

Registering the page builder

To use the page builder, you need to enable it as a feature in your MVC project.

  1. Open your MVC project in Visual Studio.

  2. Enable the page builder feature by calling the UsePageBuilder method of the ApplicationBuilder instance.

    • Enable the feature at the start of your application’s life cycle, for example in the Application_Start method of your project’s Global.asax file.

      MVC projects created by the installer contain the ApplicationConfig class, whose RegisterFeatures method is called in the Application_Start method by default. You can use this class to encapsulate all of your ApplicationBuilder code (enabling and configuring of Kentico MVC features).

      Note: The feature must be enabled before you register routes into the application’s RouteTable. The Kentico().MapRoutes() method adds required routes based on the set of enabled features.

      
      
      
        using Kentico.Web.Mvc;
        using Kentico.Content.Web.Mvc;
        using Kentico.PageBuilder.Web.Mvc;
      
        ...
      
        protected void Application_Start()
        {
            ...
      
            // Gets the ApplicationBuilder instance
            // Allows you to enable and configure Kentico MVC features
            ApplicationBuilder builder = ApplicationBuilder.Current;
      
            // Enables the preview feature
            builder.UsePreview();
      
            // Enables the page builder feature
            builder.UsePageBuilder();
      
            ...
        }
      
      
        
  3. (Optional) Edit the project’s Views\web.config file and add the Kentico.PageBuilder.Web.Mvc namespace.

    • The namespace allows you to easily access page builder extension methods in the code of your views.

    • Alternatively, you can add using statements for the namespace directly in the code of individual views.

      
      
      
        <system.web.webPages.razor>
          ...
          <pages pageBaseType="System.Web.Mvc.WebViewPage">
            <namespaces>
              ...
              <add namespace="Kentico.Web.Mvc"/>
              <add namespace="Kentico.PageBuilder.Web.Mvc"/>
          </namespaces>
          </pages>
        </system.web.webPages.razor>
      
      
        

The basic page builder feature is now enabled. You can prepare pages with editable areas in your MVC project and start developing widgets and sections.