Gadgets/Widgets are a lightweight application that sits on a user's desktop. Windows Vista has in-built support for sidebar gadgets. The equivalent on the Mac is the Widget. PaperCut NG offers two useful Gadgets as well as a series of AJAX/JSON style embeddable components that can be leveraged by intranet developers.
Two Windows Vista Gadgets are available:
The Print Balance Gadget: Used to display user's personal balance on the desktop or sidebar. This is called
PCBalance.gadget.The Environmental Impact Gadget: Used to provide the users with feedback on the environmental impact associated with their printing activities. Highlighting the environmental aspects is useful in modifying a user's behavior towards printing. For more information about how these values are calculated, see the section called the section called “Environmental Impact”. This gadget is called
PCEnvironmentalImpact.gadget.
To install a Gadget:
Log in as administrator
Browse to the share on the PaperCut NG server at
\\server\PCClient\win\GadgetsCopy all
*.gadgetfolders to the local directoryC:\Program Files\Windows Sidebar\GadgetsUsers should now see the PaperCut NG Gadgets as available Gadgets on the system.
PaperCut NG also provides web widgets that can be easily embedded within pages on your intranet site. These widgets work in a similarly to Google Web Gadgets or the Google Maps APIs. All that is required is to paste a few lines of HTML/JavaScript on your pages. There are two built-in web widgets that offer balance and environmental impact (and look identical to the Vista widgets above). However if the built-in widgets do not suit your needs you can create your own that better suit your site.
There are only two requirements to running web widgets on your intranet site:
You require edit access to the intranet pages to add the required HTML/JavaScript.
The username of the logged in user is required so the web widget knows whose details to load. This will usually require that users login to the intranet. When using a Microsoft Active Directory domain and Microsoft IIS web server the user is automatically logged in and their username is available.
The simplest way to get started with web widgets is to look at some examples. There are detailed and well commented examples
available on the PaperCut NG server in the directory [app-path]/server/examples/webwidgets/examples.html.
These examples should be used as a starting point to implement web widgets on your site.
The basic steps to adding a web widget to a page are:
Add a
<div>element to your page. The widget will be drawn within this tag. The div element must be given a uniqueID.Include scripts into your page to load the widget and user data from the PaperCut NG.
Edit the included script to set
pcUsernameto the logged in user.Edit the included script to set
pcServerURLto base URL of the PaperCut NG server.Add some script to draw the built-in widgets to the page. You can use one of the built-in widgets, or create your own.