6. /ext/ext-web

6. /ext/ext-web
Prev	Chapter 3. Usage	Next

This directory will contain your JSPs, HTMLs, images and all the web application related files inside the docroot subdirectory. Here are some of the most common activities you'll be performing from this directory:

Run ant deploy
If /ext/ext-web/tmp does not exist, the script will unjar /ext/ext-ear/modules/portal-web.war into /ext/ext-web/tmp. The script will then copy everything from /ext/ext-web/docroot over to /ext/ext-web/tmp and then copy everything from /ext/ext-web/tmp to the deployment directory of your specified application server. Do not manipulate the contents of /ext/ext-web/tmp manually.
This provides an easy way to extend the portal without changing the source and makes upgrading very easy.
To add entries to the web application configuration file edit /ext/ext-web/docroot/WEB-INF/web.xml. Be aware that this file will be merged with /ext/ext-web/tmp/WEB-INF/web.xml and /ext/web-sites/liferay.com-web/docroot/WEB-INF/web.xml. The files web-ejb-ref.xml and web-ejb-local-ref.xml are also merged in. They will only be used if you use Liferay Service Builder to create your portlets.
To add a portlet, edit /ext/ext-web/docroot/WEB-INF/portlet-ext.xml, /ext/ext-web/docroot/WEB-INF/liferay-portlet-ext.xml, /ext/ext-web/docroot/WEB-INF/liferay-display.xml and /ext/ext-ejb/classes/content/Language-ext.properties. These *-ext.xml files are read after their parent files are read and override their parent values.
See the portlet examples for information on general portlet design.
If you are using StrutsPortlet to develop your portlets the following files will also be of interest to you:
- /ext/ext-web/docroot/WEB-INF/struts-config.xml: add your custom mappings to it. Be aware that when deployed its name changes to struts-config-ext.xml.
- /ext/ext-web/docroot/WEB-INF/tiles-defs.xml: add your custom tiles definitions to it. Be aware that when deployed its name changes to tiles-defs-ext.xml.

	Note
	It is strongly suggested that you place all you JSPs and accompanying files inside the subdirectory `/ext/ext-web/docroot/html`. This directory will be assumed to exist in certain operations, for example when forwarding to a JSP referenced from `struts-config.xml` or `tiles-defs.xml`.

	Tip
	It is possible to override the JSPs that ship with Liferay Portal by placing them in `/ext/ext-web/docroot/html` and keeping the exact same path than the original version. When running ant deploy these files will be copied to `/ext/ext-web/tmp` and will override the original ones. Be aware that you'll have to review any changed JSPs when you upgrade to a new version of Liferay Portal.

Prev	Up	Next
5. /ext/ext-lib	Home	7. /ext/lib