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 .
<?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 off
setlocal
pushd .

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....