控制SharePoint站点菜单(eg:Actions-Edit+In+DataSheet)

来源:互联网 发布:移动数据怎么打不开 编辑:程序博客网 时间:2024/04/30 05:28
 

用户在浏览SharePoint 2007界面时,会使用到众多的菜单和链接,比如Library上面的ToolbarMenu (新建,上传,设置等),点击文件或文件夹时的js菜单,Site Settings下的链接等,这些菜单和链接为用户提供了便利的功能入口.(当然频繁的点击和跳转也为人诟病,相信在下一个版本中会改善).本系列将试图全方位介绍定制这些菜单和链接的方法.

 第一部分  ToolbarMenu, Library上方的菜单, 如下图

SharePoint Toolbar Menu

定制这些菜单有三种方法,最近跟Edit in Datasheet菜单打交道较多,下面就隐藏某个菜单,修改已有菜单和添加新菜单放入方法详细分析.

方法一: 使用JavaScript. JavaScript在这里的功能比较有限,可以隐藏或者修改菜单的属性.

上图中所有菜单项在HTML源码均有ID,例如Edit inDatasheet的ID通常是*EditInGridButton,根据DOM模型,可以找到相应的菜单对象(ie:menuitem).

js:

var menus = document.getElementsByTagName("ie:menuitem");

for (var i = 0; i < menus.length; i++) {
    item = menus(i)
    if (item.id.match("EditInGirdButton")!=null)
    {

      //在这里填写你的代码, 隐藏或者改变菜单的事件
    }
}

其他的ID还有OpenInExplorer,ExportToSpreadsheet等,可以在%WSS_Install%\12\TEMPLATE\CONTROLTEMPLATES\DefaultTemplates.ascx找到更多.

可以做一个自己的webpart或者用Content Editor Webpart,把最终的JS放进去, 然后最小化隐藏.

方法二: 使用Web User Control (ascx)

刚刚提到DefaultTemplates.ascx,这个文件包含了ToolbarMenu的定义, 我们可以在这个文件基础上添加删除和菜单(还有找到通过这种方法修改某个菜单,SharePoint封装Orz).

拷贝一个DefaultTemplates.ascx的副本, 重命名为CustomTemplates.ascx,SharePoint会自动加载CONTROLTEMPLATES文件夹下的用户控件.

文件里内容SharePoint:RenderingTemplate标签下的SharePoint:FeatureMenuTemplate标识了一个下拉区域,里面包括了多个MenuItemTemplate.

如果要添加或删除菜单项, 把要修改的区域的xml文件放到CustomTemplates.ascx.下面的xml部分只留下了Edit In Datasheet菜单项和一个自己添加的菜单项.

<SharePoint:RenderingTemplate ID="ToolbarActionsMenu" runat="server">
 <Template>
  <SharePoint:FeatureMenuTemplate runat="server"
   FeatureScope="Site"
   Location="Microsoft.SharePoint.StandardMenu"
   GroupId="ActionsMenu"
   UseShortId="true"
   >
   <SharePoint:MenuItemTemplate
    ID="EditInGridButton"
    ImageUrl="/_layouts/images/menudatasheet.gif"
    PermissionsString="UseRemoteAPIs"
    MenuGroupId="200"
    Sequence="200"
    UseShortId="true"
    runat="server"/>   <SharePoint:MenuItemTemplate
    ID="MyMenu" Text="Show My Menu"
    ImageUrl="/_layouts/images/menudatasheet.gif"
    PermissionsString="UseRemoteAPIs"
    MenuGroupId="200"
    Sequence="201"
    UseShortId="true"
    runat="server"/>
  </SharePoint:FeatureMenuTemplate>
 </Template>
</SharePoint:RenderingTemplate>

效果图:

方法三: 使用Feature. 这也是推荐的方法,非常强大,不过不能很直接的修改和隐藏菜单,需要编程.

添加菜单项:

  <CustomAction
      Id="MWZDMS.ShowRefs"
      RegistrationType="FileType"
      RegistrationId="dwg"
      Location="EditControlBlock"
      Sequence="1001"
      ImageUrl="/_layouts/images/icdwg.gif"
      Title="Show References">
    <UrlAction Url="javascript:window.open('/mwzdms/ShowRefs.aspx?DrawingID='+escapeProperly('{ItemUrl}')+window.location.search.substring(window.location.search.indexOf('&amp;View=')), '_blank', 'width=850, height=400')" />
  </CustomAction>

