kentico / mvc Goto Github PK

View Code? Open in Web Editor NEW

87.0 66.0 77.0 9.72 MB

Development of ASP.NET MVC 5 web applications with Kentico 11

Home Page: https://docs.kentico.com/k11/developing-websites/developing-sites-using-asp-net-mvc

License: MIT License

C# 76.39% CSS 7.67% JavaScript 0.71% Pascal 0.04% HTML 5.68% PowerShell 0.12% Less 9.38% ASP.NET 0.01%

mvc kentico aspnet-mvc aspnet-mvc-5

mvc's Introduction

Kentico MVC

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

Install Kentico.
Import the Dancing Goat site from the webtemplates/DancingGoatMvc.zip import package.
Enable web farms in automatic mode.
Rename the src\DancingGoat\ConnectionStrings.config.template file to ConnectionStrings.config.
Rename the src\DancingGoat\AppSettings.config.template file to AppSettings.config.
Copy the CMSConnectionString connection string from the Kentico web.config file to the src\DancingGoat\ConnectionStrings.config file.
Copy the CMSHashStringSalt app setting from the Kentico web.config file to the src\DancingGoat\AppSettings.config file.
Open the KenticoMvc solution in Visual Studio and run the src\Dancing Goat web application.
(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

Install Kentico.
Create a new site in the Sites application based on the MVC Blank Site web template.
Enable web farms in automatic mode.
Rename the samples\LearningKit\ConnectionStrings.config.template file to ConnectionStrings.config.
Rename the samples\LearningKit\AppSettings.config.template file to AppSettings.config.
Copy the CMSConnectionString connection string from the Kentico web.config file to the samples\LearningKit\ConnectionStrings.config file.
Copy the CMSHashStringSalt app setting from the Kentico web.config file to the samples\LearningKit\AppSettings.config file.
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.

mvc's People

Contributors

Stargazers

Watchers

Forkers

varinders ivanaliptakova bryansoltis kasiviswanathan3876 techbuzzz boniyustin seangwright thomasluijken toddhewitt wanyonggangdage shitova80 andyliao8 nimrawilayat intranoggin rpribyl ofcadavidm sedojj pha4 asalhani matrixdekoder 9245162 ruanbl vasu-rbt kingvswlm mudit1102 truelimenl haithemaraissia drilic prashantcatena masterlopau shirishgund mitchdistinction kenxly prakashnitj nishadks1 lrcchuan2016 karandepratham ademzeina niteshreddykukkam sangnguyenkd dipubadwal hichemgrira itsgowtham moniaelwakeel statesman4 ndumisozuma paramount-jay davidbkentico hongweichang glondon eurekainc tuananhcwrs aliyasar davidjg87 jorg10 kamleshkumar02 gareth-jones-za qwb2013 jimmywang54 manelbr2 leelu611 manishmkr wayne9999 jayeshbhamre jkerbaugh jihane22 rongguoxu jenkinsgituser bindunrao snowy2651 leopard81 meghakurwade sriram3399 mikescore ghanshyam63 muraliv21 fairosebanu

mvc's Issues

Models aren't easy to extend with custom columns

For example, if a new column is added to the CustomerInfo class (i.e. CustomerTitle) then there is no way of using the Kentico.Ecommerce package to access those new columns and expose them through the Customer model.

It could be useful to amend the models to set the "OriginalCustomer" value to be a protected property which can be access by classes inheriting from Customer. This would allow us to create a custom Customer model which includes our extra columns.

This pattern could be applied to the other models in the various packages.

siteName Error

Original issue: Kentico/Home#2 submitted by https://github.com/mdaniels-chl

Went through the steps for both Learning Kit and Dancing Goat and both get an error.

Kentico 12

Kentico 12 sample code for dancing got can i get because earlier version not working in kentico 12

Convert from project.json to VS2017 SDK style projects

Motivation

project.json is deprecated and SDK style projects are supported in .NET Standard, .NET Core and .NET Framework projects.

SDK style projects also provide

The best Nuget package dependency resolution (the transitive dependency tree can be seen in VS references UI)
Easier access to *.csproj files in VS (no need to unload, fewer merge conflicts through file globbing)
PackageReference Nuget package manifest syntax (the recommended approach going forward)
Global package store for users (faster package restore for common packages)

This could make it easier for developers external to Kentico to contribute to this repository.

Proposed solution

Convert all the .csproj files in this repo to SDK project syntax

Additional context

There are tools to help with this conversion
https://github.com/hvanbakel/CsprojToVs2017
And Nate McMaster blogged about the process
https://natemcmaster.com/blog/2017/03/09/vs2015-to-vs2017-upgrade/

Client caching for static content is broken when Preview is enabled

As soon as I enable the Preview module in an MVC site, client cache settings are completely ignored.

To reproduce:

Setup an MVC-only Kentico site using the Kentico Nuget packages
Setup application initialization as done in sample apps like Dancing Goat (App_Start\Application.cs)
Add an entry to the routing table to ignore static content
Now request a page and observe the headers on static content like /Content/Styles/Site.css

Cache-Control: private

setup client caching in web.config:

<staticContent>
       <clientCache cacheControlCustom="public" cacheControlMaxAge="1.00:00:00" cacheControlMode="UseMaxAge"/>
</staticContent>

The response headers should now include this:

Cache-Control: public,max-age=86400

But it doesn't.

Now disable the Preview module in App_Start\Application.cs

After that, caching works as expected for static content.

I've traced this back to line 59 in PreviewFeatureModule.cs.

context.Response.Cache.AddValidationCallback(ValidateCacheItem, null);

Commenting that line solves the issue. I'm not sure why that line is even there.
For static content, the event handler being registered is never hit.