Sitecore(SC) has a decent article on how to set up a Sitecore project on Visual Studio. This is a pretty good start but it does not quite meet our company’s requirements.

In this blog post I will attempt to tell you exactly how a structure a project assuming that you have the following requirements for your SC environment:

• You need to have multiple websites running on one instance of SC and you want each website to have its own Visual Studio project.
• You are not using a virtual folder per website.
• You want to manage multiple Class Library/Child projects within each website project.
• You want to keep the Renderings, Sub-layouts, Layouts, Associated files (css, js etc) and DLL’s of each website independent.

Our company has worked with multiple projects in Sitecore v5.3 and we have also Started a new project using Sitecore v6 (Visual Studio 2005 and 2008). I can safely say that we have come up with a tried and proven project structure that I can recommend that everyone can and should use. Please follow the SC developer cookbook if you are only going to ever have one website running on your instance of SC.

There is a fair bit to write on this entry and I will be slowly updating it, if anyone is in desperate need to this information right now then please leave a comment and I will try to speed things up!

HTML File Structure

It is always good to have a well structured website. Our team deals with the integration of HTML front end with SC. For this reason we usually get out HTML, CSS and JS delivered to us from a 3′rd party vendor. We get them to deliver the HTML to us in the following structure so that it fits snugly in with our intended .NET project structure:

Our website will be called “destinations“. Our main HTML files are on the highest level and we have folder named ‘destinations’ which contains all the css, images, JS etc. (the HTML will reference these files like this <img src=”/destinations/img/image1.jpg”/> )

Obviously the HTML is just your reference, we will be splitting up all the HTML into Layouts, Sublayouts and Renderings. Only the ‘destinations’ folder and its contents will actually be part of our Visual Studio project.

Had a Discussion with Elliot who posted comment on this topic. I have pasted the discussion we have had below (read from bottom up):

HI Eliot,

Sounds like a good approach, we did think of doing it the way you did but we decided not to go ahead with is simply because the Cookbook suggests that all websites are created and run via the website folder.

Even when you do my method, you should only be having the newly created web app in your VS project. You should not need to import any sitecore objects (it should effectively have been the same as your independent virtual directory arrangement). I.e. as mentioned, each website does have its own web.app even tho they have all been moved into the sitecore/websites folder.

I am assuming sitecore’s web.config will be the failover web.config is your local web.app does not contain any web.config entries that have been tweaked for that site?

Are your URL’s looking consistent when viewing a web page in preview mode now that you have created the Virtual Folders?
I can’t really think of any potential issues with your configuration at the moment and if you do manage to avoid any problems this may well be the best soloution structure yet.

Keep me informed.
Thanks,
Richard

On Fri, Jan 16, 2009 at 5:12 AM, Elliot Ritchie wrote:
Hi Richard

After experimenting with a ton of different configurations I think I’ve found the ideal way to integrate Sitecore with the current processes and project structures I’m working with right now; you’re directions definately provided a leap in the right direction!

Essentially,

• Each website sits within its own web application that contains all the necessary css, images, renderings and layouts etc for the specific website.
• The web applications then reference the Sitecore assemblies from a single predetermined Sitecore installation directory (this also allows for a much more efficient use of source control systems as it means each version controlled website doesn’t have to also include 300mb+ worth of Sitecore modules).
• The web applications’ Web.config contain the necessary Sitecore configuation sections, tweaked for the specific website.
• In IIS each web application is setup as its own website, with a virtual directory setup in each to provide the reference to the ‘/sitecore/’ directory, again this virtual directory points to the same predetermined Sitecore installation directory as before.

If you can see any holes in this setup please let me know, or any thoughts in general, but so far everything is running great!

Many Thanks

Hi Elliot,

