Page 1 of 30
IBM WebSphere Portal v6
Sales and Technical Enablement Workshop
Prepared by Lotus Worldwide Technical Sales
Themes Lab
Copyright IBM Corporation 2006. All Rights Reserved.
This exercise is intended to assist IBM SWG Sales and their business partners in
understanding IBM Software products, marketing tactics, sales tactics and our direction
during 2006.
This exercise can be used in sales situations except individual charts labeled VENDOR
CONFIDENTIAL or IBM CONFIDENTIAL, in which case they should be considered
confidential under the practices in place in your firm and under any existing agreements
with IBM regarding disclosure of confidential information.
For questions or to request permission for any other use of the information or distribution
of the presentation, please contact any member of the IBM software sales team.
Confidentiality Reminder
As a reminder, if you are an IBM Business Partner, any IBM Confidential information in
this session is not to be shared by you with anyone outside of your company. This is in
accordance with the PartnerWorld non-disclosure agreement as signed by your company.
Thank you for your adherence to this agreement.
WebSphere Portal v6 STEW
Theme
Page 2
<<Cathy CF Jim>>
IBM Corporation
<<Sept 26 v.2>>
Table of Contents
Purpose................................................................................................................................ 2
Prerequisites........................................................................................................................ 3
Introduction......................................................................................................................... 3
1. Setup............................................................................................................................ 4
2. Enabling automatic JSP reloading .............................................................................. 4
3. Add the required files for later use.............................................................................. 5
4. Re-start/Start the portal server .................................................................................... 6
Color Palette........................................................................................................................ 6
5. Create a color palette................................................................................................... 6
Theme Policy...................................................................................................................... 9
6. Apply different theme policy.................................................................................... 10
7. Add a new Theme Policy.......................................................................................... 11
Customization of Portal.................................................................................................... 15
8 Add the logo and user information at the top of Portal Page .................................... 15
9. Trouble Shooting....................................................................................................... 18
10. Add a menu item to the Main Menu..................................................................... 19
11. Add an entry to the Quick Links........................................................................... 22
12. Theme Extension................................................................................................... 23
13. Add Sametime Contact List Page ......................................................................... 26
Summary........................................................................................................................... 30
Extra Credit....................................................................................................................... 30
Purpose
The purpose of this lab is to provide the Technical Professional experience working with
the new features for configuring and building themes in Portal V6. The lab leads you
through the process of customizing a theme with respect to the “look and feel” of the
portal. The exercises cover the following areas of theme extension and configuration:
• working with parameterized color palettes
• applying a theme policy
• learning about the various techniques to extend themes
WebSphere Portal v6 STEW
Theme
Page 3
Prerequisites
You must have a basic understanding of the portal administration. Since the target
audience of this lab is technical professionals, you should be familiar with:
• JSP Development
• Cascading Style Sheets (CSS) modification
• General HTML syntax and structure
System and software required for the student to complete the lab:
• Lab support files which can be found in E:\Labs\401_Themes
• VMWare version 5.5 or greater
• WTSLABS WPS6 W2K VMWare image
Introduction
In this lab we are going to use the IBM theme that is provided as an out of the box
experience for Portal V6. Working with an existing theme will provide an opportunity to
understand various aspects of customizing and extending a theme without changing any
code in the JSP and JSPF files that make up a theme. You will apply different color
palettes to change the Portal Administration Page look and feel by adding a title and
banner image at the top of administration page.
We will use different theme policy to control how a theme is rendered on a page (for
example, whether to a render the breadcrumb trail). You will also learn how themes can
be extended by adding a Sametime contact flyout to the portal.
WebSphere Portal v6 STEW
Theme
Page 4
Finally, you will customize a theme by adding a logo and the username to the top of the
portal page by modifying the appropriate JSP.
1. Setup
1.1 Start VMWare version 5.5
1.2 Start the VMWare image “WTSLABS WPS6 W2K”
1.3 Ensure that Domino is up and running.
1.4 DO NOT START THE PORTAL YET!!!!
2. Enabling automatic JSP reloading
In order to view the changes you make to the JSPs of your theme and skins without
restarting the portal server, you must set the property “reloadingEnable” to true in the
ibm-web-ext.xmi file. This forces the application server to automatically check for new
versions of the JSPs and reload when necessary.
NOTE: While this is ideal for development and testing purposes, automatic JSP reloading
should be disabled in a production environment because it can negatively impact
performance. .
WebSphere Portal v6 STEW
Theme
Page 5
2 To enable automatic JSP reloading
2.1 Open the file C:\ibm\WebSphere\profiles\wp_profile
\config\cells\WTSlabs\applications\wps.ear\deployments\wps\wps.war\WEB-
INF\ibm-web-ext.xmi
2.2 Find the following entry in this file
<webappext:WebAppExtension xmi:version="2.0"
xmlns:xmi="http://www.omg.org/XMI"
xmlns:webappext="webappext.xmi"
xmlns:webapplication="webapplication.xmi"
xmlns:commonext="commonext.xmi" xmlns:common="common.xmi"
xmi:id="IBM_WPS_Ext" reloadInterval="3"
reloadingEnabled="false"
fileServingEnabled="true" directoryBrowsingEnabled="false"
serveServletsByClassnameEnabled="false"
preCompileJSPs="false">
2.3 Change the value of reloadingEnabled to true.
2.4 Save and close the file.
3. Add the required files for later use
3 Copy the color palette files and theme extension jar files for later use. This will
minimize the number of portal server restarts for this lab.
3.1 Color Palettes – We add the color palettes for a theme in Portal by using a
properties file, which contains the color codes and image paths. Portal will
look up the color palette’s properties files when Portal starts and then it will
apply those color codes and images to the theme. In order to have better
organization, we create a directory, adminColorPallette, to store new color
palettes and put the banner gif inside directory. Later we will add the color
palette properties file in the directory.
3.1.1 Create the directory adminColorPalette under
C:\ibm\WebSphere\profiles\wp_profile\installedApps\WTSlabs\wps.e
ar\wps.war\themes\html\IBM\colors\
3.1.2 Copy AdminBanner.gif from e:\Labs\401_Themes\colorPalette to
C:\ibm\WebSphere\profiles\wp_profile\installedApps\WTSlabs\wps.e
ar\wps.war\themes\html\IBM\colors\adminColorPalette
3.2 Theme Extension – We add the theme extension by writing our code to add
more functions to the look and feel of a theme. When Portal starts, it will look
up the theme extension jar under C:\<Portal_home>\shared\app and load it.
wp.theme.extensions.samples.sametime.jar is the jar that contains the related
class files that tell the theme to add a Sametime flyout.
3.2.1 Copy wp.theme.extensions.samples.sametime.jar from
e:\Labs\401_Themes\ThemeExtension to
C:\WebSphere\PortalServer\shared\app
评论1