MOSS 2007 应用随笔系列：自定义moss菜单汇总转

一.自定义文档库/列表库中项目的右键关联菜单

　　原始菜单如下图所示：

　　下面开始我们本次的工作历程：

　　首先，找到C:Program FilesCommon FilesMicrosoft Sharedweb server extensions12TEMPLATELAYOUTS这个目录下的2052目录（这个默认是中文版本的路径，英文版本的MOSS是1033目录），其中有个core.js的JS文件，MS已经给我们预留了自定义的接口来实现我们自己的菜单定义了

　　添加以下两个JS的函数代码：

funtion AddListMenuItems(m,ctx)
{
if(typeof(Custom_AddListMenuItems) != "undefined")
{
　if(Custom_AddListMenuItems(m,ctx))
　return;
}
}
　　
funtion AddDocLibMenuItems(m,ctx)
{
if(typeof(Custom_AddListMenuItems) != "undefined")
{
　if(Custom_AddListMenuItems(m,ctx))
　return;
}
}

　　然后我们实现自定义函数AddListMenuItems（列表库）和AddDocLibMenuItems（文档库）

　　，在页面右上角点击‘网站操作’--编辑网页--添加Webpart部件，选择

　　点击Webpart部件右边的‘编辑’--修改共享Webpart部件

　　在页面中点击‘源编辑器’

　　，在弹出的窗口中添加自定义函数AddListMenuItems（列表库）和AddDocLibMenuItems（文档库）

<script language="javascript">
function Custom_AddDocLibMenuItems(m, ctx)
{
　　strDisplayText = "报表统计";
　　var rootMenu = CASubM(m,strDisplayText,"","",500);
　　strDisplayText = "汇总表";
　　strAction = "STSNavigate('~site/_layouts/ItemAudit.aspx?ItemId={ItemId}&amp;ListId={ListId}')";
　　strImagePath=ctx.imagesPath+"oisweb.gif";
　　menuOption = CAMOpt(rootMenu,strDisplayText,strAction,strImagePath);
　　menuOption.id = "ID_MySubMenu";
　　
　　//var rootMenu = CASubM(m,strDisplayText,"","",500);
　　strDisplayText = "数字统计表";
　　strAction = "STSNavigate('~site/_layouts/ItemAudit.aspx?ItemId={ItemId}&amp;ListId={ListId}')";
　　strImagePath=ctx.imagesPath+"oisweb.gif";
　　menuOption = CAMOpt(rootMenu,strDisplayText,strAction,strImagePath);
　　menuOption.id = "ID_MySubMenu";
　　
　　strDisplayText = "行列汇总表";
　　strAction = "STSNavigate('~site/_layouts/ItemAudit.aspx?ItemId={ItemId}&amp;ListId={ListId}')";
　　strImagePath=ctx.imagesPath+"oisweb.gif";
　　menuOption = CAMOpt(rootMenu,strDisplayText,strAction,strImagePath);
　　menuOption.id = "ID_MySubMenu";
　　
　　strDisplayText = "并列汇总表";
　　strAction = "STSNavigate('~site/_layouts/ItemAudit.aspx?ItemId={ItemId}&amp;ListId={ListId}')";
　　strImagePath=ctx.imagesPath+"oisweb.gif";
　　menuOption = CAMOpt(rootMenu,strDisplayText,strAction,strImagePath);
　　menuOption.id = "ID_MySubMenu";
　　
　　return false;
}
</script>

　　点击保存--应用--确定--退出编辑模式

　　好，看到我们期待已久的最终结果，

注意，这里是List和Doc是2个分别的JS方法名。 

这个菜单是用Feature部署上去的功能，先提一下Feature的作用：

　　微软在MOSS中利用Feature的特性，可以将Feature.xml中以特定格式描述的功能部署到MOSS中，这些功能包括工作流，菜单项，网站栏、内容类型...等等。然后可以在MOSS中配置启用或者停用这些功能，由于这个特性不需要进行代码开发，只需要配置Feature.xml和其中指定的另一个xml，方法简单可行。

