Click here to Skip to main content
65,938 articles
CodeProject is changing. Read more.
Articles / productivity / SharePoint / SharePoint2010

Site Map Web Part (SharePoint Server 2010)

4.57/5 (7 votes)
6 Jul 2014CPOL2 min read 106K   2.9K  
Displays site structure in a hierarchical tree that is expandable and collapsible

 

Introduction

{A SharePoint 2013 version of the webpart is available here.]

Site Map Web Part displays structure of a Microsoft SharePoint Server 2010 site in a hierarchical tree that is expandable and collapsible. This web part is adapted from my SharePoint Server 2007 version.

Description

This Web Part uses a SiteMapProvider to render the site structure in a hierarchical tree that is expandable and collapsible. The SiteMapProvider is referenced from the site's web.config and is defaulted to be CurrentNavigation. In a publishing site, options to show subsites and/or pages are defined by each web's Navigation setting.

It has several public properties:

  • SiteMapProvider - (Site Map Provider) A site map provider that inherits from type SiteMapProvider defined in web.config. Default is CurrentNavigation.
  • StartNodeKey - (Starting Site URL) Server-relative URL for a starting sub-site.
    For example: /sub2/sub21. Default is /, the root site. If set to blank, starting sub-site will be the current site.
  • ExpandMap - (Expand Map?) Expand all nodes on page load. Default is true.
  • MaxLevels - (Maximum levels) Maximum number of node levels. Default is 0 for unlimited.
  • ListCssClass - CSS class name for the outermost <ul> tag. Default is smwp-list.
  • CurrentNodeCssClass - CSS class name for the current node. Default is smwp-current-node.

The Web Part uses a resource file to store all messages and property attribute UI strings. It demonstrates how to develop a custom class that inherits WebDescriptionAttribute, WebDisplayNameAttribute or CategoryAttribute and returns a localized string from your own Resource Manager.

The supplied Visual Studio 2013 solution includes all the support files you need to build and deploy this Web Part, minus the strong name key file. It makes full use of the built-in SharePoint integration. No more third party tools or custom pre and post build scripts are needed to build the SharePoint solution file.

Installation

If you are upgrading from a previous version, please refer to Version History for any special upgrade instructions.

Open SharePoint 2010 Management Shell, add solution file QuestechSystems.SharePoint.SiteMapWebPart.wsp using Add-SPSolution like

Add-SPSolution "C:\_deployment\QuestechSystems.SharePoint.SiteMapWebPart.wsp"

Go to SharePoint 2010 Central Administration/System Settings/Manage farm solutions. Deploy the installed solution to selected web applications. In the site collection where the solution is deployed, activate the Site Collection Feature Questech Systems Site Map Web Part. After that, the Site Map Web Part (listed under Questech Systems) should be available for you to add to pages.

History

  • V1.1 - 2014.07.06
    • Upgrade instructions from V1.0
      1. Delete all instances of old web parts.
      2. Retract old solution using PowerShell or via SharePoint 2010 Central Administration.
      3. Follow installation instructions as described in Installation section.
    • No longer set properties on global navigation provider. Thanks to Ryan McCarney for advising the implications.
    • Removed public properties IncludeSubSites, IncludePages, NodeCssClass and NoUrlNodeCssClass.
    • Included minimal styling.
  • V1.0 - 2010.05.19 - Initial version.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)