To create a new ATG Portal application, you need to modify the following portal application template files in your <ATG11dir>/MyPortal
directory:
META-INF/MANIFEST.MF
Edit this file to contain only the following. List any gears you intend to use for your portal in the ATG-Required
entry, or use Portal.gears
to include every gear.
Manifest-Version: 1.0 ATG-Config-Path: config/ ATG-Required: Portal.paf <place the module names of any required gears here>
config/atg/portal/framework/Portal.properties
This file should only contain the following. It overrides the default context path of your portal, setting the context path to /myportal
. This will be the context path all requests for your portal will contain. So to access a community named theatre
in your portal, a user would request:
http://
hostname:port/
myportal/theatre
where hostname
is the name of the machine that runs your application server, port
is the port number that application server uses to listen for HTTP requests, and myportal
is your portal name. For default port information, see the Platform Installation and Configuration Guide.
# The context path of this portal contextPath=/myportal
myportal/META-INF/application.xml
Use the following for this file. Once again you need to redefine the context root to /myportal
:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE application PUBLIC "-//Sun Microsystems, Inc.//DTD J2EE Application 1. 3//EN" "http://java.sun.com/dtd/application_1_3.dtd"> <application> <display-name>My Portal Application Framework</display-name> <description>Description of MyPortal goes here</description> <module> <web> <web-uri>portal</web-uri> <context-root>/myportal</context-root> </web> </module> </application>
myportal/portal/WEB-INF/weblogic.xml (WebLogic only)
Use the following for this file. Once again you need to redefine the context root to /myportal
.
<!DOCTYPE weblogic-web-app PUBLIC "-//BEA Systems, Inc.//DTD Web Application 7.0 //EN" "http://www.bea.com/servers/wls700/dtd/weblogic700-web-jar.dtd"> <weblogic-web-app> <context-root>/myportal</context-root> </weblogic-web-app>
myportal/portal/WEB-INF/web.xml
In this file, you need to replace all references to the context path /portal
with /myportal
. Change /portal
to /myportal
in the following locations:
<context-param> <param-name>context-root</param-name> <param-value>/myportal</param-value> </context-param> <init-param> <param-name>defaultLoginTemplateContextURI</param-name> <param-value>/myportal</param-value> </init-param> <init-param> <param-name>defaultAccessDeniedTemplateContextURI</param-name> <param-value>/myportal</param-value> </init-param> <init-param> <param-name>defaultOfflineTemplateContextURI</param-name> <param-value>/myportal</param-value> </init-param>
You should also update the display name and description. For example:
<display-name>My Default Portal Application</display-name> <description> My Default Portal Application may be used as a template for creating new portal applications. </description>