SharePoint 2013 自定义扩展菜单



在对SharePoint进行开发或者功能扩展的时候，经常需要对一些默认的菜单进行扩展，以使我们开发的东西更适合SharePoint本身的样式。SharePoint的各种功能菜单，像网站设置、Ribbon、列表里的下拉等等，都是一样原理的，都是XML+JS脚本实现的，如果想实现这些功能，只需要一个XML发布成Feature，并在网站功能启用，即可。

　　其实，关于这个并没有什么过多可以说的东西，大家在实践中，渐渐理解了。下面，我就举几个简单的例子，做一下简要说明。

项目结构

　　新建一个空白的SharePoint 2013项目，添加一个Feature文件，一个菜单定义的XML文件，如下图。

　　XML菜单定义，如下图：

 

例一：扩展wssuc:Welcome控件

扩展前截图：

扩展后截图：

扩展XML：

<?xml version="1.0" encoding="utf-8"?><Elements xmlns="http://schemas.microsoft.com/sharepoint/">  <CustomAction     Id="MyTopMenuLink"     Location="Microsoft.SharePoint.StandardMenu"     GroupId="PersonalActions"     Sequence="0"     Title="博客园-霖雨">    <UrlAction Url="http://www.cnblogs.com/jianyus"/>  </CustomAction></Elements>

例二 扩展SiteAction（网站设置）菜单

扩展前截图

扩展后截图

扩展XML

  <CustomAction     Id="MyTopMenuLink"     Location="Microsoft.SharePoint.StandardMenu"     GroupId="SiteActions"     Sequence="0"     Title="博客园-霖雨">    <UrlAction Url="http://www.cnblogs.com/jianyus"/>  </CustomAction>

 

例三 扩展网站设置菜单

扩展后截图

扩展XML

  <CustomAction     Id="MyTopMenuLink"     Location="Microsoft.SharePoint.SiteSettings"     GroupId="Customization"     Sequence="106"     Title="博客园-霖雨">    <UrlAction Url="http://www.cnblogs.com/jianyus"/>  </CustomAction>

　　网站设置菜单，不仅仅可以通过GroupId设置显示在哪个位置，还可以单独添加一个Group，后面我们会举例说明。

至于GroupId选择哪一个，请参考附后的MSDN文档。

 

例四 扩展文档库Ribbon菜单

扩展后截图

扩展XML

  <CustomAction     Id="MyTopMenuLink"     Location="Microsoft.SharePoint.StandardMenu"     GroupId="SettingsMenu"     RegistrationType="List"     RegistrationId="101"     Sequence="0"     Title="博客园-霖雨">    <UrlAction Url="http://www.cnblogs.com/jianyus"/>  </CustomAction>

　　RegistrationId可以区分是文档库，还是列表库，是TemplateID

 

例五 扩展文档库ECB菜单

扩展后截图

扩展XML

<?xml version="1.0" encoding="utf-8"?><Elements xmlns="http://schemas.microsoft.com/sharepoint/">  <CustomAction     Id="MyTopMenuLink"     Location="EditControlBlock"     RegistrationType="List"     RegistrationId="101"     Sequence="0"     Title="博客园-霖雨">    <UrlAction Url="http://www.cnblogs.com/jianyus"/>  </CustomAction></Elements>

　　如上图，因为Sequence是0，所以这个菜单在最上面，如果想要移动位置，设置这个值即可。

 

例六 扩展网站操作组

扩展后截图

扩展XML

  <!-- Custom Action Group -->  <CustomActionGroup      Id="CustomActionGroup"      Description="自定义组"      Title="我的自定义组"      Location="Microsoft.SharePoint.SiteSettings"      Sequence="30" />  <!-- Custom Action in Custom Action Group -->  <CustomAction      Id="CustomAction1"      Description="自定义操作"      Title="自定义操作一"      GroupId="CustomActionGroup"      Location="Microsoft.SharePoint.SiteSettings"      Rights="ManageWeb"      RequireSiteAdministrator="FALSE"      Sequence="20">    <UrlAction Url="~sitecollection/_layouts/CustomAction1.aspx" />  </CustomAction>  <CustomAction      Id="CustomAction2"      Description="自定义操作"      Title="自定义操作二"      GroupId="CustomActionGroup"      Location="Microsoft.SharePoint.SiteSettings"      Rights="ManageWeb"      RequireSiteAdministrator="FALSE"      Sequence="20">    <UrlAction Url="~sitecollection/_layouts/CustomAction2.aspx" />  </CustomAction>

　　如上图，添加了网站操作组，可以用来添加我们的设置。在2013之前版本，类似SiteAction等，都可以进行分组，但是2013我尝试了一下，分组没有成功。而且，之前版本的网站设置，都是菜单分组的形式；新版本默认都没有分组，是否支持还有待进一步研究。

后记

　　以上，是几个简单的扩展菜单例子，主要还是修改GroupId和Location来确定菜单的显示位置，通过Rights来限制权限，Sequence来设置排序等，更多的扩展，请参考MSDN自行尝试。

参考MSND链接

1、Default Custom Action Locations and IDs

http://msdn.microsoft.com/en-us/library/bb802730.aspx

2、Custom Actions and Ribbons

http://www.matthiaseinig.de/docs/SPSF/OutputHTML/SPSF_RECIPES_CATEGORY_CUSTOMACTIONS.html

3、SharePoint 2013 自定义扩展菜单（二）

包含另外三个例子，列表设置、管理中心、人员和组添加菜单