/KenticoBoilerplate_v12

Kentico Boilerplate MVC Site which is geared to provide a clean starting point with various Kentico features enabled and examples provided without added fluff.

Primary LanguageJavaScript

DEPRECIATED

This Boilerplate is not considered depreciated. You can still use it if you want an empty Kentico MVC 12 site, but there is very little in terms of proper structure, systems, etc.

Instead i would recommend our Kentico 12 Baseline Project that Heartland Business Systems has graciously made open source. If you need a Kentico Partner, please contact Heartland!

KenticoBoilerplate_v12 (Hotfixed to Kentico 12.0.29 Service Pack)

Kentico Boilerplate MVC Site which is geared to provide a clean starting point with various Kentico features and core structures put in place.

This Boilerplate has been stripped of examples. If you wish to see various examples and samples, please see the branch BoilerplateVariants/Examples

Setup Instructions

  1. Install Kentico using normal instructions
    1. You can either create a blank MVC Site, or...
  2. Replace the MVC site with the boilerplate site.
  3. Go to the CMS folder, and unzip ConfigFiles_UnzipMe.zip, place the 3 files in the CMS folder
  4. Edit the config files as desired, MINIMUM the ConnectionStrings.config needs to be configured to point to your database you restored
  5. Edit the CMSHashStringSalt in the AppSettings.config needs a unique GUID added, do this in both the CMS and Boilerplate folder's AppSettings.config

Notes on Features

The boilerplate site had some of the origin of many features, however these features are now available via NuGet packages (such as Dynamic Routing, MVC Caching, the Authorization attribute, etc). While i plan on updating the boilerplate once our own Baseline install is set, please be aware that you may want to remove some code files and replace with the nuget packages.

If creating your own repository from the Boilerplate

  1. Replace the .gitignore with the unzipped EntierCMS-GitIgnore.zip as this will track all your CMS folders and files if you wish to track your entire repo
    1. _*NOTE: You should not upload the CMS/Lib folder into any public repository, but you can use it for private repos such as Azure DevOps
  2. Unzip the ConfigFilesForCMS_UnzipMe.zip into your CMS Folder and configure your settings
  3. Ensure that your CMSHashStringSalt in the App Settings matches for the MVC site and the 'Mother' (CMS)
  4. If you wish, you can leverage the given CI-Restore-UnzipAndModifyMe.zip to use Continuous Integration
    1. Unzip CI-Restore-UnzipAndModifyMe.zip's CI-Restore.bat file in the root of the solution (next to CI-Restore.ps1)
    2. Edit the CI-Restore.bat and modify the Path and AppPoolName to match that of your local instance (the App Pool Name should be the one for your Kentico Instance)
    3. Create a backup of your database as the root (other developers will need to start from this point)
    4. You can now run the CI-Restore.ps1 in the root of this solution to incorporate any CI changes in your repo.

*NOTE: Sometimes, depending on your system configuration, powershell scripts can be blocked if they originated from the internet, in which case you can simply copy the content of the powershell, delete the file, then create a new CI-Restore.ps1 and paste in the content, this way it originated from yourself.

Contribution Rules

If you wish to contribute to the boilerplate, please follow the following rules

  1. Please do not install other NuGet packages without asking me first.
  2. Please do not install Kentico Hotfixes, I wish to keep this boilerplate as close to the base (K12 SP1) as possible. You should of course hotfix your own sites you may build, even ones starting from the boilerplate, but only hotfix if you have no plans on contributing to the project.
  3. Comment well!

More information

For more information, please see me at www.devtrev.com

Sincerely, Trevor Fayas - Kentico MVP