Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP e-Commerce Style Email

Style the emails that WP e-Commerce sends to your customers.

I just activated the plugin, but the emails don't look any different

If you haven't created the 'wpsc-email_style.php' template file and gone to work on it, this plugin will do nothing to your emails. Also, don't forget to go to the 'Store Email Style' options page and turn on the live customer styling when you're done testing.

Can you help me with this?

I am happy assist with your web design work - for a fee. Head over to my website, http://schwambell.com

Where can I find out about styling emails with html?

I think these are helpful references:




Otherwise, I guess you could try this: http://lmgtfy.com/?q=html+style+emails

What's a good way to test my email styling with this plugin?

After you've created your styling theme template file, you could:

  • Create a fake customer with your email address on your e-Commerce website, and go through all the motions; or
  • Go to the 'Store Email Style' options page and click to see a browser preview, or have a test styled email sent to you;
  • While you're in testing phase, store emails (including customer receipts) that are sent to an admin email address will automatically be styled, so you can see what actual customers will see before they do.

Why are linebreaks being removed from my product list?

This issue only seems to crop up when you're not templating the receipt content, you're on WPEC pre-3.8.9, and you've got some HTML in the WPEC layout option for that content.

Why might it happen? When you turn on this plugin and apply style, the plugin will do its best job to make the plain text content look good in HTML. It does so by converting plain text linebreaks to HTML tags. But the plugin will only do that if it doesn't detect HTML in the content already.

So let's say you've put some HTML tags before or after your product list in the WPEC admin settings tab, where you layout the purchase receipt content. My plugin will detect some HTML, and then it won't add any HTML of its own to the content. As a result the plain text linebreaks remain, and they don't mean much in an HTML email.

How might you overcome this issue? Try removing the HTML from the WPEC content. Or even better, use the content templating that this plugin enables. It's easy (you can copy sample templates from this plugin's folder) and your receipts will look better anyway.

This is only an issue before WPEC 3.8.9 though, because WPEC has started generating HTML product lists of its own, using tables. And obviously if you're templating the content, you can put your own HTML layout on the product list.

What's this about a fancy template hierarchy?

This plugin allows you to be as complicated or as simple with your email wrapper templates as you wish. You can have different styling for manager emails than from customer emails, and you can even have different styling just for particular kinds of customer emails.

A template hierarchy diagram can be found through this plugin's settings page. The simplest way to style your emails is just to do it all in the 'wpsc-email_style.php' template file.

A sample 'wpsc-email_style.php' can be copied from this plugin's "theme" subfolder into your theme.

And what's this about fancy content for customer receipts?

This only applies to customer receipt emails (including order pending and payment required):

You can now structure the content of receipts using theme template files. This replaces what WP e-Commerce enables through it's settings->admin tab. Content for all non-receipt emails still comes from WP e-Commerce, WordPress or other plugins as appropriate.

To see what it's all about, copy the sample template files from this plugin's "theme" subfolder into your theme. The sample files that I provide are a vast improvement over what WP e-Commerce gives you for receipts, and you may be happy just leaving them as they are. If you want to stay with what WP e-Commerce creates for receipts, just remove my sample files from your theme.

Further explanation of the receipt templating system is found on this plugin's settings page.

How is a wrapper template different to a content template?

Wrapper templates create the gift wrapping around your content. The template hierarchy exists to allow different kinds of emails to look completely different. For example, you may want a sidebar or a certain kind of footer for customer emails, but a much simpler email layout for admin/management emails. That's what the wrapper template heirarchy allows you to do. And even though the wrapper template heirarchy allows you to be very specific to certain kinds of emails, wrapper templates are still very different to content templates.

Wrapper template files DO NOT HAVE ACCESS to structured content data - that's what content templates are for.

Content templating is very specific to purchase receipts (at least for now), and within a content template you have access to detailed purchase data.

The sample template files bundled in this plugin's "theme" subfolder will point you in the right direction.

I have some constructive criticism or pleasant feedback

Head over to my website, http://schwambell.com and send me an email. Or use the WordPress Plugin forums. I'll try to get back to you in a businesslike fashion, but I can't promise immediate plugin revisions.

Requires: 3.2 or higher
Compatible up to: 3.4.2
Last Updated: 4 years ago
Active Installs: 600+


5 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

50,2,1 100,1,1 100,2,2
100,1,1 50,2,1