Management and Configuration Guide (Includes ACM xl) 2005-12

C-1

CREATING CUSTOMIZED TEMPLATES

This Appendix explains how to develop custom templates for the Logon page, the optional Logoff pop-

up page and the optional Guest Registration page.

It includes the following sections:

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

A Simple Logon Page Template Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-2

Logon Template Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-3

Logon Page Template — A More Advanced Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-7

Changing the Logon Button Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-10

Using a Logoff Pop-Up with a Customized Logon Page . . . . . . . . . . . . . . . . . . . . . . . . . . C-16

Customizing the Stop Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-19

Introduction

While the Rights Manager Logon Customization pages lets you change the logo and some text on the

standard Logon page, the basic page layout is predefined. Further, you cannot change the standard

Logoff or Guest Registration pages through the Logon Customization feature. Custom templates allow

you to create pages that meet your individual needs.

The ProCurve system includes a template library that supports the programmatic generation of output

(HTML files). It is this capability that you can use to create customized page templates. A template or

tmpl file contains the desired output (HTML) interspersed with various tmpl functions that perform

operations within the Rights Manager as well as other useful functions such as control flow. Tmpl

functions take zero or more arguments, where each argument can be a double-quoted string or a nested

tmpl function. Each invocation of a tmpl function is replaced in the file output by the value returned by

that function.

Once you have created your template file, you enter its name into the appropriate field under the

Custom Templates tab of the New or Edit Logon Customization page. The Rights Manager will then use

your template instead of the standard Logon, Logoff, Stop or Guest Registration page. The Rights

Manager parses and executes the tmpl file to generate HTML output that is displayed. See “Logon Page

Customization” on page 5-38 for details of how to upload a custom template.

The 700wl Series system template library defines many useful functions, such as flow control and other

useful utilities, and a number of system-specific functions that implement ProCurve system

functionality useful in a Logon, Logoff or Registration page.