SharePoint自定义扩展菜单

参考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

 

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

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

项目结构

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

clip_image001

  XML菜单定义,如下图:

clip_image002

 

例一:扩展wssuc:Welcome控件

扩展前截图:

clip_image003

扩展后截图:

clip_image004

扩展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(网站设置)菜单

扩展前截图

clip_image005

扩展后截图

clip_image006

扩展XML

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

 

例三 扩展网站设置菜单

扩展后截图

clip_image007

扩展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菜单

扩展后截图

clip_image008

扩展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菜单

扩展后截图

clip_image009

扩展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,所以这个菜单在最上面,如果想要移动位置,设置这个值即可。

 

例六 扩展网站操作组

扩展后截图

clip_image010

扩展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

 

 

例七 列表设置菜单扩展(listedit.aspx

扩展效果

clip_image006

XML描述

复制代码
  <CustomAction
      Id="CustomAction1"
      Description="博客园-霖雨"
      Title="博客园-霖雨"
      GroupId="GeneralSettings"
      Location="Microsoft.SharePoint.ListEdit"
      Rights="ManageWeb"
      RequireSiteAdministrator="FALSE"
      Sequence="20">
    <UrlAction Url="http://www.cnblogs.com/jianyus" />
  </CustomAction>
复制代码


例八 管理中心应用程序管理扩展菜单

扩展效果

clip_image007

XML描述

复制代码
  <CustomAction
      Id="ChangeNameDescriptionGroup"
      Description="博客园-霖雨"
      Title="博客园-霖雨"
      GroupId="WebApplications"
      Location="Microsoft.SharePoint.Administration.Applications"
      Rights="ManageWeb"
      Sequence="20">
    <UrlAction Url="http://www.cnblogs.com/jianyus" />
  </CustomAction>
复制代码

注:这个Feature的范围,要是Farm级别的,要不然,对管理中心不生效。

  其他位置参考Default Custom Action Locations and IDs即可

 

例十 扩展“人员和组”设置(groups.aspx)菜单

扩展效果

clip_image008

XML描述

复制代码
  <CustomAction
      Id="ChangeNameDescriptionGroup"
      Description="博客园-霖雨"
      Title="博客园-霖雨"
      GroupId="SettingsMenu"
      Location="Microsoft.SharePoint.GroupsPage"
      Rights="ManageWeb"
      Sequence="20">
    <UrlAction Url="http://www.cnblogs.com/jianyus" />
  </CustomAction>
复制代码


结束语

  在之前的博客基础上,多加了几个例子,方便大家理解Location和GroupId的作用,希望简单的例子,能够对大家有所帮助。

 

 

对 SharePoint 列表项隐藏 ECB 中的菜单项

SharePoint 2010
其他版本

上次修改时间: 2010年3月30日

适用范围: SharePoint Foundation 2010

可以通过使用功能框架向编辑控制块 (ECB) 菜单添加新的自定义操作。但是,您不能使用此方法进行相反的操作,即隐藏现有的 ECB 菜单项,因为它们是通过使用 ECMAScript(JavaScript、JScript) 文件(即 core.js)呈现的。请注意,不支持也不建议修改 core.js 文件。

因此,若要隐藏 ECB 菜单项,必须创建一个 customcore.js 文件,修改此文件以隐藏菜单项,然后通过自定义母版页来呈现 customcore.js 文件。请注意,即时即用 core.js 文件必须保留在该自定义母版页中;因此,customcore.js 文件应具有值为 true 的"Defer"属性。

下面的步骤用于创建一个 customcore.js 文件并通过自定义母版页呈现该文件。

 

隐藏ECB菜单

http://www.cnblogs.com/jianyus/p/3954712.html

1、通过spd打开我们需要扩展ECB菜单的页面,添加我们写好的js,最后在介绍这样操作的原理

2、js文件如下,当然,js操作不仅仅可以完成现在这样的单级菜单,还可以完成二级菜单等,有需要的可以查找相关资料自己研究下。

<script language="javascript">

function Custom_AddListMenuItems(m, ctx)

{

strDisplayText = "百度首页";

strAction = "STSNavigate('http://www.baidu.com')";

strImagePath=ctx.imagesPath+"oisweb.gif";

menuOption = CAMOpt(m,strDisplayText,strAction,strImagePath);

menuOption.id = "ID_MyMenu";

return false;

}

</script>

隐藏 ECB 菜单项

  1. 从其默认位置 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\1033 复制 core.js 文件,将它置于同一文件夹中,并重命名为 customcore.js 文件。

  2. customcore.js 文件中进行必要的更改以移除不需要的 ECB 菜单项。

  3. 若要创建自定义母版页,请制作 default.master 页的副本并将其重命名为 custom.master。

  4. 在自定义母版页中,添加下面的行来呈现 customcore.js 文件:

    <SharePoint:ScriptLink language="javascript" name="core.js" Defer="true" runat="server"/><SharePoint:ScriptLink language="javascript" name="customcore.js" Defer="true" runat="server"/>
  5. 保存 custom.master 页并将其上载到该网站的母版页样式库。然后,将 custom.master 页作为网站的默认母版页应用。

posted on 2015-05-28 21:24  !无名之辈  阅读(310)  评论(0)    收藏  举报