Customizing the Administration Web Interface

As the PaperCut NG administration interface is designed for use by administrators there generally isn't the need to customize it to the extent of the user web interface (for information about customizing the user web interface see the section called “Customizing the User web pages”). An organization logo or other image can be displayed in the header of the administration interface however. The available customizations are:

Logos can be added to customize the look of the admin interface. These can be customized by placing the following files in the PaperCut NG directory structure at [app-path]/server/custom/web/.

Customized logo (admin-logo.png) in the administration interface

Figure 16.9. Customized logo (admin-logo.png) in the administration interface

Customized logo (admin-main-logo.png) in the administration interface

Figure 16.10. Customized logo (admin-main-logo.png) in the administration interface

You can add your own content to the dashboard by placing an HTML file in [app-path]/server/custom/web/ called dashboard-notice.inc. This could be used to display a short message for the attention of other administrators. Other examples might include:

Customized content in the administration interface dashboard

Figure 16.11. Customized content in the administration interface dashboard

Tip

The title of the custom dashboard widget can be changed by setting the config key dashboard.gadget.custom.title. For information about setting config keys please see the section called “Using the Config Editor”.

FilenameDescription

admin-logo.png

If this image exists it will be displayed to the right of the existing application logo. The image must be in PNG format and for best results should be sized 250px by 42px.

admin-main-logo.png

If this image exists it will replace the standard application logo in the top left corner. Changing the standard logo will display a "Powered by PaperCut" image beside it. The image must be in PNG format and for best results should be sized 280px by 42px.

dashboard-notice.inc

HTML contained within this file will be displayed on the administration dashboard page.

Table 16.5. Files used to customize the administration web pages