|
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
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.
|