liferay ga6主题工程研究随笔

Liferay主题

注意：我使用的liferay ga6环境，主题工程创建时的配置选项为

一、在liferay主题（Theme）的编写中，如果要在portal_normal.vm中导入js或css包（例如jQuery包），可以使用以下两种方法：

1、<script type="text/javascript" src="${javascript_folder}/jquery-1.9.0.js"></script>

2、<script type="text/javascript" src="$themeDisplay.getPathThemeJavaScript()/jquery-1.9.0.js"></script>

它们的路径相当于http://localhost:8080/test-theme/js

类似的还有$themeDisplay.getPathThemeImages()

其实最好的是在liferay编辑器中使用【Ctrl】+【Shift】+【R】，然后搜索init.vm

二、$themeDisplay.getLanguageId() 获取语言类型

这个语言类型指的是门户网站cookie中，名为GUEST_LANGUAGE_ID的值，例如简体中文为zh_CN，美国英语为en_US

三、在主题中自定义变量

1、在主题工程WEB-INF下liferay-look-and-feel.xml文件中设置

在主题工程的liferay-look-and-feel.xml文件中找到你要修改的项目，在<theme>中加入以下内容

<settings>

   <setting configurable='true' key='portlet-setup-show-borders-default' type='checkbox' value='false'>

   </setting>

</settings>

上面这个实例是liferay自带的，作用是是否显示liferay页面中portlet的边框

你也可以使用自定义的，如下：

<settings>

    <setting configurable='true' key='portlet-setup-show-borders-default' type='checkbox' value='false'>

    </setting>

    <setting configurable='true' key='isDisplay' type='text' value='false'>

    </setting>

</settings>

第一个用的是复选框，第二个用的是文本框

2、将你在liferay-look-and-feel.xml中配置的值在主题或portlet中引用

在主题中引用：

在portal_normal.vm中通过$themeDisplay.getThemeSetting('isDisplay')可以获取管理员在页面中选取或输入的值，

eg.     #if($themeDisplay.getThemeSetting('isDisplay') == 'false')

       <style>

          .aui .dockbar-split .dockbar.navbar-static-top .collapse .nav-account-controls{display:none;}

       </style>

    #else

       <style>

          .aui .dockbar-split .dockbar.navbar-static-top .collapse .nav-account-controls{display:block;}

       </style>

    #end

上面的示例首先获取管理员输入的值，然后设置主题样式，从而控制liferay页面右上角的蓝色操作条是否显示。

四、主题中使用自己定义的类的方法

1、在portal_normal.vm的某一个位置，最好是文件的开头添加下面的语句

#set($bookService=$serviceLocator.findService("xxx-portlet(这里的值为portlet名)","com.xyong.portlet.demo.service

.BookLocalService(这里的值为该portlet的接口)"))

2、在你想使用导入类某一方法处，使用 $bookService.getBooks('')    //这里为具体方法名

注意：若是自己定义的portlet，则需要第一个参数（portlet名）；若为liferay自带的，则不需要第一个参数（portlet名）

五、主题中显示用户信息

liferay数据库中，自带有欢迎xxx之类的信息，可以直接取用，而不需要自己编写，具体的在init.vm中，那都是liferay定义

好了的变量。

六、在主题中嵌入liferay自带的portlet

比如想在liferay主题中嵌入liferay自带的语言选择portlet。

1、你需要获取该portlet的ID，例如语言选择组件的id为p_p_id_82_ ，导航组件的id为p_p_id_71_INSTANCE_KNHYDs33J9DI_

2、在主题你通过 $theme.runtime("82") 可以引用你想引用的liferay自带portlet，参数的值为组件id的编号。

$theme.runtime("82")引用的是语言选择组件，$theme.runtime("71")引用的是导航组件。