Receipt layout
The layout is the main part you can edit using Receipt Builder. The layout is stored in an XSL file that defines how to present the data in the data file, optionally using translated phrases from the language file.
XSL (Extensible Stylesheet Language) is a styling language used for rendering XML files. An XML files only contains data. Nothing in the XML file specifies how the data should be presented. XSL describes how to style the XML data to a visual language, such as HTML.
For the PayComplete™ receipts, the XSL files convert receipt XML data into a variant of HTML, specific for PayComplete™ receipts. It is not in any way a standard.
You can edit the receipt layout XSL file from Receipt Builder by using the Edit layout tool. The tool opens a new window showing the XSL source code.
Important
You can manually edit the source code in the XSL file. Editing the source code requires advanced XSL skills and any mistake can make the receipt impossible to render.
Header/Footer layouts
You can control the appearance of a receipt header and footer by using external layout files. An external header or footer layout can be reused in different receipts.
The header and footer files are just layout files like any other part of a receipt, but they do not have their own data and language. This means that the data and language of the main receipt must contain everything needed by the header and footer.
Tools for adding a header or a footer are available from the Receipt Builder Tools menu. You select the XSL layout file for the header or footer you want to use. The standard header and footer XSL layout files are stored in the [installation folder]\resources\configurable\receipts folder.
You can only add one header and one footer to a receipt. The options on the Tools menu are disabled if the opened receipt already has a header or a footer. Header, footer, and any other external template used in the receipt are visible in the receipt but the text appears dimmed. This indicates that you can't edit the text.
You can delete a header or footer by selecting it in the receipt in the work area and then deleting it.
Date and time configuration
In the resources/configurable/configuration/misc.properties file, you can configure how date and time are presented on the receipt.
# Date format on receipt receipt_date_format = # Time format on receipt receipt_time_format = # Date/time format on receipt receipt_date_time_format = # Time format on transaction list receipts transaction_list_time_format = # Date format on transaction list receipts transaction_list_date_format = # Date/time format on transaction list receipt transaction_list_date_time_format =
receipt_date_format = yyyyMMdd
receipt_time_format = HHmm
The value is based on the Java constants (0 = FULL, 1 = LONG, 2 = MEDIUM, 3 = SHORT) or format strings.
For more information, see SimpleDateFormat