SAS 9.1.3 Integration Technologies » SAS Web Infrastructure Kit: Developer's Guide


Developing Custom Themes
Steps for Defining a New Theme
Style Sheet and Graphics Reference
Theme Template Reference
SASthemes.xml File
Element Descriptions for Themes DTD
Changing the Application Name
Migrating Custom Themes After Installing a Service Pack
List of Theme Changes for Service Pack 3
List of Theme Changes for Service Pack 4
Developing Custom Themes

Theme Templates Reference

The Web Infrastructure Kit's themes (SAS Default and SAS Winter) include theme templates. A theme template is an HTML fragment that renders a small, specific portion of an HTML page.

Each theme template is associated with a SAS custom tag. The portal's JSP pages use these custom tags along with the style sheets to render elements of portal pages such as the banner, the navigation bar, and menus. By modifying a template and including it in a custom theme, you can change the way the tag renders its output when that theme is invoked.

Caution: The templates contain dynamic substitution variables in the form of %VARIABLE_NAME%. Do not change the variable names, since they are required by the portal Web application.

The theme templates reside in the path themes\<themename>\templates. You can modify the following templates in order to customize the look and feel of the portal interface.

banner.html
is used to display the main banner at the top of all portal pages. By modifying this template, you can customize the banner's borders or the placement of items in the banner such as the logo, the application name, and links. You can also add a custom background image to the banner; for instructions, see Step 5 in Steps for Defining a New Theme.

helpmenu.html
is used to display the menu that appears when a user clicks the Help link in the banner. By modifying this template, you can can customize features of the menu such as borders, cell padding, and text alignment.

searchactionsmenu.html
is used to display the popup menu that appears when a user clicks the action menu Action Selector icon in the first column of the search results panel. By modifying this template, you can can customize features of the menu such as borders, cell padding, and text alignment.

secondarymenu.html
is used to display the divider that appears between the banner and the main contents of a page. By modifying this template, you can can customize the divider's height and borders.

tab_menu_first.html
tab_menu_first_selected.html
tab_menu.html
tab_menu_selected.html
are used to display the tabs in the navigation bar when the navigation bar is displayed horizontally. By modifying these templates, you can customize the shape, borders, and cell padding of the tabs, as well as the alignment of the page names that appear in the tabs.

The templates whose names contain the word first are used for the tab that is in the first position. The templates whose names contain the word selected are used for the tab that is currently selected.

tab_vert_menu_first.html
tab_vert_menu_first_selected.html
tab_vert_menu.html
tab_vert_menu_selected.html
are used to display the tabs in the navigation bar when the navigation bar is displayed vertically. By modifying these templates, you can customize the shape, borders, and cell padding of the tabs, as well as the alignment of the page names that appear in the tabs.

The templates whose names contain the word first are used for the tab that is in the first position. The templates whose names contain the word selected are used for the tab that is currently selected.

utilmenu.html
is used to display the Options menu, which appears when a user clicks the Options link in the banner. By modifying this template, you can can customize features of the menu such as borders, cell padding, and text alignment.

viewer_action_menu.html
is used to display the toolbar that appears below the banner when a full-page view of a content item is displayed. The toolbar includes actions such as Bookmark, Publish, and E-mail. By modifying this template, you can can customize features of the toolbar such as borders, height, cell padding, and text alignment.