Liferay Configuration and Customization

Liferay Configuration and Customization

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’.



IDE :


Integrate porlet to portal

DEMO


Q & A

Any Questions?


Technology

Liferay Configuration and Customization