Oracle JHeadstart Developer's Guide - Downloads - Oracle

The content in the header, footer, leftSide, and rightSide areas is defined in ADF Faces
regions by the same name, to prevent the actual content of these areas from being
duplicated in each and every page.
Reference: You can download this example. See the JHeadstart Blog post
‘Generating a Custom Look and Feel using JHeadstart’ at
http://blogs.oracle.com/jheadstart/2006/12/22 - a122.
5.9.3. Creating Custom ADF Faces Regions and using them in Generator Templates
In ADF Faces 10.1.3, Regions are snippets of ADF Faces source code that are stored in
separate files, and can be reused in several ADF Faces pages. JHeadstart uses these ADF
Faces Regions for the application branding, the menu sections, and for example the form
browse buttons (arrow buttons to navigate to the previous or next record in form layout).
In general, you have to perform the following steps to customize an ADF Faces Region, if
you want to make a copy of the original region:
1. Create custom ADF Faces Region file
2. Declare the new Region in region-metadata.xml
3. Create customized version of Generator Template file that references the region,
in which you refer to the new Region
4. Refer to customized Generator Template in Application Definition
These steps are detailed below for customizing the application logo(s). As explained in
section 5.9.1 Customizing the Application Logos, it is not necessary to use this technique
for the logos because JHeadstart does not overwrite the relevant region files, but it is
useful to use this example for explaining the steps.
5.9.3.1. Creating a Custom Region
The JHeadstart logo's are referenced in the ADF Faces Region files
common\regions\branding.jspx and common\regions\brandingAppContextual.jspx.
As the golden rule is that you should not change files that were created by JHeadstart,
the way to do this is to copy these branding region files and make customized versions of
them.
• Copy branding.jspx and brandingAppContextual.jspx in
ViewController\public_html\common\regions to for example
customBranding.jspx and customBrandingAppContextual.jspx. If you want to
replace the 2 images by just 1, you only need to copy
brandingAppContextual.jspx.
• Copy your own logo image(s) to ViewController\images (for example, use
SRBranding.gif from the Oracle SR Demo).
• Change customBrandingAppContextual.jspx (and possibly customBranding.jspx
too) to refer to your own image instead of the JHeadstart image.
5 - 50 Generating Page Layouts JHeadstart Developer’s Guide