This section describes how to create a WebLogic Portal Look and Feel and deploy it as an Administration Console extension. The extension enables you to replace some or all of BEA’s logos, colors, and styles in the Administration Console.
Figure 5-1 illustrates the process. The steps in the process, and the results of each are described in Table 5-1. Subsequent sections detail each step in the process.
2. (Optional) Use a Message Bundle for Your Look and Feel.
|
||
To create a simple extension that replaces the BEA logos and colors with your own:
WL_HOME/samples/server/medrec/console-extension
where WL_HOME
is the directory in which you installed WebLogic Server.
xray
directory under root-dir
/framework/skins
and root-dir
/framework/skeletons
to a name that you choose.
where root-dir
is the name of your development directory.
For example, root-dir
/framework/skins/mycompany
and root-dir
/framework/skeletons/mycompany
Making more complex changes to the WebLogic Server Look and Feel, such as changing the layout of portal components and navigation menus, requires an advanced knowledge of WebLogic Portal Look and Feels. If you have installed BEA Workshop for WebLogic Platform 9.2, you can use its Look and Feel editor to make these complex changes. For more information, see User Interface Development with Look & Feel Features in Portal Development Guide.
To overwrite the MedRec Look and Feel’s image files with your company’s image files:
root-dir
/framework/skins/
mycompany
/images/banner_logo.gif
.To prevent the need to resize the banner frame, do not make your image any taller than 42 pixels.
root-dir
/framework/skins/
mycompany
/images/banner_bg.gif
root-dir
/framework/skeletons/
mycompany
/header.jsp
and replace <bean:message key="login.wlsident”>
with your text.
If you want to provide localized strings, use the JSTL <fmt:message>
tag. See Use a Message Bundle for Your Look and Feel.
To make more complex modifications, you can change the JSP and styles that render the banner. The root-dir
/framework/skeletons/
mycompany
/header.jsp
file determines the contents of the Administration Console banner. Within header.jsp
, the style bea-portal-body-header
specifies the name and location of an image file that is used as the banner background. The style bea-portal-body-header-logo
specifies the name and location of the logo file. Both of these styles are defined in root-dir
/framework/skins/
mycompany
/css/body.css
.
The Administration Console uses several cascading style sheets (CSS) to specify its fonts and colors. To change these styles, open the style sheet and change the style’s definition. Table 5-2 summarizes the CSS files that the Administration Console uses. All of these files are located in the root-dir
/framework/skins/
mycompany
/css
directory.
The buttons in the Administration Console use a repeating background image to render the blue fade (and grey for inactive buttons). The image files for these buttons are located in the following directory:root-dir
/framework/skins/
mycompany
/images
Several portlets in the Administration Console use a theme, and you can change the definitions of these themes. Themes are similar to Look and Feels but the scope of a theme is limited to a section of a portal, such as a book, page, or portlet. A theme can be used to change the look and feel of the components of a portal without affecting the portal itself.
For example, the Change Center portlet uses its own theme to distinguish its buttons from the other form buttons in the Administration Console.
To change the color of a theme’s buttons or title bars, change the images and styles in the theme’s skins
directory. Table 5-3 summarizes the directories that contain CSS files and images for theme skins. All of these directories are under the root-dir
/framework/skins/
mycompany
directory. For information about modifying skin themes, see
Creating Skins and Skin Themes in BEA Workshop for WebLogic Platform 9.2 Online Help.
Each theme is made up of a skin and a skeleton. The skeleton defines the overall structure of the portlet contents. The definition for each theme’s skeleton is under the root-dir
/framework/skeletons/
mycompany
directory. For information about modifying skeleton themes, see
Creating Skeletons and Skeleton Themes in BEA Workshop for WebLogic Platform 9.2 Online Help.
The login page asks users to enter a user ID and password. The login error page displays if users enter invalid data. Both of these pages are displayed before the Administration Console loads its portal desktop. Therefore, these pages do not use the portal’s Look and Feel and their image and stylesheet files are not under the root-dir
/framework
directory. Table 5-4 summarizes the files and directories that determine the appearance of the login and login error pages.
If you want to change the text that these pages display, modify the
<fmt:message/> JSP tags to point to messages in your own message bundle. See Use a Message Bundle for Your Look and Feel.
|
In the banner, login, and login error pages, the Administration Console uses JSTL tags to load text messages from localized properties files. For example, to display the window title in LoginForm.jsp
:
<fmt:setBundle basename="global" var="current_bundle" scope="page"/>
tag in LoginForm.jsp
sets the current message bundle to global
.
This JSP tag looks in WEB-INF/classes
for files with the following name pattern:bundle
[
_locale
].properties
.
The default properties file for this bundle is WEB-INF/classes/global.properties
. If the Web browser or operating system specifies a different locale, then the JSP tag would load WEB-INF/classes/global_
locale
.properties
.
<fmt:message key="window.title" bundle="${current_bundle}" />
tag opens the global.properties
file and renders the text that is identified by the window.title
key:window.title=BEA WebLogic Server Administration Console
If you want to change these messages, you can create your own properties files and modify the JSP tags to use your bundle. See Creating a Message Bundle.
Table 5-5 describes the text messages that the banner, login, and login error pages display.
A NetUI Extension file is the deployment descriptor for your Look and Feel. It contains the names and locations of the files in your Look and Feel, and it causes the Administration Console to replace its Look and Feel with yours. For more information, see the NetUI Extensions Schema Reference.
The sample file is in the following location:root-dir
/WEB-INF/netuix-extension.xml
<provider-info>
element, change the information to describe your Look and Feel, developer contact and support URL. The information in this element has no programmatic significance. It is intended to help your technical support team keep track of your software modifications.
<look-and-feel-content>
element:title
, skin
, and skeleton
attributes, replace the xray
value with the name of the directory you chose in step 2 in Copy and Modify the Sample Look and Feel: Main Steps.definitionLabel
and markupName
attributes, replace the xray
value with the name of the directory you chose in step 2 or use some other string. These attributes are required by the portal framework, but are not used in a Look and Feel extension.