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

日出科技门户基盘开发参考手册上海日出科技门户基盘开发参考手册注：该文档还处于完善阶段，各位可依据自己的见地和成果及时修改。修改需注明作者、日期及内容索引。上海日出科技有限公司二一一年十二月1. 概述根据企业门户要求及中国移动BOMC技术规范，上海日出科技在LIFERAY PORTAL基础上进行二次开发，在涵盖主题、布局、权限管理、第三方系统载入等具有移动行业特性的用户要求进行功能定制、优化和补充。以逐步形成自有风格及功能的日出科技企业门户框架。 日出科技企业门户基于Liferay Portal Standard Edition 5.2.3 。2. 主题与布局2.1 主题开发2.1.1 开发目录一览 在EXT开发环境之下开发自定义的主题，首先需要新建自定义主题的目录结构。页面目录位于$PROJECT_HOMEextext-webdocroothtmlthemes（目录不存在则新建），在此目录下新建如图表1中所示的【主题目录结构】。新建好主题目录结构后，还需要配置主题配置文件：$PROJECT_HOME extext-webdocrootWEB-INFliferay-look-and-feel-ext.xml（文件不存在则新建），如图表1所示的【主题配置文件】。图表 1 自定义主题目录结构（注：图表1中zm-theme为自定义主题名称，名称须符合JAVA语言开发规范并根据实际情况做出修改。其他目录名称及文件名称不可修改。） 新建完成自定义主题目录结构后，需要核对每个目录下面的文件。这些文件可以从LIFERAY源码中拷贝（位于.portal-webdocroothtmlthemes_unstyled之下），或是向项目组索要。主题开发基于Apache的开源布局框架Velocity。在门户主题应用中，这些文件在templates目录之下。 dock.vm 门户控制面板文件 init_custom.vm 自定义VM变量文件 navigation.vm 导航栏文件 portal_normal.vm 主页面文件 portal_pop_up.vm 弹出页面文件 portlet.vm Portlet容器文件2.1.2 开发步骤（1） portal_normal.vm开发示例：$the_title - $company_name#parse ($full_templates_path/dock.vm)#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)#end以上示例中，通过parse方法实现页面分割：控制面板部分、导航栏部分、Portlet页面部分。 （2） navigation.vm开发示例： #foreach ($nav_item in $nav_items) $nav_item.getName() #if ($nav_item.hasChildren() #foreach ($nav_child in $nav_item.getChildren() $nav_child.getName() #end #end #end 以上示例中，通过foreach方法列出导航菜单。（3） dock.vm开发示例：$user_greeting#if ($show_control_panel)$control_panel_text#end#if ($show_my_account)$my_account_text#end以上示例中，列举了在控制栏中显示的相关控制页面，并设定条件。（4） portlet.vm开发N/A（5） init_custom.vm示例：#set ($language_id = $user.getLanguageId()以上示例中，定义了在此主题中所有VM均可取得的变量，并设定其值。（6） portal_pop_up.vm开发N/A（7） 主题配置文件开发示例：5.2.3/html/themes/zm-theme/html/theme