IBM Portal 7主题开发入门-PageBuilder2

1.1 简介

IBM WebShere Portal 7相对于之前版本最大的变化就增加了新的皮肤开发模式-PageBuilder2,官方翻译叫"页面构建器"。它同时支持旧的主题开发模式。新模式主要的改变就是将样式与页面布局分开了,同样页面布局可以应用不同的样式,就像WinXP的桌面主题,因此也带来了复杂性。

 

1.2 类型 

PageBuilder2主题开发模式分为两种:

第一种: 样式+war包式。

第二种: 独立war包式。

其中第一种的war包是非必须的,如果不想改变缺省的面布局及内容,你只需修改样式并共享产品自带的war包即可。

 

1.3 步骤

下面分别详细介绍一下。

我的wp7是装在windows2003上的。

 

1.3.1 样式+共享war包式

开始之前需要准备一款WebDAV客户端工具(WebDAV我就不赘述了,搜狗(^0^)一下),我选择的是一个免费的由Java开发的工具“AnyClient”(见附件)。AnyClient需要jre,最低1.5,最高1.6(1.4可打开,但运行异常)。

 

1)使用AnyClient连接Portal的WevDAV目录。

连接地址为 http://localhost:10039/wps/mycontenthandler/dav/themelist/

 注意

wps为上下文根,缺省名字为wps,如果你已经改变了文根,请将wps替换为你自定义的文根。

 提示:

用户名与密码就是Portal was控制台的管理员和密码。如果你在Win7下使用Anyclient,请将窗口主题切换为“windows经典”,否则AnyClient窗口将会是一个大白板。

连接WebDAV时可能会很慢,要耐心等...!

   

2)拷贝themelist/目录下的csa2.theme目录到本地。

 

3)修改下载的csa2.theme文件夹为你喜欢的名字,如:my_theme。

 

4)修改\metadata\localized_zh.properties文件内的title属性。

写个你喜欢的名字吧,最好是英文的(不能直接写中文,需要编码,非必须就别给自己找麻烦了^_^) 。

 

5) 将你修改好的主题文件夹利用AnyClient传输到themelist/文件下。

 

6)传输完成后,你就已经有一个新的主题可选了。

提示:

很显然,你在主体管理工具那是看不到新的主题的,这时你需要任意选择一个主题,点击编辑,然后再点一下保存,这样会强制wp刷新主题列表缓存,你新建的主题就出来了。

总结:

这种方式创建的新主题与wp7自带的主体样式是一样的(复制的嘛),并且共享Jsp页面文件。也就是你只能修改样式。说实话,我感觉真挺不好改的,主题里全是css与js,不知从何改起,我是没再深研究。

 

1.3.2 样式+独享war包式

如果想修改页面的布局与内容,你需要使用自己的主题war包。方法还是一样:复制并改名在传回去。

1)复制PageBuilder2 war包并改个名字。

路径为:wp7安装目录+\IBM\WebSphere\PortalServer\theme\wp.mashup.cc.theme\ installedApps\wp.mashup.cc.theme.ear\PageBuilder2.war

 

2)删除 ./skins 目录下的所有文件。

 

3)修改./themes/html/目录下的PageBuilder2文件夹的名字,如:my_pb2,以下都用my_pb2代表你喜欢的名字。

 

4)在WEB-INF文件夹里删除plugin.xml文件,别的文件不用删。

 

5)修改web.xml里的display-name属性为my_pb2。

 

6)修改ibm-web-bnd.xmi 与 ibm-web-ext.xmi 文件。

ibm-web-bnd.xmi修改位置为:<webapp href="WEB-INF/web.xml#my_pb2"/>

ibm-web-ext.xmi修改位置为:<webApp href="WEB-INF/web.xml#my_pb2"/>

 

7)将修改完的文件打成war包,部署到wp7的was控制台。

注意:

发布时,进行到映射服务器那步时,一定要选择WebSphere_Porta,系统自动选择的那个是错误的。

记住你在部署时输入上下文根路径如:my_pb2。

 

