Displaying the Server Ribbon and Site Actions Menu on Customized Search Pages Upgraded to SharePoint 2010 Using Visual Upgrade

Summary:  Learn how to add the Site Actions menu and SharePoint Server ribbon to Microsoft Office SharePoint Server 2007 search pages that you upgrade to Microsoft SharePoint Server 2010 by using visual upgrade.

Applies to: Business Connectivity Services | Office 2010 | Open XML | SharePoint Designer 2010 | SharePoint Foundation 2010 | SharePoint Online | SharePoint Server 2010 | Visual Studio

Provided by:  Dennis Doorn, Microsoft Corporation | Jo-Anne West, Microsoft Corporation

Contents

Upgrading Search Pages with Visual Upgrade

Microsoft SharePoint Server 2010 provides a new feature during the upgrade process, known as visual upgrade, that enables you to determine when and if the new look for SharePoint Server 2010 is used for a particular site collection. For more information about this feature, see What's New in Upgrade (SharePoint Server 2010).

When you use visual upgrade to upgrade your site to the SharePoint Server 2010 look, search pages that use customized page layouts will not display the SharePoint Server ribbon or the Site Actions menu. This is because in Microsoft Office SharePoint Server 2007 the Site Actions menu was contained within the master page, but in SharePoint Server 2010 the Site Actions menu and the Server ribbon are now contained within the page layout. When using visual upgrade, during the upgrade process the master page is replaced automatically with the new version, but customized layout pages are not replaced with new versions. In these scenarios, the Site Actions menu and the Server ribbon are missing from the page.

Adding the Site Actions Menu and the Server Ribbon

When the Site Actions menu and the Server ribbon are missing from your site's pages, you can re-enable their display by adding the code for them to the customized layout page. The following procedure describes how to do this.

Important

Always create a backup copy of the customized layout page before you modify it.

