Liferay Configuration and Customization

transcript

April 10 2013Nguyen Trung Thanh

1DIRECTV Proprietary

Agenda

IntroductionConfiguration OptionsCustomizing Liferay with pluginsDeployment of pluginsDemoQ & A

DIRECTV Proprietary 2

Configuration OptionsCombination of setting

Stored in databaseStored in properties files.Stored in xml files

Liferay ‘s CustomizationOverride properties of its configuration files Plugin managementLiferay SOA

Override configurationDefault configuration

portal.properties,system.propertiesOveridden configuration: portal-ext.properites, system-ext.propertiesLanguage_xxx.properties

Overridden configurationportal-ext.properties,

System-ext.properties Location

Main ( default ) configuration: resides inside the portal-impl.jar file. This .jar file is in Liferay Portal's WEB-INF/lib Extention (overridden) configuration:Liferay Portal's WEB-INF/classes

Liferay Specific DescriptorsExtended Portlet Definition

Provides the ability to use Liferay specific features and the second one permits the configuration of the UI that will allow users to select the portlets.(liferay-portlet.xml )

Organizing Portlets in CategoriesThe interface provided to a user to select a portlet to be added to a page shows the portlets organized in categories to make it easier to find them ( liferay-display.xml )

LocationLocated in Liferay Portal's WEB-INF folder

Liferay Specific DescriptorsCustomize Control Panel

Put portlets anywhere, whether or not a portlet shows up inside of the Control Panel epends on whether or not you've set the following nodes in your liferay-portlet.xml<portlet>

<portlet-name>125</portlet-name> …. <control-panel-entry-category>portal</control-panel-entry-category>

<control-panel-entry-weight>1.0</control-panel-entry-weight> <control-panel-entry-class>

com.liferay.portlet.enterpriseadmin.UsersControlPanelEntry </control-panel-entry-class> ... </portlet>

Liferay Specific DescriptorsCustomize Control Panel

control-panel-entry-category: The 'category' where your portlet will appear. There are currently 4 valid values for this element: 'my', 'content', 'portal', and 'server'.control-panel-entry-weight: Determines the relative ordering for your portlet within a given category. The higher the number, the lower in the list your portlet will appear within that category.control-panel-entry-class: The name of a class that implements the ControlPanelEntry interface which determines who can see the portlet in the control panel via an isVisible method.

Customizing Liferay with plugins

Liferay support 5 types of deployable plugins PortletThemesLayout templateHookWeb

All packaged as WAR packages with specific configuration files

Deployment of plugins

Deploying Liferay plugins with Maven Quick introduction to MavenLiferay Maven supportCreate Maven Project for Liferay PortletHot Deploy porlet to LiferayDemo

Quick introduction to Maven

Project management tool ( build, test, report ,assemble,release )Small core expandable with pluginsConvention over configurationDependency managementCommon lifecycle

Liferay Maven support

Liferay ArchetypesGroupId: com.maven.liferay.archetyesArtifactId:

liferay-ext-archetypeliferay-hook-archetypeliferay-layouttpl-archetypeliferay-portlet-archetypeliferay-servicebuilder-archetypeliferay-theme-archetypeliferay-web-archetype

Create Maven Project for Liferay Portlet

Two ways : Command lineIDE

Step by step :Create archetypeBuild and packageDeploy

Create archetype for project

Command line Create root folder for project with pom files

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.liferay.sample</groupId><artifactId>sample-project</artifactId><version>1.0-SNAPSHOT</version><packaging>pom</packaging><name>sample-project</name><url>http://www.liferay.com</url><properties><liferay.auto.deploy.dir>C:/liferay-portal-6.1.1-ce-ga2/deploy</liferay.auto.deploy.dir><liferay.version>6.1.1</liferay.version></properties></project>

Create archetype for project

Command lineAt root folder . Run : mvn generate:archetypeResult Console:

Choose archetype:1: local -> liferay-portlet-archetype (Liferay portlet archetype)2: local -> liferay-theme-archetype (Liferay theme archetype)3: internal -> appfuse-basic-jsf (AppFuse archetype for creating a web application with Hibernate, Spring and JSF)4: internal -> appfuse-basic-spring (AppFuse archetype for creating a web application with Hibernate, Spring and Spring MVC)...Choose a number: (1/2/3/4/...) :1

Type number to choose liferay-portlet-archetype

Then provide groupId, artifactId, package, version

IDE ( SpringToolSuite )

Build and pakage

Go to project directory Run “mvn package”. War file is created at C:\workspace-liferay\sample-portlet\target\sample-portlet-0.0.1-SNAPSHOT.war.

Deployment

Command lineGo to project directory Run “mvn liferay:deploy”. War file is created at C:\workspace-liferay\sample-portlet\target\sample-portlet-0.0.1-SNAPSHOT.war.

Command line : Go to project directory Run “mvn liferay:deploy”. porlet is hot deployed on Liferay portal

IDE :Start up tomcat bundled with Liferay and login in as admin. Click on ‘Add’ then ‘More…’ then ‘Install More Applications’.

Integrate porlet to portal

Any Questions?

Liferay Configuration and Customization

Technology