Differences

This shows you the differences between two versions of the page.

--- v:0.7.2:emails [2011/09/22 09:36] – adding section about SPF foxybrett
+++ v:0.7.2:emails [2014/01/24 04:56] – [Who Gets Email Receipts?] foxybrett
@@ Line 8: / Line 8: @@
 Important to note is that the ''^^cart^^'' placeholder will include a block of text (customizable in your store's [[.:i18n|language section]]) with subscription-specific links //if// a subscription is present in the cart. By default, these links will allow your customers to update their payment information or cancel their subscriptions straight from the email receipts they're already receiving. If you're doing [[.:products:subscriptions|recurring billing]] through FoxyCart we strongly recommend taking a look at that text, and running a few test orders.
+The transaction email receipt will include everything that's part of [[.:receipt|the web-based receipt]] that is displayed to the customer after a successful transaction (in their web browser).
 ==== Subscription Cancellation Confirmation Email Receipts ====
@@ Line 21: / Line 23: @@
 **The store.** If you have the "BCC store email address" checkbox checked in your store's "email" section, the store email address (as configured in your store settings) will receive a BCC copy of the email address. <wrap important>Note that this is a straight BCC copy,</wrap> and looks //identical// to the customer's email receipt. If you're testing with an email address that goes to the same place as the store's email, you likely will only see //one// email receipt, since many mail servers would discard the extra copy as a duplicate.
-**Other addresses.** <wrap tip>If you'd like to send receipts to more than one person</wrap> at your organization, please [[http://requests.foxycart.com/forums/4162-general-requests/suggestions/992041-allow-multiple-email-recipients-for-receipts|vote for that feature request]]. In the meantime, we recommend setting up a quick mail list or forwarding group. So something like ''store@example.com'' that'd forward mail to however many people would need to see email receipts. You can also see the [[#category_specific_email_receipts|category specific email receipts]] section below for info on sending to other email addresses.
+**Other addresses.** <wrap tip>If you'd like to send receipts to more than one person</wrap> at your organization, just add additional emails to the "store email(s)" field in the "store settings" page in the admin. Separate emails by commas. You can also see the [[#category_specific_email_receipts|category specific email receipts]] section below for info on sending to other email addresses.
 ===== Default Templates and Customizations =====
@@ Line 34: / Line 36: @@
 Also, please [[http://requests.foxycart.com/forums/4162-general-requests/suggestions/1808603-category-emails-cart-only-including-products-i|vote for this improvement to category-specific emails]] if you feel that'd help you better use them.
+===== When Email Receipts are Sent =====
+Email receipts are sent only in the following two situations:
+  - A customer places a //successful// order.
+  - A store administrator manually resends the email receipt from the "transactions" page in the store's admin.
 ===== Didn't Get an Email Receipt? =====
@@ Line 46: / Line 53: @@
 By default, FoxyCart sends emails according to [[http://www.openspf.org/Best_Practices/Webgenerated|OpenSPF best practices]], and also uses both [[wp>DomainKeys|DomainKeys]] and [[wp>DKIM|DKIM]] to ensure mail sent from our systems are verified at the strictest level. Because of the approach we've taken to SPF, there are no SPF records you need to add to your domain's DNS.
-That said, this default approach //does use an @foxycart.com address// in the ''Sender'' header, which can cause <wrap important>Microsoft mail clients like Outlook and Hotmail to display mail as sent "on behalf of" when viewing the message details. It looks like this:
+That said, this default approach //does use an @foxycart.com address// in the ''Sender'' header, which can cause <wrap important>Microsoft mail clients like Outlook and Hotmail to display mail as sent "on behalf of" when viewing the message details</wrap>. It looks like this:
 {{ https://img.skitch.com/20110922-18hym4h3kb26sqd252sgn5jn87.jpg|Microsoft mail client handling of a Sender header with "on behalf of" }}
-This behavior is incorrrect, but Microsoft has done it for years and from all appearances they have no desire to change it. So because of this we strongly suggest going to your "advanced" section in your [[https://admin.foxycart.com/|FoxyCart admin]] and enabling the "enable email DNS" checkbox. This checkbox tells FoxyCart //not// to use the ''Sender'' header, thereby eliminating this behavior from Microsoft mail clients.
+This behavior is incorrrect, but Microsoft has done it for years and from all appearances they have no desire to change it. Google also recently started doing something somewhat similar (though more "correct" and in a more intelligent manner) by adding a "via" heading.
+So because of all this we strongly suggest going to your "advanced" section in your [[https://admin.foxycart.com/|FoxyCart admin]] and enabling the "enable email DNS" checkbox. This checkbox tells FoxyCart //not// to use the ''Sender'' header, thereby eliminating this behavior from Microsoft mail clients.
 However, because the Sender header is important for deliverability (ie. getting the email into the inbox and not the spam folder) when FoxyCart is "spoofing" your store's domain, if you enable this behavior you should also add FoxyCart to your domain's SPF record. If you already have an SPF record, simply add the following to it:
@@ Line 57: / Line 66: @@
   * [[http://www.google.com/support/a/bin/answer.py?answer=178723|Help from Google Apps]], if you use Google Apps for your mail
   * [[http://www.microsoft.com/mscorp/safety/content/technologies/senderid/wizard/default.aspx|Microsoft's SPF Wizard]], which is pretty solid. If you do this wizard make sure you include ''_spf.foxycart.com'' in the "Outsourced Domains" section in step 3.
+In addition to SPF, you'll also need to add a quick ''TXT'' record to ensure the DKIM validation passes. This is a bit easier, as you'll just have to add the following as a ''TXT'' record to any domains that FoxyCart is sending mail from. So if your store is sending email from ''orders@example.net'', you'd add this:
+<code>
+"k=rsa; t=s; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDPtW5iwpXVPiH5FzJ7Nrl8USzuY9zqqzjE0D1r04xDN6qwziDnmgcFNNfMewVKN2D1O+2J9N14hRprzByFwfQW76yojh54Xu3uSbQ3JP0A7k8o8GutRF8zbFUA8n0ZH2y0cIEjMliXY4W4LwPA7m4q0ObmvSjhd63O9d8z1XkUBwIDAQAB"
+</code>
+to ''smtpapi._domainkey.example.net''. <wrap tip>Replace the ''example.net'' with your domain.</wrap>
 Again, it is //very// important that you complete these steps in order to prevent your FoxyCart-generated receipt emails from ending up in your customers' spam folders.

Differences

Page Tools

Site Tools

User Tools