To add the Site Actions menu and the Server ribbon to the customized layout page

  1. Open your site's Site Settings page by appending /_layouts/settings.aspx to the site's URL, as follows:

    https://ServerName/SiteName/_layouts/settings.aspx

  2. In the Galleries section of the Site Settings page, click Master pages.

  3. Locate your customized layout page in the master page gallery, select it, and then click Download a Copy.

  4. Open the downloaded file in an HTML editor such as Microsoft SharePoint Designer 2010, or in a text editor such as Notepad.

  5. Add the following code at the end of the customized layout page.

    <asp:Content ContentPlaceHolderID="SPNavigation" runat="server">
       <SharePoint:UIVersionedContent UIVersion="4" runat="server">
          <ContentTemplate>
    
             <div id="s4-ribbonrow" class="s4-pr s4-ribbonrowhidetitle">
                <div id="s4-ribboncont">  
                            <SharePoint:SPRibbon 
                                runat="server" 
                                CssFile = ""
                                PlaceholderElementId="RibbonContainer"
                                FixedPositioningEnabled="true"
                                PermissionsString="EditListItems, AddAndCustomizePages"
                                PermissionMode="Any"
                                ApplyPermissionsToRibbonOnly="false">
                                <SharePoint:SPRibbonPeripheralContent
                                    runat="server"
                                    Location="TabRowLeft"
                                    CssClass="ms-siteactionscontainer s4-notdlg">  
    
                           <span class="ms-siteactionsmenu" id="siteactiontd">
    
                           <SharePoint:SiteActions 
                                runat="server" 
                                accesskey="<%$Resources:wss,tb_SiteActions_AK%>" 
                                id="SiteActionsMenuMain" 
                                PrefixHtml="" 
                                SuffixHtml="" 
                                MenuNotVisibleHtml="&amp;nbsp;">
                            <CustomTemplate>
                            <SharePoint:FeatureMenuTemplate runat="server"
                                FeatureScope="Site"
                                Location="Microsoft.SharePoint.StandardMenu"
                                GroupId="SiteActions"
                                UseShortId="true">
    
                           <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_EditPage" 
                                Text="<%$Resources:wss,siteactions_editpage%>" 
                                Description=
                                "<%$Resources:wss,siteactions_editpagedescriptionv4%>" 
                                ImageUrl="/_layouts/images/ActionsEditPage.png" 
                                MenuGroupId="100" 
                                Sequence="110" 
                                ClientOnClickhref= 
                                "javascript:ChangeLayoutMode(false);" />
                           <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_TakeOffline" 
                                Text="<%$Resources:wss,siteactions_takeoffline%>" 
                                Description=
                                "<%$Resources:wss,siteactions_takeofflinedescription%>" 
                                ImageUrl="/_layouts/images/connecttospworkspace32.png" 
                                MenuGroupId="100" 
                                Sequence="120" />
    
                           <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_CreatePage" 
                                Text="<%$Resources:wss,siteactions_createpage%>"
                                Description="<%$Resources:wss,siteactions_createpagedesc%>"
                                ImageUrl="/_layouts/images/NewContentPageHH.png"
                                MenuGroupId="200"
                                Sequence="210"
                                UseShortId="true"
                                ClientOnClickScriptContainingPrefixedUrl="if (LaunchCreateHandler('Page')) { 
                                OpenCreateWebPageDialog('~site/_layouts/createwebpage.aspx') }"
                                PermissionsString="AddListItems, EditListItems"
                                PermissionMode="All" />
                           <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_CreateDocLib" 
                                Text="<%$Resources:wss,siteactions_createdoclib%>"
                                Description="<%$Resources:wss,siteactions_createdoclibdesc%>"
                                ImageUrl="/_layouts/images/NewDocLibHH.png"
                                MenuGroupId="200"
                                Sequence="220"
                                UseShortId="true"
                                ClientOnClickScriptContainingPrefixedUrl="if (LaunchCreateHandler('DocLib')) { 
                                GoToPage('~site/_layouts/new.aspx?FeatureId={00bfea71-e717-4e80-aa17-d0c71b360101}
                                &amp;ListTemplate=101') }"
                                PermissionsString="ManageLists"
                                PermissionMode="Any"
                                VisibilityFeatureId="00BFEA71-E717-4E80-AA17-D0C71B360101" /> 
                           <SharePoint:MenuItemTemplate runat="server" id="MenuItem_CreateSite" 
                                Text="<%$Resources:wss,siteactions_createsite%>"
                                Description="<%$Resources:wss,siteactions_createsitedesc%>"
                                ImageUrl="/_layouts/images/newweb32.png"
                                MenuGroupId="200"
                                Sequence="230"
                                UseShortId="true"
                                ClientOnClickScriptContainingPrefixedUrl="if (LaunchCreateHandler('Site')) { 
                                STSNavigate('~site/_layouts/newsbweb.aspx') }"
                                PermissionsString="ManageSubwebs"
                                PermissionMode="Any" />
                           <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_Create" 
                                Text="<%$Resources:wss,siteactions_create%>"
                                Description="<%$Resources:wss,siteactions_createdesc%>"
                                MenuGroupId="200"
                                Sequence="240"
                                UseShortId="true"
                                ClientOnClickScriptContainingPrefixedUrl="if (LaunchCreateHandler('All')) { 
                                STSNavigate('~site/_layouts/create.aspx') }"
                                PermissionsString="ManageLists, ManageSubwebs"
                                PermissionMode="Any" />
    
                           <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_ViewAllSiteContents"
                                Text="<%$Resources:wss,quiklnch_allcontent%>"
                                Description="<%$Resources:wss,siteactions_allcontentdescription%>"
                                ImageUrl="/_layouts/images/allcontent32.png"
                                MenuGroupId="300"
                                Sequence="302"
                                UseShortId="true"
                                ClientOnClickhref="~site/_layouts/viewlsts.aspx"
                                PermissionsString="ViewFormPages"
                                PermissionMode="Any" />
                                 <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_EditSite"
                                Text="<%$Resources:wss,siteactions_editsite%>"  
                                Description="<%$Resources:wss,siteactions_editsitedescription%>"
                                ImageUrl="/_layouts/images/SharePointDesigner32.png" 
                                MenuGroupId="300"
                                Sequence="304"
                                UseShortId="true"
                                ClientOnClickScriptContainingPrefixedUrl="EditInSPD('~site/',true);"
                                PermissionsString="AddAndCustomizePages"
                                PermissionMode="Any" />
                                <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_SiteWorkflow" 
                                Text="<%$Resources:wss,siteactions_siteworkflow%>"
                                Description="<%$Resources:wss,siteactions_siteworkflowescription%>"
                                ImageUrl="/_layouts/images/ManageWorkflow32.png"
                                MenuGroupId="300"
                                Sequence="305"
                                UseShortId="true"
                                ClientOnClickhref="~site/_layouts/workflow.aspx"
                                PermissionsString="EditListItems, AddAndCustomizePages"
                                PermissionMode="Any" />
                           <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_SitePermissions" 
                                Text="<%$Resources:wss,people_sitepermissions%>"
                                Description="<%$Resources:wss,siteactions_sitepermissiondescriptionv4%>"
                                ImageUrl="/_layouts/images/Permissions32.png"
                                MenuGroupId="300"
                                Sequence="310"
                                UseShortId="true" 
                                ClientOnClickhref="~site/_layouts/user.aspx" 
                                PermissionsString="EnumeratePermissions"
                                PermissionMode="Any" />
                           <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_Settings"
                                Text="<%$Resources:wss,settings_pagetitle%>"  
                                Description="<%$Resources:wss,siteactions_sitesettingsdescriptionv4%>"
                                ImageUrl="/_layouts/images/settingsIcon.png" 
                                MenuGroupId="300"
                                Sequence="320"
                                UseShortId="true"
                                ClientOnClickhref="~site/_layouts/settings.aspx"
                                PermissionsString="EnumeratePermissions,ManageWeb,ManageSubwebs,
                               AddAndCustomizePages,ApplyThemeAndBorder,ManageAlerts,
                               ManageLists,ViewUsageData"
                                PermissionMode="Any" />
                           <SharePoint:MenuItemTemplate 
                                runat="server" 
                                id="MenuItem_CommitNewUI" 
                                Text="<%$Resources:wss,siteactions_commitnewui%>"
                                Description="<%$Resources:wss,siteactions_commitnewuidescription%>"
                                ImageUrl="/_layouts/images/visualupgradehh.png"
                                MenuGroupId="300"
                                Sequence="330"
                                UseShortId="true"
                                ClientOnClickScriptContainingPrefixedUrl="GoToPage('~site/_layouts/prjsetng.aspx')"
                                PermissionsString="ManageWeb"
                                PermissionMode="Any"
                                ShowOnlyIfUIVersionConfigurationEnabled="true" />
    
                           </SharePoint:FeatureMenuTemplate>
                          </CustomTemplate>
    
                          </SharePoint:SiteActions></span>
    
                                </SharePoint:SPRibbonPeripheralContent>
    
                            </SharePoint:SPRibbon>
                </div>
             </div>
             <div id="notificationArea" class="s4-noti">
             </div>
             <SharePoint:DelegateControl runat="server" ControlId="PublishingConsole">
             </SharePoint:DelegateControl>
             <div>
                <WebPartPages:WebPartAdder ID="WebPartAdder" runat="server" />
             </div>
          </ContentTemplate>
       </SharePoint:UIVersionedContent>
    </asp:Content>
    
  6. Save your changes.

  7. In the master page gallery, click Upload Document.

  8. Click Browse, select the customized layout page you just updated, and then click Open.

  9. Select the Add as a new version to existing files check box, and then click OK.

Conclusion

The visual upgrade feature in SharePoint Server 2010 provides you with the ability to:

  • Choose to adopt the new look and feel of SharePoint Server 2010 for all sites during upgrade or keep the earlier look and feel of Office SharePoint Server 2007 for all sites

  • Enable site owners make the choice after upgrade

If you decide to use visual upgrade to adopt the new look and feel of SharePoint Server 2010, you can modify the customized layout pages by using the steps described in this article to display the Site Actions menu and the Server ribbon.

Additional Resources

For more information, see the following resources: