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文件,如下图。
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
例七 列表设置菜单扩展(listedit.aspx)
扩展效果
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>
例八 管理中心应用程序管理扩展菜单
扩展效果
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)菜单
扩展效果
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 中的菜单项
上次修改时间: 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 菜单项
-
从其默认位置 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\1033 复制 core.js 文件,将它置于同一文件夹中,并重命名为 customcore.js 文件。
-
在 customcore.js 文件中进行必要的更改以移除不需要的 ECB 菜单项。
-
若要创建自定义母版页,请制作 default.master 页的副本并将其重命名为 custom.master。
-
在自定义母版页中,添加下面的行来呈现 customcore.js 文件:
<SharePoint:ScriptLink language="javascript" name="core.js" Defer="true" runat="server"/><SharePoint:ScriptLink language="javascript" name="customcore.js" Defer="true" runat="server"/> -
保存 custom.master 页并将其上载到该网站的母版页样式库。然后,将 custom.master 页作为网站的默认母版页应用。














浙公网安备 33010602011771号