Receipt Template Editor

There are many default receipt templates included with the Evergreen staff client. These templates are saved on individual workstations. Customization can be done workstation by workstation or by exporting the templates to import to other workstations.

  1. Select Admin → Workstation Administration → Receipt Template Editor.
  2. Select the checkout template from the dropdown menu.

    select checkout
  3. This is what the default checkout template looks like. The template preview is on the left hand side. You can edit the Header, Line Item or Footer on the right hand side.

    receipt-3
  4. In the upper right hand corner you can see the available macros by clicking on the Macros button. A macro prints a real value from the database. In this example, the macro %LIBRARY% prints “Prince Rupert Library”. The macros that are available vary slightly between types of receipt templates (i.e. bills, holds, items).

    Tip

    Receipt templates are marked up with HTML tags. You may use most HTML tags. See http://www.w3schools.com/html/ for more information on HTML tags.

    You may insert a link to an image, e.g. your library’s logo, that exists on the web. For example, to include the white Evergreen logo from this document, enter tag <img src=http://docs.evergreen-ils.org/2.3/media/small_logo_white.jpg>. in the receipt template.

    There are several macros that can carry pre-built contents specific to individual libraries. The contents can be set up in local administration. For details see Library Settings. Though text can be hard-coded in receipt templates, the pre-built contents will be automatically applied to receipts printed from all workstations without editing each template.

    • %INCLUDE(notice_text)%
    • %INCLUDE(alert_text)%
    • %INCLUDE(event_text)%
    • %INCLUDE(footer_text)%%
    • %INCLUDE(header_text)%
  5. Below are some example edits:

    receipt-11

    The above is the default Line Item in Checkout template. The macro %barcode% prints the item barcodes of the books that were checked out. The macro %due_date% prints the due date for each item that was checked out. You may add a line break between them: Barcode: %barcode% </br> Due: %due_date%

    The receipt preview will look like this:

    receipt-11a

    Note

    The due date can only be printed in the YYYY-MM-DD format.

  6. Once you have the checkout template how you want it, click Save Locally to save the template to your computer.
receipt-15

Print Holds Slip with Landscape Layout

This feature enables you to use Mozilla-specific CSS to print holds with a landscape layout. To use the landscape layout:

  1. Click AdminWorkstation AdministrationReceipt Template Editor.
  2. Select hold transit slip from the Template Name drop down menu.
  3. Enter <div> before and after the block of text that you wish to rotate.
  4. Enter the stylesheet text in the <div> bracket that appears before the block of text that you wish to rotate:

    <div style="moz-transform: rotate(90deg);">
  5. When you click out of this box, notice that the text in the Preview box on the left side of the screen has rotated 90 degrees.
  6. You can further customize the look of the text by adjusting its height and width. The height and width that you specify will be unique to your printer. For example, you could add the following height and width to your rotated text:

    <div style="moz-transform: rotate(90deg);height: 300px; width: 200px;">
    Print_Holds_Slip1
  7. The holds slip will print with the configured text in a landscape layout:

    Print_Holds_Slip2

Exporting Templates

As you can only save a template on to the computer you are working on you will need to export the template if you have more than one computer that prints out receipts (e.g. more than one computers on the circulation desk, or another computer in the workroom that you use to checkin items or capture holds with).

  1. Click on Export.

    receipt-17
  2. Select the location to save the template to, name the template, and click Save.
  3. Click OK to confirm.

Importing Templates

  1. Send the exported templates file to the workstation to which you want to import the templates. You may do it using memory stick or email, etc.
  2. On Receipt Template Editor, Click Import.

    receipt-20
  3. Navigate to and select the template file that you want to import. Click Open.

    receipt-21
  4. Click OK to confirm on the prompt.
  5. Click Save Locally.
receipts-23

Tip

By default all libraries use shared and hard-coded templates for Hold Slip and Transit Slip. Libraries can switch to using their own templates by setting up a library setting: Use legacy hardcoded receipts/slips. Details see Library Settings.