Customizing the User web pages

Look & Feel

The user pages display information about the user's account and provide access to features such as TopUp/Pre-Paid Cards. The visual design of these pages can be tailored to make them fit into the look and feel of an existing internet or intranet site. This gives the pages an official look ensuring your users see the system as an important part of your organization's network.

A customized end-user web designed for St Mary's Anglican Girls School

Figure 16.2. A customized end-user web designed for St Mary's Anglican Girls School

A customized end-user web designed for Williamstown High School

Figure 16.3. A customized end-user web designed for Williamstown High School

PaperCut Software International Pty Ltd offers a service where their developers will undertake design work based on an existing website. If you would like assistance with the customization, please email the PaperCut Software International Pty Ltd support team.

Organizations whose staff have good to advanced HTML experience may choose to customize the pages in-house.

The design of the user pages is controlled via HTML "include" files for the header and footer areas of the page, with page styling controlled via Cascading Style Sheets (CSS). Placing the following files in the PaperCut NG directory structure at [app-path]/server/custom/web overrides page layout and style.

FilenameDescription

user.css

If this file exists, the contents of user.css is included as an overriding stylesheet. Styles in this file can be used to define fonts, colors and sizes.

header.inc

If the header include file exists, the HTML in the header area of the pages is replaced with the contents of the file.

footer.inc

If the footer include file exists, the HTML in the footer area of the page is replaced with the contents of the file.

login-logo.png

If this file exists, the logo on the web-based login page is replaced with the supplied image. The file should be an image of size 250px by 64px in PNG format.

Table 16.2. Files used to customize the user web pages

Tip

Any custom content placed in [app-path]/server/custom/web/, such as additional images, can be accessed via a URL beginning with /custom/. For example if a file named header.jpeg is placed in [app-path]/server/custom/web/ it can be accessed via the URL /custom/header.jpeg.

Login Instructions

Some organizations may benefit from providing additional login instructions to users. This can be useful for explaining which username or password to use (in the case there are multiple logins or passwords at the site).

Login Page with custom instructions

Figure 16.4. Login Page with custom instructions

A custom message may be displayed on the login page using the following config key:

Config nameDescription

display.login-instructions

A message to be displayed on the login screen, above the username and password fields.

Table 16.3. Custom login instructions config key

Please see the section called “Using the Config Editor” for more information about changing the value of config keys.

Custom Printer Maps for Web Print

A graphical map or other custom content may be used instead of the default printer selection list in the Web Print wizard. For more information see the section called “Designing Printer Maps / Custom Printer Selection Lists”.