MOSS 2007入门(5) : 使用Feature定义站点中的菜单项
前面的文章提到了:Everything is feature.今天就来讲讲feature的使用.在MOSS 2007中feature功能之强大超乎想象，可以说对一个已有的网站功能性的增强最后多数都要通过feature来实现.例如添加webpart,实现Event Handler等等...今天就做一个使用feature定义网站中的菜单项的Demo.
Step(1):在网站中创建一个页面,存放于一个文档库中,这里我创建的页面在文档库SiteCollectionDocuments下testpage.aspx,那么这个页面的引用路径就是<%siteurl%>/SiteCollectionDocuments/testpage.aspx .
Step(2):在12\TEMPLATE\FEATURES文件架下新建一个文件夹叫LinkToPage,在文件夹下创建Feature.xml.内容如下.
<?
xml version="1.0" encoding="utf-8"
?>
<
Feature
Id
="C86A92EA-A5D3-4d65-855C-0557AE5D065A"
Title
="Link To Page"
Description
="This example show how to create a menu linke to a customize page!"
Version
="1.0.0.0"
Scope
="Site"
AlwaysForceInstall
="TRUE"
xmlns
="http://schemas.microsoft.com/sharepoint/"
>
<
ElementManifests
>
<
ElementManifest
Location
="LinkToPage.xml"
/>
</
ElementManifests
>
</
Feature
>
Feature元素的几个属性说明一下:
Id:这里要使用vs的guid工具生成一个guid,copy过来就可以
Title 和 Description分别是Feature的标题和描述.
Scope这个属性比较重要:是一个枚举值,是用来描述这个feature的作用范围.这里选择:site
AlwaysForceInstall:这个属性设置为true 可以在重复安装这个feature中自动覆盖原来安装的那个相同的feature.
ElementManifest的location属性制定一个描述feature内容的xml文件,这里叫做LinkToPage.xml
Step(3):建立上一步中的LinkToPage.xml,内容如下.
<?
xml version="1.0" encoding="utf-8"
?>
<
Elements
xmlns
="http://schemas.microsoft.com/sharepoint/"
>
<
CustomAction
Id
="LinkToPageInactionsMenu"
RegistrationType
="List"
RegistrationId
="101"
GroupId
="ActionsMenu"
Location
="Microsoft.SharePoint.StandardMenu"
Sequence
="1000"
Title
="Link To Page"
Description
="This is action menu"
>
<
UrlAction
Url
="~sitecollection/SiteCollectionDocuments/testpage.aspx"
/>
</
CustomAction
>
<
CustomAction
Id
="LinkToPage"
RegistrationType
="List"
RegistrationId
="101"
GroupId
="NewMenu"
Location
="Microsoft.SharePoint.StandardMenu"
Sequence
="1000"
Title
="Link To Page"
Description
="This is new menu!"
>
<
UrlAction
Url
="~sitecollection/SiteCollectionDocuments/testpage.aspx"
/>
</
CustomAction
>
</
Elements
>
这个xml文件中可以多个CustomAction来描述feature的实际内容,这里采用了两个。
Location和groupid两个属性分别指定该feature是定义了哪两个菜单.
Sequence属性指定新增加的菜单项在这个菜单中的排序，设置的大一点该菜单项排列就靠后.
Title 和 Description分别是该菜单项的标题和描述.
UrlAction属性指定了该菜单项的连接到的页面,当然了,这个demo连接到的是我们在第一步中建立那个页面.这里有一个相对路径的问题,~site 表示站点的主目录, ~sitecollection 表示站点集的主目录.因为我的demo是做在一个站点集下面的,所以采用~sitecollection后面是连接文件的相对路径..
Step(4):下面就是将这个feature部署到站点,因为可能会经常使用到部署feature这样的功能,那么我们写一个通用的bat文件来实现feature的部署,内容如下.
@rem
======================================================================
@rem@rem setupfeature.bat@rem@rem
======================================================================
@echo offsetlocalpushd .goto InstallFeature@rem----------------------------------------------------------------------@rem InstallFeature@rem----------------------------------------------------------------------:InstallFeature set SPAdminTool
=
%CommonProgramFiles%\Microsoft Shared\web server extensions\
12
\BIN\stsadm.exe set TargetUrl
=
http://mymoss:
8001
set FeaturePath
=
LinkToPage\Feature.xml echo InstallFeature %FeaturePath% 
"
%SPAdminTool%
"
-o installfeature -filename %FeaturePath% echo Activating feature %FeaturePath%
"
%SPAdminTool%
"
-o activatefeature -filename %FeaturePath% -url %TargetUrl% echo iisreset iisreset
其中每次只要更改TargetUrl和FeaturePath就可以了,是不是方便了很多.
实际上看这个文件中的内容就知道,通过stsadm命令的-o instanllfeature安装这个feature,然后通过stsadm命令的-o activatefeature激活这个feature,然后iisreset一下.将这个bat文件放在12\TEMPLATE\FEATURES,双击执行就可以.
Step(5):进入站点新建一个文档库，看看文档库的菜单中是不是多出了两项?
到网站设置的网站集功能中看看,是不是有一个Link to Page的feature已经被激活.
Step(6): 通过列表的菜单我们可以链接到刚刚所建立的新页面，但是怎么能通过这个链接传递数据呢?也就是说可以在testpage.aspx中获取列表的Id. ok,将UrlAction更改为<UrlAction Url="~sitecollection/SiteCollectionDocuments/testpage.aspx?listid={ListId}"/> , 保存文件之后重新运行installfeature.bat，新建一个列表，重新使用该功能定位到testpage.aspx，看看是不是能在querystring中获得列表的guid了.
ok,以上就是使用feature来Feature定义站点中的菜单项的DEMO.
Enjoy it....