当需要添加Url逻辑复杂或者隐藏,修改已有菜单项, 可通过ControlClass控制:

  <CustomAction Id="MWZBulkEditList"
    ControlAssembly="MWZDMS.SharePoint.ActionMenu, Version=1.0.0.0, Culture=neutral, PublicKeyToken=9f4da00116c38ec5"
    ControlClass="MWZDMS.SharePoint.ActionMenu.BulkEditDrawings"
    GroupId="ActionsMenu"
    Location="Microsoft.SharePoint.StandardMenu"
    Sequence="100"
    ImageUrl="/_layouts/images/menudatasheet.gif"
    Title="Bulk Edit Attributes"
    Description="Edit drawings' attributes inside a MWZ Control">
  </CustomAction>

代码如下:

        protected override void CreateChildControls()
        {
            MenuItemTemplate bulkEditList = new MenuItemTemplate();
            bulkEditList.Text = "Bulk Edit Attributes";
            bulkEditList.Description = "Edit drawings' attributes inside a MWZ Control";
            bulkEditList.ID = "MWZBulkEditList";
            bulkEditList.ImageUrl = "/_layouts/images/menudatasheet.gif";
            string rootFolder = SPContext.Current.List.RootFolder.ServerRelativeUrl;
            string requestUrl = SPContext.Current.Web.ServerRelativeUrl + "/_layouts/mwzdms/bulkedit.aspx?List=" + SPEncode.UrlEncode(SPContext.Current.ListId.ToString("B").ToUpper()) + "&RootFolder=" + SPEncode.UrlEncode(rootFolder) + "&Source=" + SPEncode.UrlEncode(Page.Request.Url.ToString());
            bulkEditList.ClientOnClickScript = "window.location = '" + requestUrl + "';";
            this.Controls.Add(bulkEditList); //添加菜单项
        }

如果想修改或隐藏其他菜单, 可以通过This.Parent.Controls获得其他菜单.

 

============================其他方法=============================

这样,问题就来了,我们需要隐藏掉这个默认的下载菜单,另外提供一个下载菜单转向到我们自己的下载页面。
  那么,如何做到这一点呢?
  通过察看SharePoint生成的HTML代码,我们发现列表的菜单,是一个SharePoint自定义的对象,他甚至都提供了隐藏的属性。
  这样,问题就简单了,找到要隐藏的菜单,将属性设置为Hide. DONE!
  具体代码,请看:
  <script language='javascript'>
  var d_item = document.getElementById('zz20_DownloadPictures');
  if(d_item != null)
  {
  d_item.setAttribute('hidden', 'true');
  }
  </script>
  注:这里面的zz20_DownloadPictures是我的图片库所产生的下载菜单的ID. 可能你的会有所不同。

 

==========================其他方法===============================

hideListViewToolbarItems("Edit in Datasheet", "export to Spreadsheet",  
    "view rss feed","settings:create view");  
 
