Development of ASP.NET MVC 5 web applications with Kentico 11
Clone or download
JanLenoch Merge pull request #33 from Kentico/dc-399-issue-templates
Add/update issue, PR templates, code of conduct, contributing guide
Latest commit 9791276 Sep 6, 2018

Readme.md

Kentico MVC

Build status Q&As

Kentico 11 brings support for the development of ASP.NET MVC 5 applications. This repository contains source code for Kentico integration packages and a sample Dancing Goat web application that demonstrates all supported features related to the MVC development with Kentico. To find out more about the design of the sample web application, see the How the Dancing Goat web application works page in the Wiki. The page contains explanations of the decisions made when creating the application and can help you when building your own projects.

Repository structure

The repository consists of projects representing integration packages specified in the Kentico documentation.

There are also the DancingGoat and LearningKit projects. Both are sample ASP.NET MVC 5 applications built using Kentico. The Dancing Goat site represents a real-life website suitable for exploring the full MVC experience.

The Learning Kit is a functional website for learning purposes. It demonstrates how to implement various Kentico features on MVC websites in the form of code snippets, which you can run if you connect the website to a Kentico database. Also, the project source code is used in documentation examples.

Accessing older versions of the repository

You can find the MVC repository for older versions of Kentico under the Releases section (open the corresponding commit for the required version and click Browse files).

Quick links:

Running sample sites

Requirements

  • IIS 7.5+
  • Microsoft .NET Framework 4.6/4.7
  • Visual Studio 2015 Update 1+

Instructions – Dancing Goat

  1. Install Kentico.
  2. Import the Dancing Goat site from the webtemplates/DancingGoatMvc.zip import package.
  3. Enable web farms in automatic mode.
  4. Rename the src\DancingGoat\ConnectionStrings.config.template file to ConnectionStrings.config.
  5. Rename the src\DancingGoat\AppSettings.config.template file to AppSettings.config.
  6. Copy the CMSConnectionString connection string from the Kentico web.config file to the src\DancingGoat\ConnectionStrings.config file.
  7. Copy the CMSHashStringSalt app setting from the Kentico web.config file to the src\DancingGoat\AppSettings.config file.
  8. Open the KenticoMvc solution in Visual Studio and run the src\Dancing Goat web application.
  9. (Optional) Open the Smart search application and rebuild the Dancing Goat MVC search index.

Note: The initial build can take a little longer as it needs to restore NuGet packages.

Instructions – Learning Kit

  1. Install Kentico.
  2. Create a new site in the Sites application based on the MVC Blank Site web template.
  3. Enable web farms in automatic mode.
  4. Rename the samples\LearningKit\ConnectionStrings.config.template file to ConnectionStrings.config.
  5. Rename the samples\LearningKit\AppSettings.config.template file to AppSettings.config.
  6. Copy the CMSConnectionString connection string from the Kentico web.config file to the samples\LearningKit\ConnectionStrings.config file.
  7. Copy the CMSHashStringSalt app setting from the Kentico web.config file to the samples\LearningKit\AppSettings.config file.
  8. Open the KenticoMvc solution in Visual Studio and run the samples\LearningKit web application.

Feedback & Contributing

Check out the contributing page to see the best places to file issues, start discussions and begin contributing.

Analytics