日出门户基盘开发参考手册.docxVIP

上海日出科技门户基盘开发参考手册注：该文档还处于完善阶段，各位可依据自己的见地和成果及时修改。修改需注明作者、日期及内容索引。上海日出科技有限公司二〇一一年十二月概述根据企业门户要求及中国移动BOMC技术规范，上海日出科技在LIFERAY PORTAL基础上进行二次开发，在涵盖主题、布局、权限管理、第三方系统载入等具有移动行业特性的用户要求进行功能定制、优化和补充。以逐步形成自有风格及功能的日出科技企业门户框架。日出科技企业门户基于Liferay Portal Standard Edition 5.2.3。主题与布局 主题开发开发目录一览在EXT开发环境之下开发自定义的主题，首先需要新建自定义主题的目录结构。页面目录位于$PROJECT_HOME\ext\ext-web\docroot\html\themes（目录不存在则新建），在此目录下新建如图表1中所示的【主题目录结构】。新建好主题目录结构后，还需要配置主题配置文件：$PROJECT_HOME \ext\ext-web\docroot\WEB-INF\liferay-look-and-feel-ext.xml（文件不存在则新建），如图表1所示的【主题配置文件】。图表1自定义主题目录结构（注：图表1中zm-theme为自定义主题名称，名称须符合JAVA语言开发规范并根据实际情况做出修改。其他目录名称及文件名称不可修改。）新建完成自定义主题目录结构后，需要核对每个目录下面的文件。这些文件可以从LIFERAY源码中拷贝（位于..\portal-web\docroot\html\themes\_unstyled之下），或是向项目组索要。主题开发基于Apache的开源布局框架Velocity。在门户主题应用中，这些文件在templates目录之下。dock.vm 门户控制面板文件init_custom.vm 自定义VM变量文件navigation.vm 导航栏文件portal_normal.vm 主页面文件portal_pop_up.vm 弹出页面文件portlet.vm Portlet容器文件开发步骤portal_normal.vm开发示例：!DOCTYPE html PUBLIC -//W3C//DTD XHTML 1.0 Transitional//EN…html dir=#language (lang.dir) xmlns=/1999/xhtmlheadtitle$the_title - $company_name/title/headbody class=$css_classdiv id=wrapperdiv id=banner#parse ($full_templates_path/dock.vm)/div#if ($has_navigation)#parse ($full_templates_path/navigation.vm)#end#if ($selectable)$theme.include($content_include)#else$portletDisplay.recycle()$portletDisplay.setTitle($the_title)$theme.wrapPortlet(portlet.vm, $content_include)#enddiv id=footer/div/div/body/html以上示例中，通过parse方法实现页面分割：控制面板部分、导航栏部分、Portlet页面部分。navigation.vm开发示例：div id=navigation class=sorts modifysul#foreach ($nav_item in $nav_items)li class=$nav_item_classa href=$nav_item.getURL()span$nav_item.getName()/span/a#if ($nav_item.hasChildren())ul class=child-menu#foreach ($nav_child in $nav_item.getChildren())li class=$nav_child_classa href=$nav_child.getURL()$nav_child.getName()/a/li#end/ul#end/li#end/ul/div以上示例中，通过foreach方法列出导航菜单。dock.vm开发示例：div class=lfr-dock interactive-modeh2 class=user-greetingspan$user_greeting/span/h2ul class=lfr-dock-list#if ($show_control_panel)li