　　Feature.xml如下：

<?xml version="1.0" encoding="utf-8" ?>
<Feature Id="6098EC11-8128-409A-8D2C-414E93F67DD4"
　　
　　　　　　Title="add my menu"
　　
　　　　　　Description="this is a custom menu"
　　
　　　　　　Version="1.0.0.0"
　　
　　　　　　Scope="Site"
　　
　　　　　　Hidden="FALSE"
　　
　　　　　　DefaultResourceFile="customDocumentLibrary"
　　
　　　　　　xmlns="http://schemas.microsoft.com/sharepoint/
">
　　
　　　　　　<ElementManifests>
　　
　　　　　　　　<ElementManifest Location="elements.xml" />
　　
　　　　　　</ElementManifests>
　　
</Feature>

　　解释一下其中的内容，Id是GUID类型标示的唯一值，可以由VS自带的GUID Generator来生成，Tiltle是功能标题，Version是版本号，Description:对description的描述，Scope:其值可以是Web或Site,它指明了这个Feature是应用于整个的Site Collection还是仅仅用于单独的一个子站点。Hidden:值可以是True或False.该设置指定了这个Feature是否在Site Feature页面上显示。DefaultResourceFile: 资源文件名字，Feature依赖它提供其它附加的配置信息。

Feature.xml文件中的<ElementManifests>元素，这个元素包含了另一个XML文件的位置，而这个文件包含的<Elemnets>的内容是Feature要实现的。

　　<ElementManifest>元素指明了要使用一个名为ProvisionedFiles.xml的文件，以下是该文件的<Elements>元素内容。

　　下面是Feature.xml中指定的elements.xml内容：

<Elementsxmlns="http://schemas.microsoft.com/sharepoint/">
<!-- create command link site setting page -->
<CustomAction Id="SiteSettings" GroupId="Customization"
　　　　　　　　Location="Microsoft.SharePoint.SiteSettings"
　　　　　　　　　　　　　　Sequence="106"
　　　　　　　　　　　　　　Title="Custom Litware Site Setting Command">
　　　　　　　　　　　　　　<UrlAction Url="/_layouts/litwarefeaturelab.aspx?command=SiteSettingCommand"/>
　　 </CustomAction>
　　 <!--Add command to site action dropdow -->
　　　 <CustomActionId="SiteActionsToolbar111111111111"
　　
　　　 　　　　　　　　GroupId="SiteActions"
　　　　　　　　　　　　　　　　　 Location="Microsoft.SharePoint.StandardMenu"
　　　　　　　　　　　　　　　　　 Sequence="1000"
　　　　　　　　　　　　　　　　　 Title="Litware custom Action"
　　　　　　　　　　　　　　　　　 Description="custom litware site action"
　　　　　　　　　　　　　　　　　 ImageUrl="/_layouts/images/ACL16.GIF">
　　　　　　　　　　　　　　　　　 <UrlAction Url="/_layouts/litwarefeaturelab.aspx?command=SiteActionCommand"/>
　　</CustomAction>
　　　 <!-- Document Library Toolbar New Menu DropDown-->
　　　 <CustomAction Id="DocLibNewToolbar"
　　　 　　　　RegistrationType="List"
　　　　　　　　　　 RegistrationId="101"
　　　　　　　　　　 GroupId="NewMenu"
　　　　　　　　　　 Rights="ManagePermissions"
　　　　　　　　　　 Location="Microsoft.SharePoint.StandardMenu"
　　　　　　　　　　 Sequence="1000"
　　　　　　　　　　 Title="Litware Custom New Command"
　　　　　　　　　　 Description="THis Command Creates a new Litware doc"
　　　　　　　　　　 ImageUrl="/_layouts/images/ACL16.GIF">
　　　　　　　　　　 <UrlAction Url="/_layouts/litwarefeaturelab.aspx?command=NewDocCommand"/>
　　</CustomAction>
　　　 <!-- Document library Toolbar Actions Menu Dropdown-->
　　　 <CustomAction Id="DocLibActionsToolbar"
　　　 　　　　RegistrationType="List"
　　　　　　　　　　 RegistrationId="101"
　　　　　　　　　　 GroupId="ActionsMenu"
　　　　　　　　　　 Rights="ManagePermissions"
　　　　　　　　　　 Location="Microsoft.SharePoint.StandardMenu"
　　　　　　　　　　 Sequence="1000"
　　　　　　　　　　 Title="Litware Command on Document Library"
　　　　　　　　　　 Description="THis Command Creates a new Litware doc"
　　　　　　　　　　 ImageUrl="/_layouts/images/ACL16.GIF">
　　　　　　　　　　 <UrlAction Url="/_layouts/litwarefeaturelab.aspx?command=DocLibCommand"/>
　　　　 </CustomAction>
　　　　 <CustomActionId="ECBItemToolbar"
　　　 　　　　RegistrationType="List"
　　　　　　　　　　 RegistrationId="101"
　　　　　　　　　　 Type="ECBItem"
　　　　　　　　　　 Location="BugWorkaround:LocationShouldEqualEditControlBlock"
　　　　　　　　　　 Sequence="106"
　　　　　　　　　　 Title="Litware ECB item Command">
　　　　　　　　　　 <UrlActionUrl="/_layouts/litwarefeaturelab.aspx?command=SiteSettingCommand"/>
　　　　 </CustomAction>
</Elements>

