Table of Contents Previous Next Index

Section 3 Useful Templates for Advanced Customization

Section 3 Useful Templates for Advanced Customization
Most basic customization can be done using the templates described in Section 2 Useful Templates for Customization. For more advanced users, the following templates provide further possibilities. Solid knowledge of HTML and template processing directives is required for some of the more advanced customization tasks.
3.1 Global Layout Templates
The Global Layout templates (LAYOUT-GLOBAL, LAYOUT-GLOBAL-TOP, LAYOUT-GLOBAL-BOTTOM, and LAYOUT-GLOBAL-HELP) define how and where BODY template components are inserted. LAYOUT-GLOBAL provides a high-level structure for all sections of the Web interface. LAYOUT-GLOBAL-TOP and LAYOUT-GLOBAL-BOTTOM do the same for sections that are divided into a top and a bottom, where data is inserted after the top portion and before the bottom. LAYOUT-GLOBAL-HELP provides a high-level structure for the help pages. Editing the global LAYOUT templates can be useful if organizations want to remove sections of the Web interface altogether (for example, removing the bottom banner from being shown on any page), or if they want to rearrange the order in which the BODY components are inserted. LAYOUT templates are also useful if organizations want to add their own custom content blocks, such as additional banners, disclaimers, instructions, or contact information. If content is added into the global LAYOUT templates, then it will be inserted in the same place on every section of the Web interface.
LAYOUT-GLOBAL: Basic Order of Content Blocks
<html>
<head>
<title>&+T-DEFAULTTITLE; - &+BROWSER-TITLE;</title>
+IM &+STYLE; - Stylesheet (STYLESHEET-GLOBAL)
+IM &+JAVASCRIPT; - Javascript (JAVASCRIPT-GLOBAL)
</head>
<body>
+IM &+LOGGEDIN; - Login Info (BODY-GLOBAL-LOGGEDIN)
+IM &+HEAD; - Header (BODY-GLOBAL-HEADER)
+IM &+MENU; - Navigation Bar (BODY-GLOBAL-NAV-MAIN)
+IM &+PAGETITLE; - Page Title and Icon (BODY-GLOBAL-PAGETITLE)
+IM &+BODY-MESSAGE; - LISTSERV Status/Error Messages
+IM &+BODY-GLOBAL-LISTSELECTOR; - List Selector
+IM &+BODY-OPTIONS; - Checkboxes and Options
+IM &+BODY-TEMPLATE; - Main Content
+IM &+WTRAILER; - Trailer (BODY-GLOBAL-TRAILER)
+IM &+MENUBOTTOM; - Pull-Down Menus (BODY-GLOBAL-NAV-MAIN-BOTTOM)
</body>
</html>
3.2 Global Tabs and Global Body for Tabbed Pages Templates
These global BODY templates (BODY-GLOBAL-TAB and BODY-GLOBAL-TABBODY) determine the appearance of tabbed pages. The TAB template contains the HTML and logic for drawing the tabs themselves, while TABBODY contains the body below the tabs.
Note: The TAB template is particularly advanced because of the conditional logic for determining which tabs are active and how the surrounding tabs should be drawn based on where the active tab is located.
Figure 3-1 Global Body for Tabbed Pages Template
3.3 Global Steps and Global Body for Stepped Pages Templates
These global templates (BODY-GLOBAL-STEP and BODY-GLOBAL-STEPBODY) determine the appearance of pages with steps (currently only the List Creation section). As with tabbed pages, the STEP template contains the steps themselves, while STEPBODY contains the content area below the steps.
Figure 3-2 Global Body for Stepped Pages Template
3.4 Global Body for Untabbed Pages and for Untabbed Pages (Divided) Templates
These global templates (BODY-GLOBAL-NOTABBODY and BODY-GLOBAL-NOTABBODY-UNENDED) determine the appearance of pages without tabs or steps, which is the majority of the Web interface. The UNENDED template is used by sections that contain a top and bottom, where data is inserted after the top portion and before bottom.
Figure 3-3 Global Body for Untabbed Pages and for Untabbed Pages (Divided) Template
3.5 Global Body for Blank Pages and for Blank Pages (Divided) Template
These global templates (BODY-GLOBAL-BLANK and BODY-GLOBAL-BLANK-UNENDED) determine the appearance of pages that are not boxed or surrounded by any tables. The UNENDED template is used by sections that contain a top and bottom part.
Figure 3-4 Global Body for Blank Pages and for Blank Pages (Divided) Template
3.6 Global Body for Boxed Pages Template
This global template (BODY-GLOBAL-BOX) contains the design of boxed pages, which include the Register LISTSERV Password, Change Password, and Login screens.
Figure 3-5 Global Body for Boxed Pages Template
3.7 Global Tables for Dashboards Templates
These global templates contain the design for the Server Administrator and the List Owner dashboards. BODY-GLOBAL-DASHBOARD contains the outer table, while BODY-GLOBAL-DASHBOARD-TABLE contains the inner component tables.
Figure 3-6 Global Tables for Dashboards Templates
3.8 Global Navigation Templates
The Global Navigation template (BODY-GLOBAL-NAV-MAIN) contains the top-level navigation bar.
Figure 3-7 Global Navigation Template
Note: The actual menus are located in individual OBJECT-GLOBAL-NAV- templates and are embedded by the Global Navigation Pulldowns template (BODY-GLOBAL-NAV-MAIN-BOTTOM).
3.9 Global Login Information Template
This template (BODY-GLOBAL-LOGGEDIN) contains the part at the top of each page where the user's email address and privileges are spelled out.
Figure 3-8 Global Login Information Template
3.10 Global Page Title Object Template
This template (BODY-GLOBAL-PAGETITLE) is inserted at the top of each page and displays the section header, any active list names, and the corresponding icon.
Figure 3-9 Global Page Title Object Template