Location of theme resources
The theme has two types of resoursces:
Dynamic J2EE resources JSPs deployed in WAR files. Used by dynamic content spots within the theme and skin templates. Compiled and executed on the server. Static resources Theme, skin, and layout templates, as well as HTML CSS, and, and image files. Located either in WebDAV or in a WAR file. Default is WebDAV Do not edit any of the themes provided with WebSphere Portal, as they are updated by WebSphere Portal fixes and are static. Instead, update and deploy our own copy of the theme WAR.
J2EE resources
Theme J2EE resources are deployed at installation to the directory
PortalServer_root/theme/wp.mashup.cc.theme/installedApps/wp.mashup.cc.theme.ear/PageBuilder2.war/
In the past themes were also deployed to
PortalServer_root/installer/wp.ear/installableApps/wps.ear/wps.war/
Deploying customer themes to this location is no longer supported.
PortalServer_root is a read only directory. Do not make any changes to these files, as they can be updated by service updates. To customize a theme shipped with Portal, deploy our own copy of the theme WAR. Your theme resources are deployed under wp_profile.
wp_profile_root/installedApps/node/your-ear-name.ear/your-war-name.war/
Static resources
In earlier portal versions themes deployed their static resources with their WAR file. With the page builder theme in portal Version 7 and later versions, static resources are deployed to WebDAV. We can access all WebDAV file store entry points through the root URL...
http://hostname:port/wps/mycontenthandler/dav/entrypoint/
- Administration entry points:
- themelist/
- Administrative entry point for managing themes.
- skinlist/
- Administrative entry point for managing skins.
- File store entry points:
- fs-type1/themes/
- Entry point for creating, updating, or deleting static theme HTML, CSS, JavaScript, and image resources.
- fs-type1/skins/
- Entry point for creating, updating, or deleting static skin HTML, JavaScript, and image resources.
- fs-type1/layout-templates/
- Entry point for creating, updating, or deleting static layout templates.
- fs-type1/common-resources/
- Entry point for common static resources that are shared by multiple themes.
We can access all WebDAV entry points listed previously through the root WebDAV entry point URL. This URL is...
http://hostname:port/wps/mycontenthandler/dav/entrypoint/
Dojo and other JavaScript resources Dojo is deployed to the directory... PortalServer_root/theme/wp.theme.dojo/installedApps/dojo.ear/dojo.war/
Multiple versions of dojo are provided here to support migrated themes that were implemented for a particular version of dojo. Dojo V 1.3.2 is provided in the root directory of dojo.war. Dojo V 1.4.3 and future versions are provided in a subdirectory named by the version, for example /v1.4.3/.
- Source
- The Dojo 1.4.3 source including all custom Page builder JavaScript and widgets is included in a compressed .zip file. The location of this file is:
PortalServer_root/theme/wp.theme.dojo/installedApps/dojo.ear/dojo.war/source.zip
This zip file includes the Dojo profile with which the theme JavaScript layers are built. It is named portal_dojo_143.profile.js .
Use this source and Dojo profile to create new custom layers. If we add a significant amount of custom JavaScript to the theme, create a new JavaScript layer before going into production.
- JavaScript Layers
- The theme utilizes two minmized and compressed JavaScript layers: theme.js and theme.edit.js. Both are located at
PortalServer_root/theme/wp.theme.dojo/installedApps/dojo.ear/dojo.war/v1.4.3/com/ibm/themes/PageBuilder2
- theme.js
- This layer is included when the page is initially rendered. It includes all modules and widgets required for view mode.
- theme.edit..js
- This layer is included when a page enters Edit mode. It includes all modules and widgets required for customizing the page.
The same directory includes uncompressed versions of both files, We can edit these files during development or use them for debugging purposes. To use these uncompressed files, access the WAS administrative console and select...
Resources | Resource Environment | Resource Environment Providers | WP CommonComponentConfigService | Custom Properties | cc.isDebug
Change the value of the property cc.isDebug to true and restart the portal.
resources Inside a WAR file or WebDAV root folder, theme resources are grouped in the directory /themes/. There are additional folders such as, css, images, js, menuDefinitions, and system. This directory can be structured into subdirectories as follows:
/theme/theme_name/nls
Example:
/themes/html/PageBuilder/en/
Related concepts: