Adding New Text to the Receipt

Adding text to the receipt is done on a language by language basis. While the instruction set below covers changing text in the receipt, this same set of instructions can be used to change any element of text on any screen within the software. To add the text for the receipt (or edit the text for any language string), do the following:

1. Make a backup copy of all xml files found in C:\APM
2. Open up the language template for the language text strings that will be modified in Notepad. Example c:\APMapmlang_english.xml.
3. Do a search within the file for <receipt>.
4. Copy the entire section from <receipt> to </receipt> by highlighting it and pressing (ctrl+c).
5. Close the language file.
6. Open the apmlang_custom.xml file in Notepad.
7. Do a search to see if there are any sections for the language that will be modified. Example: When doing a search for German, do a search for <german>.
8. If there is not a preexisting section for the language to be modified, you will need to create one. Hit enter a couple times underneath the </english> tag to create extra lines.
9. On one of the new lines create a tag with the language, Ex. <german>.
10. Hit Enter a couple times to create some space and then create a closing tag. Ex. </german>.
11. Paste (ctrl+v) the copied section where the extra spaces were just created.
12. To create a text string to be added to the receipt, the following information will need to be added within the <receipt> of the language that will show it. A string ID, an English equivalent (optional) and the text itself.
    Sample: <string id=”txtSubtotal” en=”Subtotal”>Subtotal</string>
13. Create an extra line of space somewhere between the <receipt> and the </receipt> in the apmlang_custom.xml file.
14. Create the following shell as a template in the extra space.
    <string id=”” en=””></string>
15. In the id= section, enter an identification for the text that starts with txt.
16. In the en= an English translation can be optionally added, or it can be left blank.
17. Between the >< characters, enter the text as it should be shown on the receipt.
18. Repeat steps 13-17 for each of text to be added to the receipt.

Example: Adding New Text to the Receipt

19. Save the apmlang_custom.xml file and close.
20. Open apmconfig_receipt.xml in Notepad.
21. Locate the section of the file where the new customized text will appear on the receipt.
22. Hit enter to create a new line
23. Use the following sample as a guideline
<item name=”footer” type=”text” pts=”10” face=”times new roman” bold=”false” italic=”true” align=”center”>txtThankYouFooter</item>
24. Create an empty template using the following items:
<item name=”” type=”” pts=”” face=”” bold=”” italic=”” align=” “></item>
25. In the name= enter a new name for the text.
26. In the type= enter text.
27. In the pts= enter the size of the font.
28. In the face= enter the font to be used.
**Note: The font name has to match the font name in Windows and also has to be properly loaded into the machine.
29. In the bold= enter true or false depending on whether boldface will be used or not.
30. In the italic= enter true or false depending on whether italics will be used or not.
31. For alignment of the text enter left, center, or* right* in align=.
32. Between the > < enter the name of the txt created for the text as it was in the apmlang_custom.xml file
Example: <item name=”footer” type=”text” pts=”10” face=”times new roman” bold=”false” italic=”true” align=”center”>txtThankYouFooter</item>
33. Repeat steps 22-31 for each line of new text created in the apmlang_custom.xml file.
34. Save the file and then open it in Internet Explorer to check for errors.