• Documentation
  InstallationUsing the Kentico interfaceDeveloping websitesConfiguring KenticoManaging usersSecuring websitesDeploying websitesManaging website contentMultilingual websitesMacro expressionsExternal utilitiesIntegrating 3rd party systemsCustom developmentE-commerce featuresOn-line marketing featuresIntranet featuresCommunity featuresRunning Kentico on Microsoft AzureUsing Amazon web services with KenticoCertified extensionsReferencesRelease notes - Kentico 9
• Tutorial
  Getting started with KenticoUsing the Kentico interfaceSite development overviewCreating a new websiteAdding styles to the websiteWorking with the Pages applicationCreating the master pageCreating website pagesCreating page templatesNext steps
• API Examples
  Content managementOn-line marketingE-commerceSocial and CommunityDevelopmentConfiguration

Next, you need to set up a content sychronization mechanism:

1. Go to the Settings application.
2. Navigate to Versioning & Synchronization -> Web farm.
3. Set the Web farm mode to Automatic.
4. Click the Save button.

At this point the content only site and your Kentico instance are set up to be used with an MVC application.

Setting up the MVC application

Your new MVC application needs to be configured to work with Kentico:

1. Create an empty ASP.NET MVC project in Visual Studio.

   • Select the Empty template.
   • Enable the MVC checkbox to add folders and core references for MVC.
     

2. Right-click the solution and select Manage NuGet Packages for Solution.

3. Install the Kentico.Web.Mvc integration package into your MVC application project.

4. Edit the MVC project's main web.config file:

   • Add a connection string to your Kentico database. We recommend copying the exact connection string from the web.config file of the related Kentico application project.

     XML

     Copy

     <connectionStrings> 
         <add name="CMSConnectionString" connectionString="Persist Security Info=False;database=Kentico;server=myserver;user id=username;password=mypassword;Current Language=English;Connection Timeout=120;" />
     </connectionStrings>

   • Copy the value of the CMSHashStringSalt appSettings key from the web.config of the Kentico project and add the value into the same key in the MVC project's web.config (it is empty by default). This ensures that the MVC application generates hashes using the same salt value as the Kentico application (for example for macro signatures or page preview links).

     XML

     Copy

     <appSettings>
         <add key="CMSHashStringSalt" value="e68b9ad6-a461-4707-8e3e-ece73f03dd02" />
         ...
     </appSettings>

5. In the MVC application's Global.asax file, add a using statement for the Kentico.Web.Mvc namespace and add the following line in the Application_Start method:

   C#

   Copy

   using Kentico.Web.Mvc;
   ...
   
   protected void Application_Start()
   {
       ...
   
       // Enables and configures the selected Kentico ASP.NET MVC integration features
       ApplicationConfig.RegisterFeatures(ApplicationBuilder.Current);
   }

6. In the App_Start\RouteConfig.cs file, add a using statement for the Kentico.Web.Mvc namespace, and call the MapRoutes method (must be called before you map any of your own routes).

   C#

   Copy

   using Kentico.Web.Mvc;
   
   public static void RegisterRoutes(RouteCollection routes)
   {
       routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
   
       // Maps routes to Kentico HTTP handlers first as some Kentico URLs be matched by the default ASP.NET MVC route, resulting in displaying pages without images.
       routes.Kentico().MapRoutes();
   
       ...
   }

7. In the Views\web.config file, add the Kentico.Web.Mvc namespace.

   XML

   Copy

   <namespaces>
       ...
       <add namespace="Kentico.Web.Mvc"/>
   </namespaces>

8. In the Properties\AssemblyInfo.cs file, add the AssemblyDiscoverable assembly attribute. The attribute allows you to work with classes generated for Kentico objects.

   C#

   Copy

   using CMS;
   ...
   [assembly: AssemblyDiscoverable]

9. Set a URL for the MVC application:

   • Right-click the MVC project and select Properties.
   • Open the Web tab.
   • In the Servers section, select Local IIS.
   • Set the Project Url identical to the Presentation URL assigned in your MVC site's settings in Kentico.
   • Click Create Virtual Directory.

After you run the MVC application, you can see it within the related Kentico administration interface in the Web farm application on the Servers tab, as a new server. The server's Status changes to Healthy after a few moments.

You can now continue to define the content structure of your site and develop the MVC application.