8)测试新部署的主题war包。

访问: http://localhost:10039/wps/my_pb2/dav/themelist/customTheme/

如果页面报500错误,证明你已经部署成功了。因为它缺少Portal环境,所以报错。

 

9)利用xmlaccess 导出主题部署信息。

xmlaccess在中文版中叫“导入xml”,菜单位置在portal后台管理左树-〉门户网站设置-〉导入xml。

将以下xml内容保存为一个文件,使用xmlaccess导入portal。

<?xml version="1.0" encoding="UTF-8"?> <request xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="PortalConfig_7.0.0.xsd" type="export" create-oids="true"> <portal action="locate"> <theme action="export" objectid="*" /> </portal> </request>

 

 

 

 

10)导入成功后,你会得到返回的xml字符串,保存为本地文件并修改其中的内容。

修改其中的 context root, resource root, uniquename与为“my_pb2”如:

<theme action="update" active="false" context-root="/my_pb2" default="false" domain="rel" objectid="ZJ_618LOIP300NI60IE2H5GHD3001" resourceroot="my_pb2" uniquename="my_pb2">

 

 

 

 

11)将修改完的文件利用xmlaccess导入回去。

 

12)修改样式包里的 theme.html 文件。

利用用AnyClient下载到本地修改在传回覆盖原文件。

样式包就是在1.3.1中我们自己创建的那个样式文件夹(my_theme)。

还是要修改上下文根为“my_pb2”如:

替换以下内容:

<link rel="dynamic-content" href="dyn-cs:id:head@tl:oid:csa2.theme">

 

 为:

<link rel="dynamic-content" href=" res:/my_pb2/themes/html/my_pb2/head.jsp">

 

 同样的,在theme.html中查找包含“rel="dynamic-content" ”的标签,根据 href属性中位于“id:”与"@"符号之间的内容,替换href属性内容:

<a rel="dynamic-content" href="dyn-cs:id:bannerNav@tl:oid:csa2.theme">

 

 

 

 

 根据红色字体,替换href属性:

<a rel="dynamic-content" href="res:/my_pb2/themes/html/my_pb2/bannerNav.jsp">

 

 

 

需要替换的所有jsp页面列表如下:

res:/customTheme/themes/html/customTheme/bannerNav.jsp

res:/customTheme/themes/html/customTheme/search.jsp
res:/customTheme/themes/html/customTheme/bannerCommonActions.jsp
res:/customTheme/themes/html/customTheme/status.jsp
res:/customTheme/themes/html/customTheme/tabNav.jsp
res:/customTheme/themes/html/customTheme/pageToolbar.jsp
res:/customTheme/themes/html/customTheme/asa.jsp
res:/customTheme/themes/html/customTheme/config.jsp
 
注意:

在/nls文件夹下还有一个theme_zh.html文件,也需要按照以上步骤修改。

 

总结:

完工了,现在就可以在主题管理里面使用新的皮肤了,显然它和缺省皮肤一样。如果只需要改样式,则修改样式文件,然后用WebDAV工具上传更新;如果要改变页面格局及内容,则需要修改样式war包中的jsp。

 

1.3.3 独立war包式

抱歉没有亲自实践,不敢乱写,请参考下面列出的文档吧,

《Consolidated Steps for Creating Custom Themes in WP7 》里面有简单的介绍。

 

2 参考文档

Creating a new PageBuilder2 custom theme: wp7

How to deploy a theme as a custom war into WebSphere Application server console

Consolidated Steps for Creating Custom Themes in WP7


后记:

这篇文章大都是翻译而来,其中添加了我遇到的一些问题及解决方法。次篇只是抛砖引玉,入门而已。再多讨论请查阅IBM的信息中心:

http://www-10.lotus.com/ldd/portalwiki.nsf/xpViewCategories.xsp?lookupName=WebSphere%20Portal%20and%20Lotus%20Web%20Content%20Management%20Version%207.0%20documentation

 

欢迎转载,请注明出处,谢谢!

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值