function hideListViewToolbarItems()  
{          
    var menuItem;     
    var menuItemName;  
    var menuItemIndex=-1;  
    var menuItemNames=new Array("edit in datasheet",   
      "open with windows explorer",  
      "connect to outlook",'export to spreadsheet','view rss feed','alert me' 
      ,"create column","settings:create view","list settings",  
      "document library settings","explorer view","all documents",  
      "all items","modify this view",   
      "view:create view","new document",  
      "new item","new folder","upload document",   
      "upload multiple documents");  
    var menuItems = new Array("EditInGridButton",   
      "OpenInExplorer","OfflineButton",  
      "ExportToSpreadsheet","ViewRSS",  
      "SubscribeButton","AddColumn",  
      "AddView","ListSettings","ListSettings",   
      "View1","DefaultView",  
      "DefaultView","ModifyView","CreateView",   
      "New0","New0",  
      "NewFolder","Upload","MultipleUpload");         
 
    var allMenuItems = document.getElementsByTagName('ie:menuitem');  
    for(var i = 0; i < hideListViewToolbarItems.arguments.length; i++ )   
    {                                 
        menuItemName= hideListViewToolbarItems.arguments[i].toLowerCase();  
        for (j=0; j < menuItemNames.length; j++)   
        {  
            if(menuItemNames[j]==menuItemName)  
            {                 
                menuItemIndex = j;  
                break;  
            }  
        }  
 
        menuItem=menuItems[menuItemIndex];  
                  
        for (var l = 0; l < allMenuItems.length; l++)  
        {         
            if(menuItemName.indexOf(":")!=-1)  
            {  
                menuItemName = menuItemName.split(":")[1];  
            }  
            if (allMenuItems[l].id.indexOf(menuItem)!=-1   
                && allMenuItems[l].text.toLowerCase() == menuItemName)  
            {         
                // For FireFox Compatibility  
                var parentNodeOfMenuItem = allMenuItems[l].parentNode;  
                parentNodeOfMenuItem.removeChild(allMenuItems[l]);  
                break;  
            }  
        }  
    }  

 

JS脚本
hideListViewToolbarItems("Edit in Datasheet", "export to Spreadsheet",  
    "view rss feed","settings:create view");  
 
function hideListViewToolbarItems()  
{          
    var menuItem;     
    var menuItemName;  
    var menuItemIndex=-1;  
    var menuItemNames=new Array("edit in datasheet",   
      "open with windows explorer",  
      "connect to outlook",'export to spreadsheet','view rss feed','alert me' 
      ,"create column","settings:create view","list settings",  
      "document library settings","explorer view","all documents",  
      "all items","modify this view",   
      "view:create view","new document",  
      "new item","new folder","upload document",   
      "upload multiple documents");  
    var menuItems = new Array("EditInGridButton",   
      "OpenInExplorer","OfflineButton",  
      "ExportToSpreadsheet","ViewRSS",  
      "SubscribeButton","AddColumn",  
      "AddView","ListSettings","ListSettings",   
      "View1","DefaultView",  
      "DefaultView","ModifyView","CreateView",   
      "New0","New0",  
      "NewFolder","Upload","MultipleUpload");         
 
    var allMenuItems = document.getElementsByTagName('ie:menuitem');  
    for(var i = 0; i < hideListViewToolbarItems.arguments.length; i++ )   
    {                                 
        menuItemName= hideListViewToolbarItems.arguments[i].toLowerCase();  
        for (j=0; j < menuItemNames.length; j++)   
        {  
            if(menuItemNames[j]==menuItemName)  
            {                 
                menuItemIndex = j;  
                break;  
            }  
        }  
 
        menuItem=menuItems[menuItemIndex];  
                  
        for (var l = 0; l < allMenuItems.length; l++)  
        {         
            if(menuItemName.indexOf(":")!=-1)  
            {  
                menuItemName = menuItemName.split(":")[1];  
            }  
            if (allMenuItems[l].id.indexOf(menuItem)!=-1   
                && allMenuItems[l].text.toLowerCase() == menuItemName)  
            {         
                // For FireFox Compatibility  
                var parentNodeOfMenuItem = allMenuItems[l].parentNode;  
                parentNodeOfMenuItem.removeChild(allMenuItems[l]);  
                break;  
            }  
        }  
    }  

可以将脚本放到Master Page,可以灵活控制,缺点:非常规方式,对JS的要求较高
重载TemplateControl
打开 C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES\DefaultTemplates.ascx文件,SharePoint 在此文件中定义了 控件的模板,在相同目录下新建一个myTemplates.ascx页面,在DefaultTemplates.ascx文件中找到带有alert me的TemplateControl,将其copy到myTemplate.ascx文件、并进行修改(隐藏或删除alert me控件)
可以灵活控制每个部位的alert me菜单,
通过Feature的方式来做,可以灵活控制到每个站点,但工作量较大
通过权限控制实现进入管理中心 -> Application Management 页面,进入web application general settings页面,选择相应的web application,将alert me设为off,进入 user permissions for web application 页面,将 list permission 组中的 [Create Alerts  -  Create e-mail alerts]前面的勾选项去掉、保存。对web application下的所有网站集有效,不可以灵活控制,实现简单