Config Files

Here I tried to briefly describe all extension configuration files that are merged (and even used) by Liferay.

All configs are merged except ext-orm.xml, thus please don't use JPA for your Service Builder in combination with multiple Ext Plugins, it might not work (but I haven't tried it :) )

---

These are paths inside each Ext Plugin sources:

• docroot/WEB-INF/ext-web/docroot/WEB-INF/tiles-defs-ext.xml - Portal Tiles definition
• docroot/WEB-INF/ext-web/docroot/WEB-INF/struts-config-ext.xml - Portal Struts definition
• docroot/WEB-INF/ext-web/docroot/WEB-INF/portlet-ext.xml - JSR (168) 286 portlets in portal
• docroot/WEB-INF/ext-web/docroot/WEB-INF/liferay-portlet-ext.xml - Liferay's custom descriptor (liferay-portlet.xml)
• docroot/WEB-INF/ext-web/docroot/WEB-INF/liferay-display-ext.xml - Liferay's custom descriptor (liferay-display.xml)
• docroot/WEB-INF/ext-web/docroot/WEB-INF/liferay-look-and-feel-ext.xml - Liferay's custom descriptor for portal's default Themes
• docroot/WEB-INF/ext-web/docroot/WEB-INF/liferay-layout-templates-ext.xml - Definition of default Layout Templates
• docroot/WEB-INF/ext-web/docroot/WEB-INF/web.xml - Changes to Liferay's default web.xml
• docroot/WEB-INF/ext-impl/src/META-INF/portal-log4j-ext.xml - Changing default portal's log levels
• docroot/WEB-INF/ext-impl/src/content/Language-ext_*.properties - Custom language messages
• docroot/WEB-INF/ext-impl/src/portal-ext.properties - Changes to portal.properties

Service Builder generated configs:

• docroot/WEB-INF/ext-impl/src/META-INF/ext-model-hints.xml - Definition of model hints for Service Builder entities
• docroot/WEB-INF/ext-impl/src/META-INF/ext-spring.xml - Spring definitions
• docroot/WEB-INF/ext-impl/src/META-INF/ext-hbm.xml - Hibernate mapping definitions
• docroot/WEB-INF/ext-web/docroot/html/js/liferay/service.js - Exposing services for JavaScript
• docroot/WEB-INF/ext-web/docroot/WEB-INF/remoting-servlet-ext.xml - Spring remoting services

ext-orm for JPA cannot be merged:

• docroot/WEB-INF/ext-impl/src/META-INF/META-INF/ext-orm.xml - I don't know how to do it - anyone is welcome to help me :)

Special merging of portal-ext.properties inside Ext Plugin

Specifying key=value overwrites default mapping from portal.properties. This is default behaviour, which means:

In portal.properties is specified:

auto.deploy.geronimo.dest.dir=${org.apache.geronimo.home.dir}/deploy

If you specify in your portal-ext.properties:

auto.deploy.geronimo.dest.dir=myValue

Result will be:

auto.deploy.geronimo.dest.dir=myValue

Specifying key+=value appends value to default mapping from portal.properties (and other Ext Plugins). This means:

In portal.properties is specified:

auto.deploy.geronimo.dest.dir=${org.apache.geronimo.home.dir}/deploy

If you specify in your portal-ext.properties:

auto.deploy.geronimo.dest.dir+=myValue

Result will be:

auto.deploy.geronimo.dest.dir=${org.apache.geronimo.home.dir}/deploy,myValue