---- dataentry ----
type          : integration		# do not change this line
systems       : FoxyCart		# the system(s) that the integration is for, separated with commas if more than one
name          : custom_email		# the name of the integration
description   : Create a custom email receipt using the XML datafeed. Useful if you need attachments or language customization (prior to v0.4.0)
tags          : receipt, email		# tags, separated by commas. don't include the "system" here.
date_dt       : 2008-06-19		# the date in YYYY-MM-DD format
version       : 0.2		# if you have a version for your code, enter it here
developer_url : http://www.themancan.com/		# if you'd like a link back to your site, stick it here
----


====== custom receipt ======

<WRAP important round>
//**Please note:**//
The code on this page is submitted by members of the FoxyCart community, and may not verified by FoxyCart.com LLC in any way, shape, or form. Please double check the code before installing. If you need help with it please [[http://forum.foxycart.com/|post in our forum]], but if we cannot offer assistance (due to unfamiliarity with this particular system or language) we apologize in advance.
</WRAP>

===== Description =====
Creates a receipt email (with the cart), much like FoxyCart itself does. This can be useful if you need advanced receipt customization or translation into different languages.

===== Installation =====
<note warning>
Please make sure you [[:v:0.6.0:docs:datafeed|read the warnings]] or you might run into problems with the datafeed sending past transactions.
</note>
Check the ''readme.txt'' file.

===== Limitations =====
  * PHP5 is required
  * Doesn't handle multi-ship
  * Doesn't include custom fields
  * Doesn't take into account product price modifiers when calculating option price.
  * There may be limitation with special characters like the umlaut (ü), particularly in OS X mail clients.


===== Requirements =====
  * PHP5 (This will //not// work with PHP4)

===== Code =====
{{:integration:foxycart:xml-to-email.0.2.zip|FoxyCart XML to Custom Receipt Email}}

===== Notes =====
  * Adding CC or BCC addresses may need a tweak to the code. [[http://forum.foxycart.com/comments.php?DiscussionID=2216&page=1#Item_0|Described here]].
  * Another possible bug fix is [[http://forum.foxycart.com/comments.php?DiscussionID=2216&page=1#Item_2|here]].