其中第一个CustomAction在Site Setting页面中的LOOK AND FEEL标题下创建了一个自定义链接.第二个CustomAction在页面的Site Action菜单下增加了一个用户自定义菜单项.第三个CustomAction在文档库的New下拉菜单下创建了一个自定义菜单项.第四个CustomAction在文档库的Action下拉菜单下创建了一个自定义菜单项.

　　注意第五个CustomAction本来是在文档库的每个列表项的菜单上增加一个菜单项,但是不知什么原因不能正确加入,有待进一步的研究.

　　再做俩个批处理文件来部署和卸载这个Feature

　　部署批处理文件InstallFeature.bat

@rem======================================================================
@rem
@rem　　InstallFeature.bat
@rem
@rem======================================================================
@echo off
setlocal
pushd .
goto InstallFeature
@rem----------------------------------------------------------------------
@rem　 InstallFeature
@rem----------------------------------------------------------------------
:InstallFeature
　　set SPAdminTool=%CommonProgramFiles%Microsoft Sharedweb server extensions12BINstsadm.exe
　　set TargetUrl=http://huijianming
　　set FeaturePath=menuFeature.xml
　　echo InstallFeature %FeaturePath%
　　"%SPAdminTool%" -o installfeature -filename %FeaturePath% -force
　　echo Activating feature %FeaturePath%
　　"%SPAdminTool%" -o activatefeature -filename %FeaturePath% -url %TargetUrl% -force
　　echo iisreset
　　iisreset

　卸载批处理文件UnInstallFeature.bat

@rem======================================================================
@rem
@rem　　UnInstallFeature.bat
@rem
@rem======================================================================
@echo off
setlocal
pushd .
goto UnInstallFeature
@rem----------------------------------------------------------------------
@rem　 UnInstallFeature
@rem----------------------------------------------------------------------
:InstallFeature
　　set SPAdminTool=%CommonProgramFiles%Microsoft Sharedweb server extensions12BINstsadm.exe
　　set TargetUrl=http://huijianming
　　set FeaturePath=menuFeature.xml
　　echo InstallFeature %FeaturePath%
　　"%SPAdminTool%" -o UnInstallFeature-filename %FeaturePath% -force
　　echo iisreset
　　iisreset

　　将以上的两个XML放到Menu的文件夹中，然后将文件夹拷贝到C:Program FilesCommon FilesMicrosoft Sharedweb server extensions12TEMPLATEFEATURES

　　运行部署批处理文件

　　效果图如下：

　　文档库新建菜单

 

　　文档库操作菜单

　　网站操作菜单

　　运行卸载批处理文件