Microsoft KB Archive/944105

= How to customize application pages in the Layouts folder in SharePoint Server 2007 and in Windows SharePoint Services 3.0 =

Article ID: 944105

Article Last Modified on 10/30/2007

-

APPLIES TO


 * Microsoft Office SharePoint Server 2007
 * Microsoft Windows SharePoint Services 3.0

-



INTRODUCTION
This article describes two methods to customize the appearance and the behavior of your site collections in Microsoft Office SharePoint Server 2007 and in Microsoft Windows SharePoint Services 3.0.



MORE INFORMATION
Modifying the files that are installed by SharePoint is not supported. However, there are some scenarios in which you may have to modify these files to achieve consistent branding or other customizations. When you modify these files, you must consider that they may be replaced by future updates and service packs. Additionally, there may be complications when you upgrade to later versions of the product. Keep backup copies of all customized files in case they are overwritten by an update. Product support will provide commercially reasonable support for help with modifications but will be unable to provide product changes or hotfixes that result from modifying the files that are installed by SharePoint.

To customize the appearance and the behavior of your site collections, use one of the following methods.

Method 1: Customize the files in the Layouts folder (recommended)
 Create a Layouts_Backup folder to contain a backup of the originally installed files and folders. For example, create a Layouts_Backup folder in the following location:

C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\Template\Layouts\Layouts_Backup

 Copy the originally installed files and folders from the Layouts folder to the Layouts_Backup folder that you created in step 1. For example, copy the originally installed files and folders from the following folder to the Layouts_Backup folder:

C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\Template\Layouts

 In the Layouts folder, customize the .aspx files and the Application.Master file as needed.

Method 2: Create a custom Layouts folder
Note This method will change the layouts directory for any site collection within the Web application that is being modified. To apply custom layouts changes to an individual site collection, the site collection should reside in its own Web application.  Create a custom Layouts folder to contain a copy of the originally installed files and folders. For example, create a Layouts folder in the following location:

C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\Template\Layouts\Layouts

Note The  placeholder is the name of a site collection. Copy the originally installed files and folders from the Layouts folder to the Layouts folder that you created in step 1. For example, copy the originally installed files and folders from the following folder to the Layouts folder:

C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\Template\Layouts

 Start Internet Information Services (IIS) Manager. To do this, click Start, point to All Programs, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.</li> In IIS Manager, follow these steps:  Expand the Web site that is hosting the site collection.</li> Right-click _layouts, and then click Properties.</li> Click the Virtual Directory tab.</li> Click Browse, change the path from the Layouts folder to the Layouts folder, and then click OK two times.</li></ol> </li> In the Layouts folder, customize the .aspx files and the Application.Master file as needed.</li> Repeat these steps for each site collection that you have to customize.</li></ol>

Advantage of Method 2

 * This method enables the customization of application pages for individual site collections.

Limitations of Method 2

 * If a public update, a hotfix package, or a service pack is installed that contains updates to the files in the Layouts folder, the update is not applied to your custom Layouts folder.
 * This method may cause excessive manageability and maintenance issues.
 * Any hard-coded functionality in SharePoint Server 2007 or Windows SharePoint Services 3.0 that references the Layouts folder instead of the _layouts virtual directory may not function as expected.

Additional query words: moss2007 moss2k7 moss12 wss3 wss30 wss3.0

Keywords: kbhowto kbpubtypekc kbexpertiseinter KB944105

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.