{"id":54,"date":"2009-11-02T12:21:37","date_gmt":"2009-11-02T19:21:37","guid":{"rendered":"http:\/\/localhost\/todd_wp\/how-to-create-a-custom-site-definition-in-sharepoint-2010-aspx\/"},"modified":"2013-07-01T13:55:30","modified_gmt":"2013-07-01T19:55:30","slug":"how-to-create-a-custom-site-definition-in-sharepoint-2010-aspx","status":"publish","type":"post","link":"https:\/\/toddbaginski.com\/blog\/how-to-create-a-custom-site-definition-in-sharepoint-2010-aspx\/","title":{"rendered":"HOW TO: Create a custom site definition in SharePoint 2010"},"content":{"rendered":"

<\/a><\/p>\n

\u00a0<\/p>\n

This article describes how to create a custom site definition in SharePoint 2010.\u00a0 The process to create a custom site definition has not changed much since the last version of SharePoint, the only differences are the directory names and some of the XML in the WEBTEMP files.\u00a0 See this blog post<\/a> if you would like to see how this is done in WSS 3.0 \/ MOSS 2007.<\/p>\n

Site Definition basics<\/strong><\/p>\n

Site definitions are located in the following folder on the SharePoint server: <\/p>\n

C:Program FilesCommon FilesMicrosoft Sharedweb server 
extensions14TEMPLATESiteTemplates <\/pre>\n
\nEach site definition has its own sub directory under this folder. <\/p>\n
Inside each site definition sub directory the .aspx pages for the various web pages and lists that make up the site definition are stored.\u00a0 Some of the new site definitions that come with SharePoint 2010 also include image files in these subdirectories.\u00a0 The ONET.XML file specifies the various configurations and modules the site definition is made up of.\u00a0 It is stored inside the XML subdirectory inside each site definition sub directory. <\/p>\n
*Note: <\/strong>I think it is interesting that the SDK refers to Site Templates as the .stp files that are generated when you save a site as a template from the web UI, and the SDK refers to file based site templates as site definitions \u2013 yet this directory is named SiteTemplates.\u00a0 This has been the case for a couple of versions now so I don’t think we’ll see it change in the future. <\/p>\n
Site definitions are registered with SharePoint and made available via the WEBTEMP<NAME OF SITE DEFINITION>.XML file.\u00a0 Theoretically, you could register a site definition with SharePoint with one of the out of the box WEBTEMP XML files, however this could introduce problems when service packs or newer versions of the product are released.\u00a0 It is considered best practice to create your own WEBTEMP XML file to register your custom site definitions. <\/p>\n
WEBTEMP XML files are located in the following folder on the SharePoint server: <\/p>\n
C:Program FilesCommon FilesMicrosoft Sharedweb server 
extensions14TEMPLATE1033XML<\/pre>\n
<\/p>\n
Creating a custom Site Definition in SharePoint 2010 \u2013 Manual Approach<\/strong><\/p>\n
\n
\n
\n
\n
Step 1: Clone an existing Site Definition<\/p>\n
Step 2: Create the WEBTEMP XML fragment file to register the site definition with SharePoint<\/p>\n
Step 3: Reset the application pool<\/p>\n
Step 4: Create a site based on the custom site definition<\/p>\n
Step 1: Clone an existing site definition<\/strong><\/p>\n
Navigate to the following directory on the SharePoint server in Windows Explorer:<\/p>\n
\n
C:Program FilesCommon FilesMicrosoft Sharedweb server 
extensions14TEMPLATESiteTemplates<\/pre>\n
\n<\/div>\n
Copy the STS directory and paste it back into the same directory.\u00a0 (You can copy any of the existing site definitions and use them as a baseline to create your own.)<\/div>\n
\u00a0<\/div>\n
Rename the Copy of STS directory to SAMPLE<\/p>\n
Step 2: Create the WEBTEMP XML fragment file to register the site definition with SharePoint<\/strong><\/p>\n
Create a file called WEBTEMPSAMPLE.XML in the following directory:<\/p>\n
\n
C:Program FilesCommon FilesMicrosoft Sharedweb server 
extensions14TEMPLATE1033XML<\/pre>\n
\n<\/div>\n
Put the following XML into the WEBTEMPSAMPLE.XML file:<\/strong><\/div>\n
<\/p>\n
\n
\n
\n
\n
<?xml version=\"1.0\"<\/span> encoding=\"utf-8\"<\/span>?>
<!-- _lcid=\"1033\"<\/span> _version=\"14.0.4514\"<\/span> _dal=\"1\"<\/span> -->
<!-- _LocalBinding -->
<Templates xmlns:ows=\"Microsoft SharePoint\"<\/span>>
 <Template Name=\"SAMPLE\"<\/span> ID=\"10001\"<\/span>>
    <Configuration ID=\"0\"<\/span> Title=\"Sample Team Site\"<\/span> Hidden=\"FALSE\"<\/span> 
        ImageUrl=\"\/_layouts\/images\/stts.png\"<\/span> Description=\"A sample team site.\"<\/span> 
        DisplayCategory=\"Custom Site Definitions\"<\/span> >
    <\/Configuration>
    <Configuration ID=\"1\"<\/span> Title=\"Sample Blank Site\"<\/span> Hidden=\"FALSE\"<\/span> 
        ImageUrl=\"\/_layouts\/images\/stbs.png\"<\/span> Description=\"A sample blank site.\"<\/span> 
        DisplayCategory=\"Custom Site Definitions\"<\/span> AllowGlobalFeatureAssociations=\"False\"<\/span> >
    <\/Configuration>
    <Configuration ID=\"2\"<\/span> Title=\"Sample Document Workspace\"<\/span> Hidden=\"FALSE\"<\/span> 
        ImageUrl=\"\/_layouts\/images\/stdw.png\"<\/span> Description=\"A sample document workspace.\"<\/span> 
        DisplayCategory=\"Custom Site Definitions\"<\/span> >    
    <\/Configuration>
 <\/Template> 
<\/Templates><\/strong><\/pre>\n
\n<\/div>\n
*Note: The DisplayCategory attribute of the <Configuration> element dictates which tab the configuration will appear on in the create new site web dialog. You can create your own tabs by putting your own values in this attribute (like I have done in the XML above and displayed in the screenshot below).\u00a0 The screenshot below demonstrates how the Configuration element\u2019s attributes (inside the WEBTEMP file) map to the create a site dialog. <\/div>\n
\u00a0<\/div>\n
\"WEBTEMP<\/strong><\/a> <\/strong><\/p>\n
Save the file.<\/p>\n
Step 3: Reset IIS<\/strong><\/p>\n
Open a command prompt on the SharePoint server<\/p>\n
Type in the command: iisreset<\/p>\n
Wait for IIS to reset<\/p>\n
Step 4: Create a site based on the custom site definition<\/strong><\/p>\n
Open Internet Explorer<\/p>\n
Navigate to a SharePoint site on the server where you performed the steps above.<\/p>\n
Click the Site Actions menu<\/p>\n
Select New Site<\/p>\n
Click the Custom Site Definitions tab on the left side of the create a site dialog to see the new site templates you registered with the SAMPLE site definition.\u00a0 <\/p>\n
Select one of the sample site templates you created.<\/p>\n
Enter a title and URL<\/p>\n
Click the Create button and your new SharePoint site is created.<\/p>\n
Creating a custom Site Definition in SharePoint 2010 \u2013 Visual Studio 2010 Approach<\/strong><\/p>\n
Visual Studio 2010 simplifies the process by providing a project type specifically tailored for this purpose.\u00a0 To create a custom site definition with Visual Studio 2010 first create a new Site Definition project.\u00a0 See the screenshot below for reference.<\/p>\n
\"Creating<\/a> <\/p>\n
Then set the path to the SharePoint site where you would like to deploy the site definition.<\/p>\n
\"Set<\/a> <\/p>\n
Once the project is created, you can see all the files needed to support a custom site definition in the Solution Explorer.<\/p>\n
\"Solution<\/a> <\/p>\n
After you make edits to the files all you need to do is press F5 and the custom site definition is packaged into a WSP and deployed to the SharePoint server.\u00a0 All that is left to do is to create a new site based on the custom site definition to verify it works properly.\u00a0 <\/p>\n
\"How<\/a> <\/p>\n
Here you can see what the site template looks like when you use the out of the box Visual Studio 2010 Site Definition project type.<\/p>\n
\"SharePoint<\/strong><\/a> <\/strong><\/p>\n
Wrap Up<\/strong><\/p>\n
There are several blog posts which discuss when and why you may want to create a custom site definition.\u00a0 Some folks are of the opinion it is something you should never do, other folks believe it makes sense to do it in certain situations.\u00a0 Personally, I believe they are a good solution when you need a new ID to staple features to.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
\u00a0 This article describes how to create a custom site definition in SharePoint 2010.\u00a0 The process to create a custom site definition has not changed much [\u2026]<\/span><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[98],"tags":[10,5,6,7,13,12],"class_list":["post-54","post","type-post","status-publish","format-standard","hentry","category-sharepoint-2010","tag-custom-development","tag-helpful-code","tag-how-to-sharepoint","tag-sharepoint","tag-site-definitions","tag-site-templates"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/posts\/54","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/comments?post=54"}],"version-history":[{"count":1,"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/posts\/54\/revisions"}],"predecessor-version":[{"id":813,"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/posts\/54\/revisions\/813"}],"wp:attachment":[{"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/media?parent=54"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/categories?post=54"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/toddbaginski.com\/blog\/wp-json\/wp\/v2\/tags?post=54"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}