Rebranding the Administration Portal
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
You can update the appearance of the WebLogic Administration Portal (included with WebLogic Portal) by changing images (.gif
and .jpg
files) and cascading style sheets (the .css
file). You can also update the text displayed on the login screen by updating the login.properties
file. This feature allows you to make your implementation of the Administration Portal reflect your company identity or your specific personalization needs.
This document describes how to make these changes and then deploy the updated files. It is organized into these four steps:
Editable versions of the necessary files are located in:
<BEA_HOME>\weblogic81\portal\lib\adminPortalBranding
Below are instructions for installing your versions of these files in an adminPortal.war
file (a web application archive of the WebLogic Administration Portal).
Once you've located the files, you can change them as necessary to fit your needs, so long as you stay within the following guidelines when modifying them. If you do not follow these guidelines, you risk breaking the functionality in the WebLogic Administration Portal.
main.css
only): You should only change color values (for example, #FFFFFF, #9FB8D4, and so on) and font-family values.*.gif
, *.jpg
): Generally, changing image files means that you will overwrite the default files with your own version. You shouldn't change the height and width of any image files, as size changes can have a serious affect on the appearance of the Adminstration Portal. The exception to this guideline are images whose name begins with button_
. You can change these to fit the button label text, although you should ensure that these images remain as small as practical.login.properties
): Do not delete any keys from this file. A key is any text at the beginning of a line that is followed by an equals sign (=
). If you want to remove certain text, remove only the portion after the equals sign. Warning: Do not rename any of the files; renamed files will be ignored during browser rendering, resulting in missing information.
You can easily preview the changes to many images and CSS styles without updating or redeploying the adminPortal.war
file by viewing the previewChanges.htm
file. This file is located at:
<BEA_HOME>\weblogic81\portal\lib\adminPortalBranding
and uses the local images and CSS file. It will show any changes you made that affect those files. Simply open previewChanges.htm
in a browser to preview many of your changes, depending upon which CSS styles you are using.
Not all of the CSS styles are used in the default previewChanges.htm
. Far too many CSS styles are available to list exactly what you might and might not see when you preview the changes. The default page shows just the most common styles.
The floating palette that appears when you open previewChanges.htm
, illustrated in Figure 1, displays the CSS class name used on the element directly under the mouse pointer. To highlight the element identified under CSS Class Name:, select Highlight current element.
Figure 1 Preview Changes Floating Palette
This section describes the steps required to install updated files into adminPortal.war
. These procedures are described in:
Please read Before Installing Updated Files before proceeding with the installation.
Before attempting to install the updated files, review the following prerequisites:
jar
command, which is required to update the adminPortal.war
file. You can test to see if you have access to this command by typing jar
at any command prompt. If your Java SDK or JDK was installed correctly, you should see a list of usage instructions for the command when you enter jar
. If you need to install a Java SDK please talk to your system administrator or visit: http://java.sun.com/downloads/adminPortal.war
file from the directory:<bea_home>\weblogic81\portal\lib\adminPortalBranding
.war
file. If that occurs, modify a working copy and replace the original .war
file or undeploy the file you intend to update. Either way, you will need to deploy the modified.war
file before you can use it.To install and update the CSS and image files, use this procedure:
<bea_home>\weblogic81\portal\lib\adminPortalBranding
pathToWarFile
is the path to your targeted adminPortal.war file):jar uvf
pathToWarFile
framework/*
![]() |
![]() |
![]() |