You can use your own HTML email template for customer reciepts, just paste it into the box in the setup page in Admin. This means you can include your own images in the template, however you will need to host those images on your web server.

To revert to the cart's default template, just clearout the template box in Admin.


Template tags

The template works by including special tags which are then replaced with the appropriate values from the order. The tags take the format #field_name# and are listed in the table below. The letters in the field name are not case sensitive.

There are two special tags that are replaced with more than just a single piece of text, they are #Cart_contents# and #Gift_voucher#. Both are substituted with the data formated in an HTML table using the font from your cart setup. For example #Cart_contents# is replaced with:

<tr>
  <td>1</td>
  <td>My first product</td>
  <td>1.99</td>
  <td>1.99</td>
</tr>
<tr>
  <td>2</td>
  <td>Second product</td>
  <td>2.99</td>
  <td>5.98</td>
</tr>

The #Gift_voucher# tag is replaced with a complete table, with open and closing <table> tags. A font tag will also be included inside each <td> tag, it is left out of the above example for clarity.

The only real restriction is that yours template must be less than 5,000 characters long. In practice that should be more than enough for a receipt.


Download the default template

You can download the cart's default template, you can use it as the the starting point for your own:

http://www.mals-e.com/download/email_template.zip


Template tags


#Merchant_name#Your company name
#shopperid#Shopper ID
#ip#Customer's IP address
#date#Date (D M Y) - 20 May 2009
#pay_method#Payment method
#pay_data#Additional payment data (For example: PayPal ref.)
#cart_contents#Tabulated list of products bought
#discount_value#The value of a discount
#subtotal#Value of the products bought
#shipping_value#Cost of shipping
#tax_value#Tax charged
#total_value#Total cost of order
#currency#The currency of the order
#shipping_zone#Shipping zone selected (options 4 to 7)
#shipping_calc#Data from a shipping cacluator (for example Advanced shipping calc)
#inv_name#Customer name
#inv_company#Billing company
#inv_addr1#Billing address
#inv_addr2#
#inv_state#
#inv_zip#
#inv_country#
#ship_name#Ship to name
#ship_company#Ship to company
#ship_addr1#Shipping address
#ship_addr2#
#ship_state#
#ship_zip#
#ship_country#
#ship_tel#Shipping telephone number
#inv_tel#Customer telpehone number
#inv_fax#Fax
#email#Email address
#edata#Additional customer information data
#giftvoucher_value#Gift certificate/voucher value
#giftvoucher_code#Gift cert/voucher code
#voucher_value#Discount voucher value
#voucher_code#Discount code value
#customer_message#Customer's message
#inv_id#Tax/Social security ID
#Download_links#Output from download system