Kentico EMS Component Starter

This a starter point to develop MVC Page Builder Components. It contains one sample widget, inline editor, form component, and section.

⚠️ Disclaimer

This repo is still in development. It is about to be released after the Kentico 12 Service pack is released.

Currently it is possible to start the development, but the repository structure might change. See the list of the issues that need to be solved before release.

⚠️ Repository moved to another location

All git clone, git fetch, or git pushoperations targeting the previous location will continue to function as if made on the new location. However, to reduce confusion, we strongly recommend updating any existing local clones to point to the new repository URL. You can do this by using git remote on the command line:

$ git remote set-url origin https://github.com/Kentico/ems-mvc-component-starter.git

Get started

1. Download Kentico installation

   • Kentico_12_0_trial.exe Trial

2. Install Kentico using the command line.

   • Use Kentico installation profile template and define TargetFolder attribute of th IIS tag (:warning: Do not use the same location as the one you have you exe file located)

     • This will install Kentico Administration interface without any site
     • If you wish to adjust the connection to the different database server, adjust the SQL tag in the configuration
     • If you wish to add your license to the instance, adjust the Licenses tag in the configuration XML

     .\Kentico_12_0_trial.exe KenticoInstallationProfile.xml

     If you get an error about already installed program files run command for uninstalling the current program files and then run the previous command again

     .\Kentico_12_0_trial.exe /u

3. Apply the latest hotfix (or at least 12.0.29)

4. Run the administration instance (already registered in IIS with _Admin suffix) and import the site export package according to the (documentation)

   • This package contains
     • Site (With Presentation URL)
     • Page type (configured for page builder - url pattern / and use tab checkbox)
     • Page by this page type
     • Automatic web farms

5. Clone this repository to the different folder than the Kentico administration is installed

   git clone https://github.com/Kentico/ems-mvc-component-boilerplate

6. Build the ComponentBoilerplate.sln.

7. Set the hash string salt (CMSHashStringSalt) in the web.config file from Kentico administration application web.config application settings.

8. Set the the connection string (CMSConnectionString) in the web.config file from Kentico administration application web.config connection strings.

9. Build the ComponentBoilerplate.sln.

10. Run command to reinstall packages (see the issue) in Package Manager Console for the Visual Studio and confirm rewriting all the content

    Update-Package -reinstall

11. Register the site in IIS (It is also possible to use IIS express)

    • use <TargetFolder>/ComponentBoilerplate as a Physical path
    • you could use the same Application pool as is set f administration application

12. Adjust presentation URL in the administration instance according to the registration from the previous step

13. Open the administration interface, go to Pages, select the DevelopmentPage and you could see the page builder set up.