SharePoint MySite Branding

Problem

Solution

• Public / Shared Site Collection : (My Profile = MySite)
  • This public/shared site collection applied to the entire portal can have custom branding (i.e.: Custom master page) using Microsoft SharePoint designer 2007.

• Private Site Collection : (My Home = Personal) {Here We Go !}
  • This private site collection can not be branded via Microsoft SharePoint designer and be effective for all private users, because for each user it creates a separate sub-site (webs) under the private site collection which has a different master page.  So the only effective solution and best practices is to create a "Feature Stapling" which is the process in which a feature can be attached with site templates, so that a site can be created with certain pre-activated features.

Here are the detailed steps to create our feature stapling.

Enable "Publishing feature" for both My Home (Private) & My Profile (Shared - Public MySite web application) in order to activate and enable the "Master Page" change settings under the "Look and Feel" section for both :

• Click on the Site Actions menu > Site Settings > Site Collection features (Under : "Site Collection Administration" section)
• Click on the Activate button for "Office SharePoint Server Publishing Infrastructure".

For quickly browsing to the targeted features pages type the below URLs in your browser:

• For My Profile (Public Shared / MySite): http:///MySite/_layouts/ManageFeatures.aspx?Scope=Site
• For My Home (Private / Personal): http:///personal//_layouts/ManageFeatures.aspx?Scope=Site

Creating the stapler feature. We can do it quickly and manually via the below procedures:

• Go to the below targeted features 12 hive folder: C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES
• Create a new directory (ex: CustomMySiteFeature).
• Put your custom master page (ex: CustomMySite.master) in this folder which will be applied to your MySite Look and Feel and create two empty XML files (feature.xml and elements.xml).
• Open and edit "feature.xml" via a suitable editor and paste the below code:

<?xml version="1.0" encoding="utf-8"?>	
<Feature Id="6cca294a-4c6f-4715-a98f-876dceead182"
Title="CustomMySiteFeature"
Description="Description for CustomMySiteFeature"
Version="12.0.0.0"
Hidden="FALSE"
Scope="Site"
DefaultResourceFile="core"
xmlns="http://schemas.microsoft.com/sharepoint/"
ReceiverAssembly="CustomMySiteFeatureStapling, Version=1.0.0.0, 
Culture=neutral, PublicKeyToken=2c09f0dec64aee86" 
ReceiverClass="CustomMySiteFeatureStapling.MySiteFeatureStapler">
<ElementManifests>
	<ElementFile Location="CustomMySite.master"/>
	<ElementManifest Location="elements.xml"/>
</ElementManifests>
</Feature>

The ReceiverAssembly tag defines a declaration for the custom code stapler which will switch / change the initial default master page without custom branded ones (CustomMySite.master).

Open and edit the new "elements.xml" and paste the below code:

<?xml version="1.0" encoding="utf-8" ?>	
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
	<Module Name="CustomMySiteMasterPage" RootWebOnly="true" Url="_catalogs/masterpage">
		<File Url="CustomMySite.master" Type="GhostableInLibrary" />
	</Module>
</Elements>

Creating the custom code stapler as referenced by "ReceiverAsembly" in the feature.xml file:

• Open Visual Studio.NET (2005,2008).
• File > New > Project > Class Library (C#) (ex: Name : MySiteFeatureStapler) .
• Reference the "Microsoft. SharePoint" DLL from the ISAPI directory "C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\ISAPI".
• Inherit from "SPFeatureReceiver" interface.
• Sign the DLL using a strongly name signing (Right Click on your Solution > Properties > Sign).
• Paste the below code snippet in your "MySiteFeatureStapler.cs" class code file

• Build and then drag and drop the generated strongly signed DLL to the GAC (Global Assembly Cash) [Run> assembly].
• Make a recycling pool operation [Run> iisreset].

Install and activate our stapler feature which we created in step 2:

• Open command prompt (Run > cmd)
• Change the directory to this path: C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\BIN
• Type this command for installing our feature: stsadm -o installfeature -name
• Then you can open the Central Administration > Operations > Solution Management in order to deploy our feature to a selected web application(s) then open the targeted site collections
  (Public and Private) and activate the feature at Site Collection features or you can use this command: stsadm -o activatefeature -name -url <http://mysite_web_app>

For My Profile we'll do it only once, but for the My Home we have do it for every user which is a headache and inconvenient.  So below I show a PowerShell script to dynamically and
automatically enable the feature for both My Profile and My Home without having to enable it manually.  Also we can create another holder feature which will execute the
stapler feature.

Next Steps

• Return to MSSharepointTips to read about other topics and ideas.
• Check out MSSQLTips.com for great information about Microsoft SQL Server.