In this post for Umbraco CMS we will learn regarding creating Visual Studio Solution. Main motive behind creating VS Solution is to work in proper structured manner and when work in team it is helpful so that Team can Commit their file changes under Source Control when developing with Umbraco CMS.
Step 1 – Create Blank Solution for UMBRACO CMS
Start Visual Studio and use the shortcut for create new project i.e. Ctrl+Shift+N
Create a Blank Visual Studio Solution.
Note: If you are using Visual Studio 2012 or else the step to create Blank Solution may be different. For example in Visual Studio 2012 you can navigate to ‘Visual C#’ > ‘Web’ > Select ‘ASP.NET MVC 5 Empty Project’.
Considering you have followed the Part 2 regarding Umbraco Installation and Site root folder; keep the backup of the Umbraco site root folder specifically web.config, Global.asax and ‘Views’ folder.
Then uncheck the option for “Create directory for solution”
Set the Location to the Umbraco site root folder.
Set the Solution name. Here we have created Solution with name “UmbracoMvc” and then click “OK”
Next in the “New ASP.NET Project” dialog, Select template “Empty” and tick the “MVC” check box option
Then click “OK”.
Step 2 – Verify the Solution Structure and Physical Files
After this you can verify the folder structure is created as below screen. Here “Umbraco” is the Solution Folder and “UmbracoMvc” is the Project Folder.
After we create blank solution, Visual Studio replaces the existing Umbraco web.config and other imp. files due to this behaviour of VS; we need to restore the files and folders (shown in below screen) from the original version that we have in backup, that we took in previous step, to “UmbracoMvc” project folder.
Now we have successfully created blank solution and recovered the files needed. So we need to verify that the Umbraco site is still working at URL ‘http://UmbracoMvc/’.
STEP 3 – Include NECESSARY files in the Solution
Open Visual Studio’s Solution Explorer and select option “Show All Files” highlighted in screen below.
Next include the files and folder as required but do not include the folders named “Umbraco” and “Umbraco_Client” because those part we will not work. I have shown in below screen what I have included in my solution.
STEp 4 – Umbraco MVC Configurations
In Umbraco MVC, we generally not define routes. For this reason we will clean up the routes definition from “RouteConfig.cs” as shown in screen below.
Next we will configure the Umbraco site for default rendering to MVC as shown in the screen below.
Open the “umbracoSettings.config” from “Config” folder and change the template’s default Rendering to “Mvc”.
Note: This will affect the creation of new Templates from Umbraco Client/Administration region. Also in new version of Umbraco default rendering is ‘Mvc’, so you can skip this part for Umbraco version 7.1.1
So we have completed the exercise to Create Visual Studio Solution for Umbraco Web development and we also did configurations for ASP.NET MVC 5 version. After this much you can add the source files and folders to any Source Control that works for you. Your Team will love to work in Umbraco CMS after these efforts.
In the next post we will see the how Umbraco CMS works with MVC or in other words how to cook the ASP.NET MVC recipe in Umbraco and also migration points for converting existing ASP.NET MVC sites to Umbraco MVC.
Keep sharing your ideas and suggestions in the comments.
Liked this post? Then spread this post to your friends.