I can’t really update my Blog at the moment because I am on holiday ( I will be working purely off memory). I have been pretty lazy with that I must admit.
Will try to outline the steps here (I will assume your project is called destinations following from my HTML structure blog post:

1. You will need to follow the Sitecore developer cook book and create a project as described there (name the project DestinationsApp for consistency) within the sitecore/websites folder.
2. Given that you will be working with multiple projects (websites) then you will need to have more than one ‘properties’ folder (one is needed for each project solution) so you will need to rename the Properties folder to something like DestinationsProperties.Once you have done this you will need to edit the DestinationsApp project (.csj I think) file with a text editor and replace all instances of the ‘properties’ folder name to match your new ‘DestinationsProperties’ folder name. Close this file and you are ready to open the project – go ahead and add a reference to Sitecore.Kernal.dll and dont forget to set copyLocal to false.
3. Now that you have a basic Web App project there you can start adding the extra sections to this project. Create a folder within sitecore/website named ‘destinations’. Include this newly created folder in your DestinationsApp project because this will contain all the misc web files. Copy all the files from your HTML/destinations folder into the sitecore/website/destinations folder.
4. Within the sitecore/websites/layouts folder create a folder called ‘destinations’. Include this folder in the DestinationsApp project. All your layouts and sublayouts for the destinations website should be created here within the sitecore/websites/layouts/destinations folder. You can reference your css files and image files (that will be in the folder created at step 3) from all layouts and renderings by refering to the src/link like this: <img src=\destinations\img\image1.jpg />
5. Within the sitecore/websites/xsl folder create a folder called ‘destinations’. Include this folder in the DestinationsApp project. All your renderings for the destinations website should be created here within the sitecore/websites/xsl/destinations folder.
6. Now you should be ready to go with the creation of a basic website. I suggest that in your Content tree you start off your content within sitecore/content/destinations/home where Home will be your home page. When you have a second website to go in your sitecore instance then that can be located within sitecore/content/secondwebsite/home in the content tree. You will ofcourse need to change the web.config <sites> section to add each website.
7. We often have accompanying DLL class libraries (e.d. a DestinationsLogic class library project) and also a Database project when integrating 3′rd party DB’s with your sitecore website. I highly reccomend that you create and store these projects outside of your ’sitecore/website’ folder because the goal is to keep the sitecore/website folder a clutter-free as possible. Create a filder within the C drive called c:/DestinationsProjects and then create two seperate folders in here for DestinationsLogic and DestinationsDB. Add your extra projects in here and by all means create these projects by ‘adding new project’ to your DestinationsApp project solution. This way all your projects will be logically in the same Visual Studio solution but Physically seperate. Add a Reference to each of these projects in your DestinationsApp project (and leave copyLocal as true) so that each time you compile your solution a DestinationsLogic.dll will be created in the sitecore/website/bin folder.
8. When you have this structure set up, you can easily add more websites to your sitecore instance by following steps 1 to 8 for each new websites and just replacing the word ‘Destinations’ with the name of your new website and they will all co-exsist without problems and you will end up with a highly maintainable, clutter-free project/site structure.

Hope this helps,
Richard

We have sitecore 6 environments working on Virtual Machines (VM’s). Sitecore 6 seems to cause an ASP error at seemingly random intervals leading to a total loss of service 9only on VM’s. Event Viewer will show you the following error:

Event Type: Error
Event Source: Application Error
Event Category: (100)
Event ID: 1000
Date:  8/8/2008
Time:  4:09:35 PM
User:  N/A
Computer: SCTEST
Description:
Faulting application w3wp.exe, version 6.0.3790.3959, faulting module unknown, version 0.0.0.0, fault address 0×709a2075.

Sitecore have provided a work-around for this. Set the following web.config entry to ‘false’ as show below:

<!–  ENABLE COUNTERS
Indicates if performance counters are enabled.
Default value: true
–>
<setting name=”Counters.Enabled” value=”false” />

We have made this change and it seems to get rid of the issue. Seems like Sitecores backend performance monitoring may be using some .NET 3.5 functionality that causes this error (this is just a guess).

See the SC forum for more details:

http://sdn5.sitecore.net/forum/ShowPost.aspx?PostID=11838#11838

The Requirement

Our clients have ’subject’ and ’function’ Metadata fields within their web page. They wanted to be able to content manage this subject and function list . They then wanted to be able to assign a subset of these function and subject keywords into each web page item (so all the subjects and functions are common to the whole site).

The Problem

The cleanest solution to this problem was to define a bunch of simple text items for each of the subjects and functions within specfic folder items. We would then create two multi lists in the Metadata base template (one for subject and one for function) and point them at these respective source directories.

Now think of the situation:  We have 5 subjects and 3 functions on average per web page. In the background, we are going to have to pull out data from 8 related content items every time we load a given page. We did not want to do this so we devised a simple work-around that would let us retain the useability of the method discussed above but also ave all this related content available on the one item when it needs to be served up.

The Solution (I will be using a simple ‘Category’ multilist example as a demo here)

We added two hidden (not visible to author) text field within the Metadata base template to correspond with each multilist. These two text fields will contain the content (not the Id’s) of the ‘Description’ field of the referenced items seperating each with a ‘|’ delimeter as can be seen below.

 The categories associate to a simple text field item which must have a field named ‘Description’ within it:

All the categories should lie within a common folder item so that we can point our multilist source at that folder:

In the template that holds the multilist, make sure that you create a text field with the name ‘chosen ‘ + <multilist name>. I.e. in our example, our multilist is named ‘Categories’, so our hidden text field will be called ‘Chosen Categories’

Now we create an OnSaving event which does the following:

1. Check if the item thats being saved contains any multilists

 2. If 1 = true, then for each multilist named <name> in the current item

3. Check if there is a field named ‘Chosen ‘ + <name> (of the current multilist) from 2

4. If 3 = true, then clear the ‘Chosen ‘ + <name> field of its content; retrieve all the items referenced by the current multilist; For each of these items check if a ‘Description’ field exists; if ‘Description’ exists and there is content within it, add this content to ‘Chosen ‘ + <name>

I have pasted the code for the ItemOnSavingEvents.cs class here (sorry about the indentation, copy/paste into blog isnt the best):

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using Sitecore;
using Sitecore.Data.Events;
using Sitecore.Data;
using System.Collections;  

namespace SitecoreSCD1Labs
{
    public class ItemOnSavingEvents
    {
        public void OnItemSavingPopulateHidenFields(object sender, EventArgs args)
        {
            Sitecore.Data.Items.Item item = Sitecore.Events.Event.ExtractParameter(args, 0) as Sitecore.Data.Items.Item;
           
            Sitecore.Collections.FieldCollection fields = item.Fields;

            foreach( Sitecore.Data.Fields.Field field in fields ) {
                if (field.Type == “multilist”)
                {
                    Sitecore.Data.Fields.MultilistField mlf = (Sitecore.Data.Fields.MultilistField)field;
                    String fieldname = field.Name;

                    if( item.Fields["chosen " + fieldname] != null ) { //Hidden field for corresponding multilist exists
                        Sitecore.Data.Fields.Field hiddenField = item.Fields["chosen " + fieldname];
                        hiddenField.SetValue(“”, false);

                        //Populate the hidden field with the descriptions from the related items (pipe delimitered)
                        String[] relatedItemGuids = mlf.Items;
                         
                        foreach (String guid in relatedItemGuids)
                        {
                            Sitecore.Data.Database currentDB = Sitecore.Configuration.Factory.GetDatabase(“master”);
                            Sitecore.Data.Items.Item relatedItem = currentDB.Items.GetItem(guid);                            if (relatedItem != null)
                            {
                                if (relatedItem.Fields["description"] != null)
                                    if (hiddenField.ToString() == “”)
                                        hiddenField.SetValue(relatedItem.Fields["description"].ToString(), false);
                                    else
                                        hiddenField.SetValue(hiddenField.ToString() + “|” + relatedItem.Fields["description"].ToString(), false);                            }
                        }      
                    }
                }
            }
        }
    }
}
 Add a web.config entry in the Item onsave event to run your code:<event name=”item:saving”>
   <handler type=”SitecoreSCD1Labs.ItemOnSavingEvents, SitecoreSCD1Labs” method=”OnItemSavingPopulateHidenFields” />
  </event>Drawbacks of this solutionUnfortunately if the content author changes an existing subject or function then the current items will not automatically change to reflect the new update. The new change will only get reflected on existing items once those items get edited for any reason and re-saved (I have found that some edit needs to be made, i.e. even a smal re-sort of one of the metadata multilist fields, otherwise the item:onsave event does not fire even if save is clicked). In our case the user will most likely only add new subjects and functions and not change existing ones.

In this blog I will describe how to create a very simple Custom Text field in Sitecore. I have based this off the example of a custom checkbox field that can be found in the Sitecore website from here.

I have found that this example is far too complicated. I tried to create a Custom control by inheriting Sitecore.Web.UI.HtmlControls.Control but I could not get it working properly initially (I find the Custom check box control that Sitecore has used as an example is far too complicated) I was sent a better example by sitecore and I will make the same custom control by inheriting this class in the near future when I find the time. However, because of current time constraints I had to take an alternative approach.

The control I have made is inheriting Sitecore.Shell.Applications.ContentEditor.Text directly and then overriding the HandleMessage event.

I needed to create a Custom Text field which behaves the same way as Sitecore’s Text field but I needed some extra menu items. Basically I needed to allow my authors to add some extra text Macron characters e.g. Ā

Here is the Sitecore Field Type item I have created (this should be implemented following the Sitecore example) Base Template is Sitecore>Templates>System>Templates>Template Field Type:

This is the Macron menu item I will be using as an example:

This is the end result I am trying to achieve (A regular text box with extra drop down menu items in Authoring mode):

Here is the Code MacroText.cs. As you may notice only the Clear field and the actual macron menu functions are currently working:
Note: I also had to chuck a space where it says ‘& #256;’ between the & and the #256; because otherwise this blog seems to keep converting it to “Ā’ within the code!!

I have uploaded this code to another blog that actually retains the indentation here

using System;
using System.Collections.Generic;
using System.Text;
using System.Data;
using System.Xml;
using System.Web.UI;

namespace Datacom.FieldTypeExtensions
{
class MacroText : Sitecore.Shell.Applications.ContentEditor.Text
{

#region Constructor
public MacroText()
{
this.Class = “scContentControl”;
base.Activation = true;
}
#endregion

#region Overrides

public override void HandleMessage(Sitecore.Web.UI.Sheer.Message message)
{

if (message["id"] == this.ID)
{
string messageText;
if ((messageText = message.Name) == null)
{
return;
}

switch (messageText)
{
case “macrotext:copy” :
break;
case “macrotext:paste”:
break;
case “macrotext:clearfield”:
this.Value = String.Empty;
break;
case “macrotext:capitalAMacro”:
this.Value = this.Value + “& #256;”;
break;
}
}

base.HandleMessage(message);

}
#endregion
}
}

Here is my Sitecore web.config entry (the name of my assembly is ‘Datacom.FieldTypeExtensions’, this can be edited via the properties of your .NET project as can be seen in next image below):

<controlSources>
<source mode=”on” namespace=”Datacom.FieldTypeExtensions” assembly=”Datacom.FieldTypeExtensions” prefix=”fieldTypeExtension”/>

My project structure:

Hopefully someone finds this helpful!