Customize the User web interface

The User web interface displays information about the user’s account and provides access to features such as TopUp/Pre-Paid Cards. You can tailor the visual design of these pages to make them fit into the look and feel of your internet or intranet site.

Change the branding of the User web interface

1. Click the Options tab. The General page is displayed.

2. Scroll to Branding > User web interface section.

   

3. To change the header’s background color:

   1. In Background color, enter the name of the required color or its hexadecimal value #RRGGBB. e.g. green or #00ae5b.

4. To change the header logo:

   1. Click Choose File next to Logo; then locate the header logo image file. The image must be in PNG format and for best results should be sized 154px x 40px.

5. Click Apply.

The changes are reflected on the User web interface.

Customize the CSS of the User web interface

The design of the User web interface 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/MF directory structure at [app-path]/server/custom/web supersedes User web interface customizations in the Options > General > Branding section of the Admin web interface.

User web interface customization files

Filename	Description
user3.css	If this file exists, the contents of user3.css is included as an overriding stylesheet. Use the styles in this file to define fonts, colors and sizes. NOTE: The number in this file has been incremented from versions prior to 17.2.
header3.inc	If the header include file exists, the HTML in the header area of the pages is replaced with the contents of the file. Save this file in UTF-8 encoding for international characters to be displayed correctly. NOTE: The number in this file has been incremented from versions prior to 17.2.
footer3.inc	If the footer include file exists, the HTML in the footer area of the page is replaced with the contents of the file. Save this file in UTF-8 encoding for international characters to be displayed correctly. NOTE: The number in this file has been incremented from versions prior to 17.2.

Additional links in the navigation menu

The navigation menu in the user web interface contains links for the PaperCut services that are enabled and available to the user. In some cases, you might want to add additional external links to this menu. Examples include:

• Linking to a print policy page on the organization’s intranet.

• Linking to a page with key contact details.

• A link to return to the “main” intranet page/portal.

Custom links are displayed above the Log Out item.

Add a custom link

1. Click the Options tab. The General page is displayed.

2. In the User Features area, select the Add custom links to the user web navigation menu check box.

3. Click Add link.

4. Complete the following fields:

   • Label/Text—the text that is displayed in the navigation menu.

   • URL—the destination of the URL when clicked.

   • Target—the destination where the linked URL will be displayed. For more information about target values, visit w3schools targets page .

     • One common example is to specify _self as the target. This setting means clicking the link will no longer launch a new tab, but will launch the link in the same tab. _blank would tell it to launch the link in a new tab or window.

   

   The link is now displayed in the User interface.

   

Existing custom links are displayed in the Admin web interface under the Add custom links to the user web navigation menu check box. To delete a link, click the [delete] link next to the relevant link.

The URL in custom navigation links can also contain special replacement fields. E.g. the %user% in http://example.edu/print-policy?u=%user% is replaced with the logged in username to create a URL such as http://example.edu/print-policy?u=tom.

The available special replacement fields are as follows:

Fields available for replacement in custom navigation links in the user web interface

Field	Description
%user%	The username of the logged in user.
%user_full_name%	The full name of the logged in user.
%user_id%	The id/card number of the logged in user.
%user_email%	The email address of the logged in user.
%user_office%	The office of the logged in user.
%user_department%	The department of the logged in user.
%return_url%	A URL that sends the user back to the user web interface. The user is sent back to the Summary page as if they had just logged in, assuming their session has not timed out.

Custom printer maps for Web Print

You can use a graphical map or other custom content instead of the default printer selection list in the Web Print wizard. For more information see Designing Printer Maps / Custom Printer Selection Lists.