SharePoint Server 2007 Master Page Content Place Holders


Introduction


SharePoint solutions are shaped by business requirements and organizational needs, and so it is natural that they vary in their level of complexity as well as in their use of the different technical capabilities of the platform.


However, I have observed that ‘Site Branding’ to some extent is fairly common across the spectrum of SharePoint projects.


There are different approaches available to us for changing the out-of-the-box appearance of SharePoint sites. The determining factor in deciding the optimal approach to achieve the desired outcome is of course the degree of tailoring required to the look-and-feel.


Here I share with you a visual reference to the content place holders used in default.master, which can help developers attempting to create their own master page based on the default master page.


Master Page – default.master


One of the challenges faced by developers in dealing with a SharePoint Master Page is figuring out the UI elements represented by the different Content Placeholders.


The table below provides a list of the ContentPlaceHolder Ids and corresponding UI element for the default.master Master Page.








































































































Content Placer Holder Id


Corresponding UI Elements


1. PlaceHolderPageTitle


clip_image001


The PlaceHolderPageTitle content placeholder on respective WebForms will expect a string value that represents the page title.


The page title is displayed in the browser’s title bar.


2. PlaceHolderAdditionalPageHead


Additional content that needs to be within the <head> tag of the page, for example, references to script in style sheets.


3. PlaceHolderGlobalNavigation


clip_image002


Contains all the navigation items appearing at the global navigation level.


It has the global bread crumb on the left side and to its right includes global links, welcome user control, my site, my links and help link.


4. PlaceHolderGlobalNavigationSiteMap


clip_image003


Global breadcrumb


5. PlaceHolderSiteName


clip_image004


Site name


6. PlaceHolderSearchArea


clip_image005


Small search input box


7. PlaceHolderTopNavBar


clip_image006


Top navigation area


8. PlaceHolderHorizontalNav


clip_image007


Top navigation menu


9. WSSDesignConsole


clip_image008


The page editing controls when the page is in Edit Page mode (after clicking Site Actions, then Edit Page)


Shows the page status. Corresponding control is – ‘designmodeconscole.ascx’


10. SPNavigation


clip_image009


In MOSS Publishing Console is the control which provides the ‘edit page’, ‘check in’, etc., functionality for publishing pages.


Corresponding control is – ‘PublishingConsole.ascx’


This content place holder is empty by default in Windows SharePoint Services.


11. PlaceHolderPageImage


clip_image010


Page icon in the upper left area of the page.


12. PlaceHolderTitleBreadcrumb


clip_image011


Main content breadcrumb area.


13. PlaceHolderPageTitleInTitleArea


clip_image012


Page title shown immediately below the breadcrumb.


14. PlaceHolderMiniConsole


clip_image013


A place to show page-level commands, for example, WIKI commands such as Edit Page, History, and Incoming Links.


15. PlaceHolderTitleLeftBorder


clip_image014


Left border of the title area.


16. PlaceHolderTitleRightMargin


clip_image015


Right margin of the title area.


17. PlaceHolderTitleAreaSeparator


clip_image016


Shows shadows for the title area.


18. PlaceHolderLeftNavBarDataSource


Data source for the left navigation menu.


19. PlaceHolderCalendarNavigator


clip_image017


Shows a date picker for navigating in a calendar when a calendar is visible on the page.


20. PlaceHolderLeftNavBarTop


clip_image018


Top of the left navigation area.


21. PlaceHolderLeftNavBar


clip_image019


Left navigation area.


22. PlaceHolderLeftActions


clip_image020


Bottom of the left navigation area.


23. PlaceHolderNavSpacer


clip_image021


The width of the left navigation area.


24. PlaceHolderLeftNavBarBorder


clip_image022


Border element on the left navigation bar.


25. PlaceHolderBodyLeftBorder


clip_image023


Border element for the main page body.


26. PlaceHolderPageDescription


Description of the page contents.


27. PlaceHolderMain


Page’s main content.


28. PlaceHolderBodyRightMargin


clip_image024


Right margin of the main page body.


29. PlaceHolderFormDigest


This place holder is at the bottom of the page. It is replaced by a hidden field that holds the “form digest” security control.


The security validation is specific to a user, site, and time period and expires after a configurable amount of time (default is generally 30 minutes). When the user requests a page, the server returns the page with security validation inserted. When the user then submits the form, the server verifies that the security validation has not changed.


For more information see – Security Validation and Making Posts to Update Data


30. PlaceHolderUtilityContent


Extra content that needs to be at the bottom of the page. It is located at the bottom of the page after the form closing tag. Used for content such as footnotes.


31. PlaceHolderBodyAreaClass


Additional body styles in the page header.


32. PlaceHolderTitleAreaClass


Additional styles in the page header.


Information on the master page content placeholders is also available in a concise form on MSDN at http://msdn.microsoft.com/en-us/library/ms467402.aspx


Conclusion


I have found myself cutting down on master page development time using this visual reference and hope you will also find it to be of assistance in your efforts to tailor master pages for SharePoint content pages.


 


Parthasarathi BhattacharjeeParthasarathi Bhattacharjee


Senior Consultant


Microsoft Global Services


parthasb@micosoft.com


 



Comments (3)

  1. Very useful information for branding.

  2. excellent stuff for branding says:

    Thank you author and please keep posting such stuff.

    Sarah

    http://www.sqlservermanagementstudio.net

Skip to main content